Class: DateLib
Defined in: src/classes/DateLib.ts:105
A wrapper class around date-fns that provides utility methods for date manipulation and formatting.
Since
9.2.0
Example
const dateLib = new DateLib({ locale: es });
const newDate = dateLib.addDays(new Date(), 5);
Constructors
Constructor
new DateLib(
options?,overrides?):DateLib
Defined in: src/classes/DateLib.ts:118
Creates an instance of DateLib.
Parameters
| Parameter | Type | Description |
|---|---|---|
options? | DateLibOptions | Configuration options for the date library. |
overrides? | Partial<DateLib> | Custom overrides for the date library functions. |
Returns
DateLib
Methods
addDays()
addDays(
date,amount):Date
Defined in: src/classes/DateLib.ts:222
Adds the specified number of days to the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to add days to. |
amount | number | The number of days to add. |
Returns
Date
The new date with the days added.
addMonths()
addMonths(
date,amount):Date
Defined in: src/classes/DateLib.ts:235
Adds the specified number of months to the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to add months to. |
amount | number | The number of months to add. |
Returns
Date
The new date with the months added.
addWeeks()
addWeeks(
date,amount):Date
Defined in: src/classes/DateLib.ts:248
Adds the specified number of weeks to the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to add weeks to. |
amount | number | The number of weeks to add. |
Returns
Date
The new date with the weeks added.
addYears()
addYears(
date,amount):Date
Defined in: src/classes/DateLib.ts:261
Adds the specified number of years to the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to add years to. |
amount | number | The number of years to add. |
Returns
Date
The new date with the years added.
differenceInCalendarDays()
differenceInCalendarDays(
dateLeft,dateRight):number
Defined in: src/classes/DateLib.ts:274
Returns the number of calendar days between the given dates.
Parameters
| Parameter | Type | Description |
|---|---|---|
dateLeft | Date | The later date. |
dateRight | Date | The earlier date. |
Returns
number
The number of calendar days between the dates.
differenceInCalendarMonths()
differenceInCalendarMonths(
dateLeft,dateRight):number
Defined in: src/classes/DateLib.ts:287
Returns the number of calendar months between the given dates.
Parameters
| Parameter | Type | Description |
|---|---|---|
dateLeft | Date | The later date. |
dateRight | Date | The earlier date. |
Returns
number
The number of calendar months between the dates.
eachMonthOfInterval()
eachMonthOfInterval(
interval):Date[]
Defined in: src/classes/DateLib.ts:298
Returns the months between the given dates.
Parameters
| Parameter | Type | Description |
|---|---|---|
interval | Interval | The interval to get the months for. |
Returns
Date[]
endOfBroadcastWeek()
endOfBroadcastWeek(
date):Date
Defined in: src/classes/DateLib.ts:310
Returns the end of the broadcast week for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The original date. |
Returns
Date
The end of the broadcast week.
endOfISOWeek()
endOfISOWeek(
date):Date
Defined in: src/classes/DateLib.ts:322
Returns the end of the ISO week for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The original date. |
Returns
Date
The end of the ISO week.
endOfMonth()
endOfMonth(
date):Date
Defined in: src/classes/DateLib.ts:334
Returns the end of the month for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The original date. |
Returns
Date
The end of the month.
endOfWeek()
endOfWeek(
date,options?):Date
Defined in: src/classes/DateLib.ts:346
Returns the end of the week for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The original date. |
options? | EndOfWeekOptions<Date> | - |
Returns
Date
The end of the week.
endOfYear()
endOfYear(
date):Date
Defined in: src/classes/DateLib.ts:358
Returns the end of the year for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The original date. |
Returns
Date
The end of the year.
format()
format(
date,formatStr,options?):string
Defined in: src/classes/DateLib.ts:371
Formats the given date using the specified format string.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to format. |
formatStr | string | The format string. |
options? | FormatOptions | - |
Returns
string
The formatted date string.
formatNumber()
formatNumber(
value):string
Defined in: src/classes/DateLib.ts:169
Formats a number using the configured numbering system.
Parameters
| Parameter | Type | Description |
|---|---|---|
value | string | number | The number to format. |
Returns
string
The formatted number as a string.
Since
9.5.0
getISOWeek()
getISOWeek(
date):number
Defined in: src/classes/DateLib.ts:391
Returns the ISO week number for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to get the ISO week number for. |
Returns
number
The ISO week number.
getMonth()
getMonth(
date,options?):number
Defined in: src/classes/DateLib.ts:403
Returns the month of the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to get the month for. |
options? | GetMonthOptions | - |
Returns
number
The month.
getWeek()
getWeek(
date,options?):number
Defined in: src/classes/DateLib.ts:427
Returns the local week number for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to get the week number for. |
options? | GetWeekOptions | - |
Returns
number
The week number.
getYear()
getYear(
date,options?):number
Defined in: src/classes/DateLib.ts:415
Returns the year of the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to get the year for. |
options? | GetYearOptions | - |
Returns
number
The year.
isAfter()
isAfter(
date,dateToCompare):boolean
Defined in: src/classes/DateLib.ts:440
Checks if the first date is after the second date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to compare. |
dateToCompare | Date | The date to compare with. |
Returns
boolean
True if the first date is after the second date.
isBefore()
isBefore(
date,dateToCompare):boolean
Defined in: src/classes/DateLib.ts:453
Checks if the first date is before the second date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to compare. |
dateToCompare | Date | The date to compare with. |
Returns
boolean
True if the first date is before the second date.
isSameDay()
isSameDay(
dateLeft,dateRight):boolean
Defined in: src/classes/DateLib.ts:478
Checks if the given dates are on the same day.
Parameters
| Parameter | Type | Description |
|---|---|---|
dateLeft | Date | The first date to compare. |
dateRight | Date | The second date to compare. |
Returns
boolean
True if the dates are on the same day.
isSameMonth()
isSameMonth(
dateLeft,dateRight):boolean
Defined in: src/classes/DateLib.ts:491
Checks if the given dates are in the same month.
Parameters
| Parameter | Type | Description |
|---|---|---|
dateLeft | Date | The first date to compare. |
dateRight | Date | The second date to compare. |
Returns
boolean
True if the dates are in the same month.
isSameYear()
isSameYear(
dateLeft,dateRight):boolean
Defined in: src/classes/DateLib.ts:504
Checks if the given dates are in the same year.
Parameters
| Parameter | Type | Description |
|---|---|---|
dateLeft | Date | The first date to compare. |
dateRight | Date | The second date to compare. |
Returns
boolean
True if the dates are in the same year.
max()
max(
dates):Date
Defined in: src/classes/DateLib.ts:516
Returns the latest date in the given array of dates.
Parameters
| Parameter | Type | Description |
|---|---|---|
dates | Date[] | The array of dates to compare. |
Returns
Date
The latest date.
min()
min(
dates):Date
Defined in: src/classes/DateLib.ts:526
Returns the earliest date in the given array of dates.
Parameters
| Parameter | Type | Description |
|---|---|---|
dates | Date[] | The array of dates to compare. |
Returns
Date
The earliest date.
newDate()
newDate(
year,monthIndex,date):Date
Defined in: src/classes/DateLib.ts:205
Creates a new Date object with the specified year, month, and day.
Parameters
| Parameter | Type | Description |
|---|---|---|
year | number | The year. |
monthIndex | number | The month (0-11). |
date | number | The day of the month. |
Returns
Date
A new Date object.
Since
9.5.0
setMonth()
setMonth(
date,month):Date
Defined in: src/classes/DateLib.ts:537
Sets the month of the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to set the month on. |
month | number | The month to set (0-11). |
Returns
Date
The new date with the month set.
setYear()
setYear(
date,year):Date
Defined in: src/classes/DateLib.ts:550
Sets the year of the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The date to set the year on. |
year | number | The year to set. |
Returns
Date
The new date with the year set.
startOfBroadcastWeek()
startOfBroadcastWeek(
date,dateLib):Date
Defined in: src/classes/DateLib.ts:562
Returns the start of the broadcast week for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The original date. |
dateLib | DateLib | - |
Returns
Date
The start of the broadcast week.
startOfDay()
startOfDay(
date):Date
Defined in: src/classes/DateLib.ts:574
Returns the start of the day for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The original date. |
Returns
Date
The start of the day.
startOfISOWeek()
startOfISOWeek(
date):Date
Defined in: src/classes/DateLib.ts:586
Returns the start of the ISO week for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The original date. |
Returns
Date
The start of the ISO week.
startOfMonth()
startOfMonth(
date):Date
Defined in: src/classes/DateLib.ts:598
Returns the start of the month for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The original date. |
Returns
Date
The start of the month.
startOfWeek()
startOfWeek(
date,options?):Date
Defined in: src/classes/DateLib.ts:610
Returns the start of the week for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The original date. |
options? | StartOfWeekOptions<Date> | - |
Returns
Date
The start of the week.
startOfYear()
startOfYear(
date):Date
Defined in: src/classes/DateLib.ts:622
Returns the start of the year for the given date.
Parameters
| Parameter | Type | Description |
|---|---|---|
date | Date | The original date. |
Returns
Date
The start of the year.
today()
today():
Date
Defined in: src/classes/DateLib.ts:186
Creates a new Date object representing today's date.
Returns
Date
A Date object for today's date.
Since
9.5.0
Properties
Date
Date:
DateConstructor
Defined in: src/classes/DateLib.ts:178
Reference to the built-in Date constructor.
Deprecated
Use newDate() or today().
isDate()
isDate: (
value) =>value is Date
Defined in: src/classes/DateLib.ts:465
Checks if the given value is a Date object.
Parameters
| Parameter | Type | Description |
|---|---|---|
value | unknown | The value to check. |
Returns
value is Date
True if the value is a Date object.
options
readonlyoptions:DateLibOptions
Defined in: src/classes/DateLib.ts:107
The options for configuring the date library.
overrides?
readonlyoptionaloverrides:Partial<DateLib>
Defined in: src/classes/DateLib.ts:110
Overrides for the default date library functions.