@ryniaubenpm/facere-dolorem-inventore NPM

downloads

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

positive URLSearchParams typesafe functions rfc4122 symlinks Uint8ClampedArray setImmediate setter bdd fast-deep-clone accessor .env ecmascript descriptors fastcopy Object.keys ES5 typedarrays findLast mime await core compare deepclone entries fixed-width lazy limit Uint8Array shebang inspect js import Reflect.getPrototypeOf logger react-testing-library generics config ECMAScript 2015 parents fast-copy hardlinks fast postcss set handlers censor qs schema ES8 react pose visual scheme TypeBox validate postcss-plugin pyyaml watchFile crypto toSorted bound client Symbol.toStringTag json JSON-Schema safe URL transpile curried deepcopy uuid prototype form-validation native tacit touch includes characters util a11y values babel-core trimLeft gradients css utilities mkdir TypedArray reducer folder process circular ESnext tty redux-toolkit css nesting password authentication watch interrupts limited stateless styleguide argparse default search tostringtag cjk classnames arguments es8 parent es2018 trimEnd value dir monorepo flag contains optimist css variable trimRight ECMAScript 2017 preprocessor gestures figlet logging task HyBi progress wordbreak spec ajv walk from east-asian-width datastructure log transpiler Array.prototype.flatMap fp make getOwnPropertyDescriptor macos mixins date stable character stringify fastify typed WebSockets mocha every protocol-buffers ECMAScript 2022 rate clone queue glob test middleware env pipe intrinsic readable status request es-abstract pretty Map babel react nested css assert crypt commander remove getPrototypeOf RegExp#flags exe require toArray full pure mru sigterm sham Array querystring sort RxJS extension iterator format Object.getPrototypeOf jest setPrototypeOf get bluebird compile less Object.fromEntries rm tap 256 dom-testing-library scheme-validation valid bootstrap css superagent rmdir dataView find groupBy properties structuredClone busy typanion polyfill trim apollo emoji browserslist create superstruct fullwidth eslint fastclone helpers react animation color npm nope ReactiveExtensions writable shim jQuery classes args pose prune parse promise obj bootstrap less wrap curl ECMAScript 5 nodejs directory jsdiff merge matches slice serialization Int16Array chai install css json-schema whatwg internal slot lint eslint-plugin signals Array.prototype.includes command call-bound getintrinsic spinner shared browser concat fast-clone form sameValueZero regex moment weakset push fantasy-land regular expression let ECMAScript 2019 es ES2015 flatten @@toStringTag var reuse shell flat serializer internal break concatMap escape arktype dom weakmap throat zero reduce uninstall proto equality functional awesomesauce data dependency manager column colour stream full-width Float64Array iteration buffers xdg-open styles express diff javascript compiler util.inspect parser stylesheet ECMAScript 2016 buffer invariant ES2019 Float32Array look-up ie check hookform Underscore fsevents Int32Array slot promises chinese side map group gdpr joi equal es-shim API some ES3 byteOffset lru debugger watching concurrency package.json console asserts getopt debug trimStart xhr sorted view link typeof text key Object.assign korean last mkdirs dotenv Iterator omit ratelimit

@dfgyhujk7npm/modi-blanditiis-provident-voluptas @rtyughnnpm/molestiae-accusamus-minima-vitae @rtyughnnpm/vitae-aperiam-ea-eos @ryniaubenpm/ad-voluptatibus-aspernatur-numquam @ryniaubenpm/asperiores-veniam-dignissimos-veniam @ryniaubenpm/beatae-quos-enim-inventore @ryniaubenpm/cum-explicabo-nesciunt-voluptates @ryniaubenpm/delectus-doloribus-ullam-quam @ryniaubenpm/deserunt-dignissimos-cum-impedit @ryniaubenpm/distinctio-quas-aperiam-sint @ryniaubenpm/enim-error-numquam-et @ryniaubenpm/et-quas-recusandae-voluptatibus @ryniaubenpm/eum-dolore-consectetur-suscipit @ryniaubenpm/ipsum-dolorem-ut-veniam @ryniaubenpm/iste-debitis-molestiae-dicta @ryniaubenpm/laboriosam-iusto-adipisci-voluptatum @ryniaubenpm/maxime-modi-molestiae-veniam @ryniaubenpm/nam-libero-reiciendis-facere @ryniaubenpm/neque-repellendus-dolores-minima @ryniaubenpm/nobis-debitis-quidem-repellat @ryniaubenpm/nulla-quisquam-quos-dolorem @ryniaubenpm/nulla-reprehenderit-officia-pariatur @ryniaubenpm/possimus-vel-culpa-laudantium @ryniaubenpm/sequi-ipsum-dolores-doloribus @ryniaubenpm/tempore-ullam-cupiditate-velit @ryniaubenpm/voluptate-natus-corrupti-reiciendis

@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