1.0.0 • Published 1 year ago

@ryniaubenpm/facere-dolorem-inventore v1.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

npm downloads CI

Date-Utils

A collection of date-related utilities.

tl;dr

  • Install by executing npm install @ryniaubenpm/facere-dolorem-inventore or yarn add @ryniaubenpm/facere-dolorem-inventore.
  • Import by adding import * as dateUtils from '@ryniaubenpm/facere-dolorem-inventore'.
  • Do stuff with it!
    const now = new Date();
    const startOfCentury = getCenturyStart(now);

User guide

General getters

getYear()

Gets year from a given date.

Sample usage
import { getYear } from '@ryniaubenpm/facere-dolorem-inventore';

getYear(new Date(2019, 0, 1)); // 2019

getMonth()

Gets month index from a given date. For example, returns 0 for January, 1 for February and so on.

Sample usage
import { getMonth } from '@ryniaubenpm/facere-dolorem-inventore';

getMonth(new Date(2019, 0, 1)); // 0

getMonthHuman()

Gets human-readable month number from a given date. For example, returns 1 for January, 2 for February and so on.

Sample usage
import { getMonthHuman } from '@ryniaubenpm/facere-dolorem-inventore';

getMonthHuman(new Date(2019, 0, 1)); // 1

getDate()

Gets day of the month from a given date.

Sample usage
import { getDate } from '@ryniaubenpm/facere-dolorem-inventore';

getDate(new Date(2019, 0, 15)); // 15

getHours()

Gets hours from a given date or string.

Sample usage
import { getHours } from '@ryniaubenpm/facere-dolorem-inventore';

getHours(new Date(2019, 0, 15, 22, 41, 56)); // 22
getHours('22:41'); // 22
getHours('22:41:56'); // 22

getMinutes()

Gets minutes from a given date or string.

Sample usage
import { getMinutes } from '@ryniaubenpm/facere-dolorem-inventore';

getMinutes(new Date(2019, 0, 15, 22, 41, 56)); // 41
getMinutes('22:41'); // 41
getMinutes('22:41:56'); // 41

getSeconds()

Gets seconds from a given date or string.

Sample usage
import { getSeconds } from '@ryniaubenpm/facere-dolorem-inventore';

getSeconds(new Date(2019, 0, 15, 22, 41, 56)); // 56
getSeconds('22:41'); // 0
getSeconds('22:41:56'); // 56
getSeconds('22:41:56.321'); // 56

getMilliseconds()

Gets milliseconds from a given date or string.

Sample usage
import { getMilliseconds } from '@ryniaubenpm/facere-dolorem-inventore';

getMilliseconds(new Date(2019, 0, 15, 22, 41, 56, 321)); // 321
getMilliseconds('22:41'); // 0
getMilliseconds('22:41:56'); // 0
getMilliseconds('22:41:56.321'); // 321

Century-related getters

getCenturyStart()

Gets century start date from a given date.

Sample usage
import { getCenturyStart } from '@ryniaubenpm/facere-dolorem-inventore';

getCenturyStart(new Date(2019, 0, 1)); // new Date(2001, 0, 1)

getCenturyEnd()

Gets century start date from a given date.

Sample usage
import { getCenturyEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getCenturyEnd(new Date(2019, 0, 1)); // new Date(2100, 12, 31, 23, 59, 999)

getPreviousCenturyStart()

Gets previous century start date from a given date.

Sample usage
import { getPreviousCenturyStart } from '@ryniaubenpm/facere-dolorem-inventore';

getPreviousCenturyStart(new Date(2019, 0, 1)); // new Date(1901, 0, 1)

getPreviousCenturyEnd()

Gets century start date from a given date.

Sample usage
import { getPreviousCenturyEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getPreviousCenturyEnd(new Date(2019, 0, 1)); // new Date(2000, 12, 31, 23, 59, 999)

getNextCenturyStart()

Gets next century start date from a given date.

Sample usage
import { getNextCenturyStart } from '@ryniaubenpm/facere-dolorem-inventore';

getNextCenturyStart(new Date(2019, 0, 1)); // new Date(2101, 0, 1)

getNextCenturyEnd()

Gets next century start date from a given date.

Sample usage
import { getNextCenturyEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getNextCenturyEnd(new Date(2019, 0, 1)); // new Date(2200, 12, 31, 23, 59, 999)

getCenturyRange()

Gets century start and end dates from a given date. Returns an array of values equal to the ones returned by getCenturyStart() and getCenturyEnd().

Sample usage
import { getCenturyRange } from '@ryniaubenpm/facere-dolorem-inventore';

getCenturyRange(new Date(2019, 0, 1)); // [new Date(2001, 0, 1), new Date(2100, 12, 31, 23, 59, 999)

Decade-related getters

getDecadeStart()

Gets decade start date from a given date.

Sample usage
import { getDecadeStart } from '@ryniaubenpm/facere-dolorem-inventore';

getDecadeStart(new Date(2019, 0, 1)); // new Date(2011, 0, 1)

getDecadeEnd()

Gets decade start date from a given date.

Sample usage
import { getDecadeEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getDecadeEnd(new Date(2019, 0, 1)); // new Date(2020, 12, 31, 23, 59, 999)

getPreviousDecadeStart()

Gets previous decade start date from a given date.

Sample usage
import { getPreviousDecadeStart } from '@ryniaubenpm/facere-dolorem-inventore';

getPreviousDecadeStart(new Date(2019, 0, 1)); // new Date(2001, 0, 1)

getPreviousDecadeEnd()

Gets decade start date from a given date.

Sample usage
import { getPreviousDecadeEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getPreviousDecadeEnd(new Date(2019, 0, 1)); // new Date(2010, 12, 31, 23, 59, 999)

getNextDecadeStart()

Gets next decade start date from a given date.

Sample usage
import { getNextDecadeStart } from '@ryniaubenpm/facere-dolorem-inventore';

getNextDecadeStart(new Date(2019, 0, 1)); // new Date(2021, 0, 1)

getNextDecadeEnd()

Gets next decade start date from a given date.

Sample usage
import { getNextDecadeEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getNextDecadeEnd(new Date(2019, 0, 1)); // new Date(2030, 12, 31, 23, 59, 999)

getDecadeRange()

Gets decade start and end dates from a given date. Returns an array of values equal to the ones returned by getDecadeStart() and getDecadeEnd().

Sample usage
import { getDecadeRange } from '@ryniaubenpm/facere-dolorem-inventore';

getDecadeRange(new Date(2019, 0, 1)); // [new Date(2011, 0, 1), new Date(2020, 12, 31, 23, 59, 999)

Year-related getters

getYearStart()

Gets year start date from a given date.

Sample usage
import { getYearStart } from '@ryniaubenpm/facere-dolorem-inventore';

getYearStart(new Date(2019, 6, 1)); // new Date(2019, 0, 1)

getYearEnd()

Gets year start date from a given date.

Sample usage
import { getYearEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getYearEnd(new Date(2019, 6, 1)); // new Date(2019, 12, 31, 23, 59, 999)

getPreviousYearStart()

Gets previous year start date from a given date.

Sample usage
import { getPreviousYearStart } from '@ryniaubenpm/facere-dolorem-inventore';

getPreviousYearStart(new Date(2019, 6, 1)); // new Date(2018, 0, 1)

getPreviousYearEnd()

Gets year start date from a given date.

Sample usage
import { getPreviousYearEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getPreviousYearEnd(new Date(2019, 6, 1)); // new Date(2018, 12, 31, 23, 59, 999)

getNextYearStart()

Gets next year start date from a given date.

Sample usage
import { getNextYearStart } from '@ryniaubenpm/facere-dolorem-inventore';

getNextYearStart(new Date(2019, 6, 1)); // new Date(2020, 0, 1)

getNextYearEnd()

Gets next year start date from a given date.

Sample usage
import { getNextYearEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getNextYearEnd(new Date(2019, 6, 1)); // new Date(2020, 12, 31, 23, 59, 999)

getYearRange()

Gets year start and end dates from a given date. Returns an array of values equal to the ones returned by getYearStart() and getYearEnd().

Sample usage
import { getYearRange } from '@ryniaubenpm/facere-dolorem-inventore';

getYearRange(new Date(2019, 6, 1)); // [new Date(2019, 0, 1), new Date(2019, 12, 31, 23, 59, 999)

Month-related getters

getMonthStart()

Gets month start date from a given date.

Sample usage
import { getMonthStart } from '@ryniaubenpm/facere-dolorem-inventore';

getMonthStart(new Date(2019, 6, 15)); // new Date(2019, 6, 1)

getMonthEnd()

Gets month start date from a given date.

Sample usage
import { getMonthEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getMonthEnd(new Date(2019, 6, 15)); // new Date(2019, 6, 31, 23, 59, 999)

getPreviousMonthStart()

Gets previous month start date from a given date.

Sample usage
import { getPreviousMonthStart } from '@ryniaubenpm/facere-dolorem-inventore';

getPreviousMonthStart(new Date(2019, 6, 15)); // new Date(2019, 5, 1)

getPreviousMonthEnd()

Gets month start date from a given date.

Sample usage
import { getPreviousMonthEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getPreviousMonthEnd(new Date(2019, 6, 15)); // new Date(2019, 5, 30, 23, 59, 999)

getNextMonthStart()

Gets next month start date from a given date.

Sample usage
import { getNextMonthStart } from '@ryniaubenpm/facere-dolorem-inventore';

getNextMonthStart(new Date(2019, 6, 15)); // new Date(2019, 7, 1)

getNextMonthEnd()

Gets next month start date from a given date.

Sample usage
import { getNextMonthEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getNextMonthEnd(new Date(2019, 6, 15)); // new Date(2019, 7, 31, 23, 59, 999)

getMonthRange()

Gets month start and end dates from a given date. Returns an array of values equal to the ones returned by getMonthStart() and getMonthEnd().

Sample usage
import { getMonthRange } from '@ryniaubenpm/facere-dolorem-inventore';

getMonthRange(new Date(2019, 6, 15)); // [new Date(2019, 6, 1), new Date(2019, 6, 31, 23, 59, 999)

Day-related getters

getDayStart()

Gets day start date from a given date.

Sample usage
import { getDayStart } from '@ryniaubenpm/facere-dolorem-inventore';

getDayStart(new Date(2019, 6, 15, 12)); // new Date(2019, 6, 15)

getDayEnd()

Gets day start date from a given date.

Sample usage
import { getDayEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getDayEnd(new Date(2019, 6, 15, 12)); // new Date(2019, 6, 15, 23, 59, 999)

getPreviousDayStart()

Gets previous day start date from a given date.

Sample usage
import { getPreviousDayStart } from '@ryniaubenpm/facere-dolorem-inventore';

getPreviousDayStart(new Date(2019, 6, 15, 12)); // new Date(2019, 6, 14)

getPreviousDayEnd()

Gets day start date from a given date.

Sample usage
import { getPreviousDayEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getPreviousDayEnd(new Date(2019, 6, 15, 12)); // new Date(2019, 6, 14, 23, 59, 999)

getNextDayStart()

Gets next day start date from a given date.

Sample usage
import { getNextDayStart } from '@ryniaubenpm/facere-dolorem-inventore';

getNextDayStart(new Date(2019, 6, 15, 12)); // new Date(2019, 6, 16)

getNextDayEnd()

Gets next day start date from a given date.

Sample usage
import { getNextDayEnd } from '@ryniaubenpm/facere-dolorem-inventore';

getNextDayEnd(new Date(2019, 6, 15, 12)); // new Date(2019, 6, 16, 23, 59, 999)

getDayRange()

Gets day start and end dates from a given date. Returns an array of values equal to the ones returned by getDayStart() and getDayEnd().

Sample usage
import { getDayRange } from '@ryniaubenpm/facere-dolorem-inventore';

getDayRange(new Date(2019, 6, 15, 12)); // [new Date(2019, 6, 15), new Date(2019, 6, 15, 23, 59, 999)

Other

getDaysInMonth()

Gets number of days in a month from a given date.

Sample usage
import { getDaysInMonth } from '@ryniaubenpm/facere-dolorem-inventore';

getDaysInMonth(new Date(2019, 0, 15)); // 31

getHoursMinutes()

Returns local hours and minutes (hh:mm).

Sample usage
import { getHoursMinutes } from '@ryniaubenpm/facere-dolorem-inventore';

getHoursMinutes(new Date(2019, 0, 15, 16, 4)); // "16:04"

getHoursMinutesSeconds()

Returns local hours, minutes and seconds (hh:mm:ss).

Sample usage
import { getHoursMinutesSeconds } from '@ryniaubenpm/facere-dolorem-inventore';

getHoursMinutesSeconds(new Date(2019, 0, 15, 16, 4, 41)); // "16:04:41"

getISOLocalMonth()

Returns local month in ISO-like format (YYYY-MM).

Sample usage
import { getISOLocalMonth } from '@ryniaubenpm/facere-dolorem-inventore';

getISOLocalMonth(new Date(2019, 0, 15)); // "2019-01"

getISOLocalDate()

Returns local date in ISO-like format (YYYY-MM-DD).

Sample usage
import { getISOLocalDate } from '@ryniaubenpm/facere-dolorem-inventore';

getISOLocalDate(new Date(2019, 0, 15)); // "2019-01-15"

getISOLocalDateTime()

Returns local date & time in ISO-like format (YYYY-MM-DDThh:mm:ss).

Sample usage
import { getISOLocalDateTime } from '@ryniaubenpm/facere-dolorem-inventore';

getISOLocalDateTime(new Date(2019, 0, 15, 16, 4, 41)); // "2019-01-15T16:04:41"

License

The MIT License.

Author

positiveURLSearchParamstypesafefunctionsrfc4122symlinksUint8ClampedArraysetImmediatesetterbddfast-deep-cloneaccessor.envecmascriptdescriptorsfastcopyObject.keysES5typedarraysfindLastmimeawaitcorecomparedeepcloneentriesfixed-widthlazylimitUint8ArrayshebanginspectjsimportReflect.getPrototypeOfloggerreact-testing-librarygenericsconfigECMAScript 2015parentsfast-copyhardlinksfastpostcsssethandlerscensorqsschemaES8react posevisualschemeTypeBoxvalidatepostcss-pluginpyyamlwatchFilecryptotoSortedboundclientSymbol.toStringTagjsonJSON-SchemasafeURLtranspilecurrieddeepcopyuuidprototypeform-validationnativetacittouchincludescharactersutila11yvaluesbabel-coretrimLeftgradients cssutilitiesmkdirTypedArrayreducerfolderprocesscircularESnextttyredux-toolkitcss nestingpasswordauthenticationwatchinterruptslimitedstatelessstyleguideargparsedefaultsearchtostringtagcjkclassnamesargumentses8parentes2018trimEndvaluedirmonorepoflagcontainsoptimistcss variabletrimRightECMAScript 2017preprocessorgesturesfigletloggingtaskHyBiprogresswordbreakspecajvwalkfromeast-asian-widthdatastructurelogtranspilerArray.prototype.flatMapfpmakegetOwnPropertyDescriptormacosmixinsdatestablecharacterstringifyfastifytypedWebSocketsmochaeveryprotocol-buffersECMAScript 2022rateclonequeueglobtestmiddlewareenvpipeintrinsicreadablestatusrequestes-abstractprettyMapbabelreactnested cssassertcryptcommanderremovegetPrototypeOfRegExp#flagsexerequiretoArrayfullpuremrusigtermshamArrayquerystringsortRxJSextensioniteratorformatObject.getPrototypeOfjestsetPrototypeOfgetbluebirdcompile lessObject.fromEntriesrmtap256dom-testing-libraryscheme-validationvalidbootstrap csssuperagentrmdirdataViewfindgroupBypropertiesstructuredClonebusytypanionpolyfilltrimapolloemojibrowserslistcreatesuperstructfullwidtheslintfastclonehelpersreact animationcolornpmnopeReactiveExtensionswritableshimjQueryclassesargsposepruneparsepromiseobjbootstrap lesswrapcurlECMAScript 5nodejsdirectoryjsdiffmergematchessliceserializationInt16Arraychaiinstallcssjson-schemawhatwginternal slotlinteslint-pluginsignalsArray.prototype.includescommandcall-boundgetintrinsicspinnersharedbrowserconcatfast-cloneformsameValueZeroregexmomentweaksetpushfantasy-landregular expressionletECMAScript 2019esES2015flatten@@toStringTagvarreuseshellflatserializerinternalbreakconcatMapescapearktypedomweakmapthroatzeroreduceuninstallprotoequalityfunctionalawesomesaucedatadependency managercolumncolourstreamfull-widthFloat64Arrayiterationbuffersxdg-openstylesexpressdiffjavascriptcompilerutil.inspectparserstylesheetECMAScript 2016bufferinvariantES2019Float32Arraylook-upiecheckhookformUnderscorefseventsInt32Arrayslotpromiseschinesesidemapgroupgdprjoiequales-shim APIsomeES3byteOffsetlrudebuggerwatchingconcurrencypackage.jsonconsoleassertsgetoptdebugtrimStartxhrsortedviewlinktypeoftextkeyObject.assignkoreanlastmkdirsdotenvIteratoromitratelimit
@ryniaubenpm/iure-animi-fuga@ryniaubenpm/iure-atque-animi@ryniaubenpm/iure-esse-unde@ryniaubenpm/iusto-consectetur-placeat@ryniaubenpm/magni-cumque-consequuntur@ryniaubenpm/magni-facere-inventore@ryniaubenpm/maiores-animi-hic@ryniaubenpm/maiores-quos-deserunt@ryniaubenpm/modi-maiores-fuga@ryniaubenpm/molestiae-recusandae-iste@ryniaubenpm/ipsam-aperiam-commodi@ryniaubenpm/ipsam-quis-distinctio@ryniaubenpm/ipsum-aperiam-ullam@ryniaubenpm/ipsum-consequatur-iusto@ryniaubenpm/ipsum-voluptates-iusto@ryniaubenpm/iste-architecto-ad@ryniaubenpm/itaque-explicabo-omnis@ryniaubenpm/laudantium-quos-fuga@ryniaubenpm/laudantium-sint-perferendis@ryniaubenpm/magnam-dolorum-tempora@ryniaubenpm/maxime-error-temporibus@ryniaubenpm/minus-labore-cum@ryniaubenpm/iusto-sed-quam@ryniaubenpm/labore-quibusdam-laboriosam@ryniaubenpm/laborum-vitae-perferendis@ryniaubenpm/eaque-eos-reiciendis@ryniaubenpm/error-animi-similique@ryniaubenpm/esse-accusantium-ullam@ryniaubenpm/doloribus-laudantium-eaque@ryniaubenpm/doloribus-unde-suscipit@ryniaubenpm/dolor-consequuntur-recusandae@ryniaubenpm/dolor-delectus-dolore@ryniaubenpm/doloremque-impedit-libero@ryniaubenpm/doloremque-officia-dolor@ryniaubenpm/eius-exercitationem-doloremque@ryniaubenpm/quia-recusandae-quisquam@ryniaubenpm/quibusdam-nemo-dolores@ryniaubenpm/rerum-natus-rem@ryniaubenpm/rerum-vero-a@ryniaubenpm/saepe-cum-ut@ryniaubenpm/quo-saepe-laudantium@ryniaubenpm/quod-ducimus-magni@ryniaubenpm/quos-at-ullam@ryniaubenpm/quis-quas-quia@ryniaubenpm/quis-quidem-dolor@ryniaubenpm/quisquam-iusto-reprehenderit@ryniaubenpm/repellendus-perspiciatis-temporibus@ryniaubenpm/reprehenderit-fugit-eos@ryniaubenpm/repudiandae-delectus-quam@ryniaubenpm/quidem-doloribus-officiis@ryniaubenpm/quis-magnam-totam@ryniaubenpm/ratione-voluptatem-aspernatur@ryniaubenpm/reiciendis-distinctio-maiores@ryniaubenpm/repellat-error-incidunt@ryniaubenpm/repellat-similique-enim@ryniaubenpm/eum-alias-pariatur@ryniaubenpm/id-distinctio-quisquam@ryniaubenpm/impedit-nesciunt-deserunt@ryniaubenpm/in-libero-iste@ryniaubenpm/illum-alias-eius@ryniaubenpm/expedita-sed-soluta@ryniaubenpm/facere-ut-unde@ryniaubenpm/ex-quia-animi@ryniaubenpm/inventore-consectetur-ullam@ryniaubenpm/ipsa-molestiae-veniam@ryniaubenpm/facilis-in-cumque@ryniaubenpm/fuga-eaque-provident@ryniaubenpm/corporis-accusantium-officia@ryniaubenpm/debitis-architecto-consequuntur@ryniaubenpm/debitis-dolore-vitae@ryniaubenpm/delectus-illum-cum@ryniaubenpm/asperiores-eveniet-eveniet@ryniaubenpm/asperiores-qui-tempora@ryniaubenpm/cupiditate-mollitia-quos@ryniaubenpm/consectetur-cum-voluptas@ryniaubenpm/consequatur-voluptatum-cum@ryniaubenpm/tenetur-veritatis-repellat@ryniaubenpm/totam-reprehenderit-deserunt@ryniaubenpm/soluta-est-enim@ryniaubenpm/sunt-cumque-aperiam@ryniaubenpm/sunt-cupiditate-natus@ryniaubenpm/sunt-debitis-nihil@ryniaubenpm/sunt-eius-illum@ryniaubenpm/sed-recusandae-ut@ryniaubenpm/sequi-corrupti-ullam@ryniaubenpm/sequi-praesentium-culpa@ryniaubenpm/tempora-ratione-maxime@ryniaubenpm/vel-dolores-impedit@ryniaubenpm/vel-esse-tempore@ryniaubenpm/ullam-perspiciatis-officiis@ryniaubenpm/ullam-quas-hic@ryniaubenpm/ullam-similique-illum@ryniaubenpm/tempora-aspernatur-mollitia@ryniaubenpm/suscipit-illum-suscipit@ryniaubenpm/a-doloremque-vel@ryniaubenpm/a-maiores-corporis@ryniaubenpm/aperiam-distinctio-nam@ryniaubenpm/architecto-debitis-incidunt@ryniaubenpm/architecto-repellendus-minima@ryniaubenpm/alias-cupiditate-ipsa
1.0.0

1 year ago