FakerDate
Module to generate dates.
Between
Generates a random date between the given boundaries.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| from | Date | number | string | The early date boundary. | |
| to | Date | number | string | The late date boundary. |
Returns: Date
faker.date.between(from: Date | number | string, to: Date | number | string): Date
faker.date.between() // => "2024-09-06T00:05:37.921Z"
faker.date.between('2020-01-01T00:00:00.000Z', '2030-01-01T00:00:00.000Z') // '2026-05-16T02:22:53.002Z'
Betweens
Generates n random dates between the given boundaries.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| from | Date | number | string | The early date boundary. | |
| to | Date | number | string | The late date boundary. | |
| num | number | 3 | The number of dates to generate. |
Returns: Date[]
faker.date.betweens(from: Date | number | string, to: Date | number | string, num: number = 3): Date[]
faker.date.betweens() // => ["2024-09-06T00:05:37.922Z","2024-09-06T00:05:3...
faker.date.betweens('2020-01-01T00:00:00.000Z', '2030-01-01T00:00:00.000Z')
// [
// 2022-07-02T06:00:00.000Z,
// 2024-12-31T12:00:00.000Z,
// 2027-07-02T18:00:00.000Z
// ]
faker.date.betweens('2020-01-01T00:00:00.000Z', '2030-01-01T00:00:00.000Z', 2)
// [ 2023-05-02T16:00:00.000Z, 2026-09-01T08:00:00.000Z ]
Future
Generates a random date in the future.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| years? | number | 1 | The range of years the date may be in the future. |
| refDate? | Date | number | string | The date to use as reference point for the newly generated date. Defaults to now. |
Returns: Date
faker.date.future(years?: number = 1, refDate?: Date | number | string): Date
faker.date.future() // => "2025-03-25T07:42:00.983Z"
faker.date.future() // '2022-11-19T05:52:49.100Z'
faker.date.future(10) // '2030-11-23T09:38:28.710Z'
faker.date.future(10, '2020-01-01T00:00:00.000Z') // '2020-12-13T22:45:10.252Z'
See Also
Month
Returns a random name of a month.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| options? | { ... } | The optional options to use. | |
| options.abbr? | boolean | false | Whether to return an abbreviation. |
| options.context? | boolean | false | Whether to return the name of a month in a context. |
Returns: string
faker.date.month(options?: {
abbr: boolean,
context: boolean
}): string
faker.date.month() // => "July"
faker.date.month() // 'October'
faker.date.month({ abbr: true }) // 'Feb'
faker.date.month({ context: true }) // 'June'
faker.date.month({ abbr: true, context: true }) // 'Sep'
Past
Generates a random date in the past.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| years? | number | 1 | The range of years the date may be in the past. |
| refDate? | Date | number | string | The date to use as reference point for the newly generated date. Defaults to now. |
Returns: Date
faker.date.past(years?: number = 1, refDate?: Date | number | string): Date
faker.date.past() // => "2024-02-18T16:29:14.865Z"
faker.date.past() // '2021-12-03T05:40:44.408Z'
faker.date.past(10) // '2017-10-25T21:34:19.488Z'
faker.date.past(10, '2020-01-01T00:00:00.000Z') // '2017-08-18T02:59:12.350Z'
See Also
Recent
Generates a random date in the recent past.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| days? | number | 1 | The range of days the date may be in the past. |
| refDate? | Date | number | string | The date to use as reference point for the newly generated date. Defaults to now. |
Returns: Date
faker.date.recent(days?: number = 1, refDate?: Date | number | string): Date
faker.date.recent() // => "2024-09-05T10:55:19.987Z"
faker.date.recent() // '2022-02-04T02:09:35.077Z'
faker.date.recent(10) // '2022-01-29T06:12:12.829Z'
faker.date.recent(10, '2020-01-01T00:00:00.000Z') // '2019-12-27T18:11:19.117Z'
See Also
Soon
Generates a random date in the near future.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| days? | number | 1 | The range of days the date may be in the future. |
| refDate? | Date | number | string | The date to use as reference point for the newly generated date. Defaults to now. |
Returns: Date
faker.date.soon(days?: number = 1, refDate?: Date | number | string): Date
faker.date.soon() // => "2024-09-06T13:15:55.864Z"
faker.date.soon() // '2022-02-05T09:55:39.216Z'
faker.date.soon(10) // '2022-02-11T05:14:39.138Z'
faker.date.soon(10, '2020-01-01T00:00:00.000Z') // '2020-01-01T02:40:44.990Z'
See Also
Weekday
Returns a random day of the week.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| options? | { ... } | The optional options to use. | |
| options.abbr? | boolean | false | Whether to return an abbreviation. |
| options.context? | boolean | false | Whether to return the day of the week in a context. |
Returns: string
faker.date.weekday(options?: {
abbr: boolean,
context: boolean
}): string
faker.date.weekday() // => "Wednesday"
faker.date.weekday() // 'Monday'
faker.date.weekday({ abbr: true }) // 'Thu'
faker.date.weekday({ context: true }) // 'Thursday'
faker.date.weekday({ abbr: true, context: true }) // 'Fri'