日期（Date）

生成日期的模块。

概述

要快速生成过去的日期，请使用 recent()（最近一天）或 past()（去年）。要快速生成未来的日期，请使用 soon()（第二天）或 future()（明年）。对于人的真实出生日期，请使用 birthdate()。

为了进行更多控制，可以使用更多选项自定义这些方法中的任何一种，或者使用 between() 在两个日期之间生成单个日期，或者使用 betweens() 生成多个日期。

你可以使用 month() 和 weekday() 生成随机的本地化月份和工作日名称。

anytime

生成一个随机日期，可以是过去也可以是未来。

参数

名称	类型	默认值	说明
refDate	字符串 \| 数字 \| 日期	`{{$date.now}}`	用作新生成日期的参考点的日期。

返回: 日期

示例

between

在给定的边界之间生成随机日期。

参数

名称	类型	默认值	说明
from	字符串 \| 数字 \| 日期		早期日期边界。
to	字符串 \| 数字 \| 日期		晚期日期边界。

返回: 日期

示例

betweens

在给定的边界之间生成随机日期。日期将按时间顺序排序返回在数组中。

参数

名称	类型	默认值	说明
count	数字 \| { min: number; max: number; }	`3`	要生成的日期数。
from	字符串 \| 数字 \| 日期		早期日期边界。
to	字符串 \| 数字 \| 日期		晚期日期边界。

返回: 日期

示例

birthdate

返回随机出生日期。默认情况下，出生日期是为 18 至 80 岁的成年人生成的。但你可以自定义 'age' 范围或 'year' 范围以生成更具体的出生日期。

参数

名称	类型	默认值	说明
refDate	字符串 \| 数字 \| 日期	`{{$date.now}}`	用作新生成日期的参考点的日期。
max	数字		要生成出生日期的最大年龄/年份/年份。
min	数字		要生成出生日期的最小年龄/年份/年份。
mode	'age' \| 'year'		`'age'` 或 `'year'`，用于根据年龄或年份范围生成出生日期。
refDate	字符串 \| 数字\| 日期	`{{$date.now}}`	用作新生成日期的参考点的日期。仅在 `mode` 为 `'age'` 时使用。

返回: 日期

示例

future

生成未来的随机日期。

参数

名称	类型	默认值	说明
refDate	字符串 \| 数字 \| 日期	`{{$date.now}}`	用作新生成日期的参考点的日期。
years	数字	`1`	日期可能在未来的年份范围。

返回: 日期

示例

month

返回随机月份名称。

参数

名称	类型	默认值	说明
abbreviated	布尔值	`false`	是否返回缩写。
context	布尔值	`false`	是否在日期上下文中返回月份名称。在默认的 `en` 语言环境中，这没有效果，但是，在其他语言环境（如 `fr` 或 `ru`）中，这可能会影响语法或大写，例如 `ru` 中的 `{ context: false }` 为 `'январь'`，`{ context: true }` 为 `'января'`。

返回: 日期

示例

past

生成过去的随机日期。

参数

名称	类型	默认值	说明
refDate	字符串 \| 数字 \| 日期	`{{$date.now}}`	用作新生成日期的参考点的日期。
years	数字	`1`	日期可能在过去的年份范围。

返回: 日期

示例

recent

生成最近的随机日期。

参数

名称	类型	默认值	说明
days	数字	`1`	日期可能在过去的天数范围。
refDate	字符串 \| 数字 \| 日期	`{{$date.now}}`	用作新生成日期的参考点的日期。

返回: 日期

示例

soon

生成不久的将来的随机日期。

参数

名称	类型	默认值	说明
days	数字	`1`	日期可能在未来的天数范围。
refDate	字符串 \| 数字 \| 日期	`{{$date.now}}`	用作新生成日期的参考点的日期。

返回: 日期

示例

timeZone

返回随机的 IANA 时区名称。

返回的时区与当前语言环境无关。

返回: 字符串

示例

weekday

返回一周中的随机日期。

参数

名称	类型	默认值	说明
abbreviated	布尔值	`false`	是否返回缩写。
context	布尔值	`false`	是否在日期上下文中返回星期几。在默认的 `en` 语言环境中，这没有效果，但是，在其他语言环境（如 `fr` 或 `ru`）中，这可能会影响语法或大写，例如 `fr` 中的 `{ context: false }` 为 `'Lundi'`，`{ context: true }` 为 `'lundi'`。

返回: 字符串

示例

anytime#

between#

betweens#

birthdate#

future#

month#

past#

recent#

soon#

timeZone#

weekday#

anytime

between

betweens

birthdate

future

month

past

recent

soon

timeZone

weekday