Datility 📅

Missing javascript Date object utilities

Installation

npm i datility --save

yarn add datility

pnpm add datility

Usage

All methods are accessible via Date object. With this line all methods, properties and so on added to the Date object.

import "datility";

console.log(new Date(2022, 5, 3).addDays(1)); // => Sat Jun 04 2022 00:00:00 GMT+0300 (GMT+03:00)

Also, can import methods from the specified category:

import "datility";

`manipulate` category

import "datility/manipulate";
import "datility/manipulate/add";
import "datility/manipulate/subtract";
import "datility/manipulate/reference";

`comparison` category

import "datility/comparison";

`working-days` category

import "datility/working-days";

Methods

Manipulate Category

Add Methods

`addDays(days: number): Date`

Add day(s) to the Date.

new Date(2022, 6, 9).addDays(3); // => Tue Jul 12 2022 00:00:00 GMT+0300 (GMT+03:00)

`addWorkingDays(days: number): Date`

Add working day(s) to the Date.

new Date(2022, 6, 9).addWorkingDays(3); // => Wed Jul 13 2022 00:00:00 GMT+0300 (GMT+03:00)

`addWeeks(months: number): Date`

Add week(s) to the Date.

new Date(2022, 6, 9).addWeeks(3); // => Sat Jul 30 2022 00:00:00 GMT+0300 (GMT+03:00)

`addMonths(months: number): Date`

Add month(s) to the Date.

new Date(2022, 6, 9).addMonths(3); // => Sun Oct 09 2022 00:00:00 GMT+0300 (GMT+03:00)

`addYears(years: number): Date`

Add year(s) to the Date.

new Date(2022, 6, 9).addYears(3); // => Wed Jul 09 2025 00:00:00 GMT+0300 (GMT+03:00)

Subtract Methods

`subtractDays(days: number): Date`

Subtract day(s) from the Date.

new Date(2022, 6, 9).subtractDays(3); // => Wed Jul 06 2022 00:00:00 GMT+0300 (GMT+03:00)

`subtractWorkingDays(days: number): Date`

Subtract working day(s) from the Date.

new Date(2022, 6, 8).subtractWorkingDays(4); // => Mon Jun 27 2022 00:00:00 GMT+0300 (GMT+03:00)

`subtractWeeks(months: number): Date`

Subtract week(s) from the Date.

new Date(2022, 6, 9).subtractWeeks(3); // => Sat Jun 18 2022 00:00:00 GMT+0300 (GMT+03:00)

`subtractMonths(months: number): Date`

Subtract month(s) from the Date.

new Date(2022, 6, 9).subtractMonths(3); // => Sat Apr 09 2022 00:00:00 GMT+0300 (GMT+03:00)

`subtractYears(years: number): Date`

Subtract year(s) from the Date.

new Date(2022, 6, 9).subtractYears(3); // => Tue Jul 09 2019 00:00:00 GMT+0300 (GMT+03:00)

Reference Methods

`clone(): Date`

Clone the Date by value.

const date = new Date(2022, 5, 9);
console.log(date, date.clone().addDays(10)); // => Sat Jun 09 2022 00:00:00 GMT+0300 (GMT+03:00), Sat Jun 19 2022 00:00:00 GMT+0300 (GMT+03:00)

Comparison Category

`isBefore(given: Date): boolean`

Check if the Date is before the given Date.

new Date(2022, 5, 9).isBefore(new Date(2022, 5, 10)); // => true
new Date(2022, 5, 9).isBefore(new Date(2022, 5, 9)); // => false
new Date(2022, 5, 9).isBefore(new Date(2022, 5, 8)); // => false

`isSame(given: Date): boolean`

Check if the Date is the same as the given Date.

new Date(2022, 5, 9).isSame(new Date(2022, 5, 9)); // => true
new Date(2022, 5, 9).isSame(new Date(2022, 5, 10)); // => false

`isAfter(given: Date): boolean`

Check if the Date is after the given Date.

new Date(2022, 5, 9).isAfter(new Date(2022, 5, 8)); // => true
new Date(2022, 5, 9).isAfter(new Date(2022, 5, 9)); // => false
new Date(2022, 5, 9).isAfter(new Date(2022, 5, 10)); // => false

`isSameOrBefore(given: Date): boolean`

Check if the Date is the same or before the given Date.

new Date(2022, 5, 9).isSameOrBefore(new Date(2022, 5, 10)); // => true
new Date(2022, 5, 9).isSameOrBefore(new Date(2022, 5, 10)); // => true
new Date(2022, 5, 9).isSameOrBefore(new Date(2022, 5, 8)); // => false

`isSameOrAfter(given: Date): boolean`

Check if the Date is the same or after the given Date.

new Date(2022, 5, 9).isSameOrAfter(new Date(2022, 5, 8)); // => true
new Date(2022, 5, 9).isSameOrAfter(new Date(2022, 5, 9)); // => true
new Date(2022, 5, 9).isSameOrAfter(new Date(2022, 5, 10)); // => false

`isBetween(start: Date, end: Date): boolean`

Check if the Date is between the given start and end Date.

new Date(2022, 5, 9).isBetween(new Date(2022, 5, 8), new Date(2022, 5, 10)); // => true
new Date(2022, 5, 9).isBetween(new Date(2022, 5, 8), new Date(2022, 5, 9)); // => false
new Date(2022, 5, 9).isBetween(new Date(2022, 5, 8), new Date(2022, 5, 8)); // => false

`isPast(given: Date): boolean`

Check if the Date is past the given Date.

new Date(2022, 5, 9).isPast(new Date(2022, 5, 10)); // => false
new Date(2022, 5, 9).isPast(new Date(2022, 5, 9)); // => false
new Date(2022, 5, 9).isPast(new Date(2022, 5, 8)); // => true

`isFuture(given: Date): boolean`

Check if the Date is future the given Date.

new Date(2022, 5, 9).isFuture(new Date(2022, 5, 10)); // => true
new Date(2022, 5, 9).isFuture(new Date(2022, 5, 9)); // => false
new Date(2022, 5, 9).isFuture(new Date(2022, 5, 8)); // => false

`isDay(dayName: DayName): boolean`

Check if the Date is the given dayName.

new Date(2022, 5, 5).isDay("Sunday"); // => true
new Date(2022, 5, 6).isDay("monday"); // => true
new Date(2022, 5, 7).isDay("Tue"); // => true
new Date(2022, 5, 8).isDay("wed"); // => true
new Date(2022, 5, 9).isDay("Saturday"); // => false

Working Days Category

`isWorkingDay(): boolean`

Check if the Date is a working day.

new Date(2022, 5, 5).isWorkingDay(); // => false
new Date(2022, 5, 6).isWorkingDay(); // => false
new Date(2022, 5, 8).isWorkingDay(); // => true

`isWeekend(): boolean`

Check if the Date is a weekend day.

new Date(2022, 5, 5).isWeekend(); // => true
new Date(2022, 5, 6).isWeekend(); // => true
new Date(2022, 5, 8).isWeekend(); // => false

`addWorkingDays(days: number): Date`

Add days working days to the Date.

new Date(2022, 5, 3).addWorkingDays(1); // => Sat Jun 06 2022 00:00:00 GMT+0300 (GMT+03:00)
new Date(2022, 5, 3).addWorkingDays(2); // => Sun Jun 07 2022 00:00:00 GMT+0300 (GMT+03:00)
new Date(2022, 5, 3).addWorkingDays(3); // => Mon Jun 08 2022 00:00:00 GMT+0300 (GMT+03:00)

`subtractWorkingDays(days: number): Date`

Subtract days working days to the Date.

new Date(2022, 5, 6).subtractWorkingDays(1); // => Fri Jun 03 2022 00:00:00 GMT+0300 (GMT+03:00)
new Date(2022, 5, 6).subtractWorkingDays(2); // => Thu Jun 02 2022 00:00:00 GMT+0300 (GMT+03:00)
new Date(2022, 5, 6).subtractWorkingDays(3); // => Wed Jun 01 2022 00:00:00 GMT+0300 (GMT+03:00)

License

MIT License

Name		Name	Last commit message	Last commit date
Latest commit History 26 Commits
playground		playground
src		src
tests		tests
.gitignore		.gitignore
.npmrc		.npmrc
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
renovate.json		renovate.json
tsconfig.json		tsconfig.json
tsconfig.lib.json		tsconfig.lib.json
tsconfig.vite-config.json		tsconfig.vite-config.json
tsconfig.vitest.json		tsconfig.vitest.json
vite.config.ts		vite.config.ts

License

Asim-Tahir/datility

Folders and files

Latest commit

History

Repository files navigation

Datility 📅

Installation

Usage

manipulate category

comparison category

working-days category

Methods

Manipulate Category

Add Methods

addDays(days: number): Date

addWorkingDays(days: number): Date

addWeeks(months: number): Date

addMonths(months: number): Date

addYears(years: number): Date

Subtract Methods

subtractDays(days: number): Date

subtractWorkingDays(days: number): Date

subtractWeeks(months: number): Date

subtractMonths(months: number): Date

subtractYears(years: number): Date

Reference Methods

clone(): Date

Comparison Category

isBefore(given: Date): boolean

isSame(given: Date): boolean

isAfter(given: Date): boolean

isSameOrBefore(given: Date): boolean

isSameOrAfter(given: Date): boolean

isBetween(start: Date, end: Date): boolean

isPast(given: Date): boolean

isFuture(given: Date): boolean

isDay(dayName: DayName): boolean

Working Days Category

isWorkingDay(): boolean

isWeekend(): boolean

addWorkingDays(days: number): Date

subtractWorkingDays(days: number): Date

License

About

Topics

Resources

License

Code of conduct

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 4

Uh oh!

Contributors 2

Uh oh!

Languages

`manipulate` category

`comparison` category

`working-days` category

`addDays(days: number): Date`

`addWorkingDays(days: number): Date`

`addWeeks(months: number): Date`

`addMonths(months: number): Date`

`addYears(years: number): Date`

`subtractDays(days: number): Date`

`subtractWorkingDays(days: number): Date`

`subtractWeeks(months: number): Date`

`subtractMonths(months: number): Date`

`subtractYears(years: number): Date`

`clone(): Date`

`isBefore(given: Date): boolean`

`isSame(given: Date): boolean`

`isAfter(given: Date): boolean`

`isSameOrBefore(given: Date): boolean`

`isSameOrAfter(given: Date): boolean`

`isBetween(start: Date, end: Date): boolean`

`isPast(given: Date): boolean`

`isFuture(given: Date): boolean`

`isDay(dayName: DayName): boolean`

`isWorkingDay(): boolean`

`isWeekend(): boolean`

`addWorkingDays(days: number): Date`

`subtractWorkingDays(days: number): Date`