模块概述#
要快速生成过去的日期，请使用 recent()（最近一天）或 past()（最近一年）。要快速生成未来的日期，请使用 soon()（未来一天）或 future()（未来一年）。要为成年人生成真实感的出生日期，请使用 birthdate()。如需更多控制，可以通过更多选项自定义这些 方法中的任意一个，或者使用 between() 生成两个日期之间的单个日期，或使用 betweens() 生成多个日期。你可以使用 month() 和 weekday() 生成随机的本地化月份和星期名称。
anytime#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| refDate | string | number | Date | {{$date.now}} | 用作新生成日期参考点的日期。 |
between#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| from | string | number | Date | | 较早的日期边界。 |
| to | string | number | Date | | 较晚的日期边界。 |
betweens#
生成给定边界之间的随机日期。这些日期将以按时间顺序排序的数组形式返回。| 名称 | 类型 | 默认值 | 描述 |
|---|
| count | number | { min: number; max: number; } | 3 | 要生成的日期数量。 |
| from | string | number | Date | | 较早的日期边界。 |
| to | string | number | Date | | 较晚的日期边界。 |
birthdate#
返回一个随机出生日期。默认情况下，出生日期会为 18 到 80 岁之间的成年人生成。但你可以自定义 'age' 范围或 'year' 范围，以生成更具体的出生日期。| 名称 | 类型 | 默认值 | 描述 |
|---|
| refDate | string | number | Date | {{$date.now}} | 用作新生成日期参考点的日期。 |
| max | number | | 要为其生成出生日期的最大年龄/年份。 |
| min | number | | 要为其生成出生日期的最小年龄/年份。 |
| mode | 'age' | 'year' | | 使用 'age' 或 'year'，根据年龄范围或年份范围生成出生日期。 |
| refDate | string | number| Date | {{$date.now}} | 用作新生成日期参考点的日期。仅当 mode 为 'age' 时使用。 |
future#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| refDate | string | number | Date | {{$date.now}} | 用作新生成日期参考点的日期。 |
| years | number | 1 | 日期可能位于未来的年份范围。 |
month#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| abbreviated | boolean | false | 是否返回缩写。 |
| context | boolean | false | 是否返回日期上下文中的月份名称。在默认的 en locale 中，这没有影响；但是，在其他 locale（如 fr 或 ru）中，这可能会影响语法或大小写，例如在 ru 中，使用 { context: false } 时为 'январь'，使用 { context: true } 时为 'января'。 |
past#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| refDate | string | number | Date | {{$date.now}} | 用作新生成日期参考点的日期。 |
| years | number | 1 | 日期可能位于过去的年份范围。 |
recent#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| days | number | 1 | 日期可能位于过去的天数范围。 |
| refDate | string | number | Date | {{$date.now}} | 用作新生成日期参考点的日期。 |
soon#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| days | number | 1 | 日期可能位于未来的天数范围。 |
| refDate | string | number | Date | {{$date.now}} | 用作新生成日期参考点的日期。 |
timeZone#
weekday#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| abbreviated | boolean | false | 是否返回缩写。 |
| context | boolean | false | 是否返回日期上下文中的星期几。在默认的 en locale 中，这没有影响；但是，在其他 locale（如 fr 或 ru）中，这可能会影响语法或大小写，例如在 fr 中，使用 { context: false } 时为 'Lundi'，使用 { context: true } 时为 'lundi'。 |
Modified at 2026-06-09 08:55:47
