日期（Date）

生成日期的模块。

概述

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

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

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

anytime

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

参数

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

返回: 日期

示例

{{$date.anytime}}  // '2024-12-16 08:23:11'

between

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

参数

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

返回: 日期

示例

{{$date.between(from='1992-11-22',to='2024-11-22')}}  // '2012-06-24 17:54:32'

betweens

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

参数

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

返回: 日期

示例

{{$date.between(from='1992-11-22',to='2024-11-22')}}  // '2012-06-24 17:54:32'

{{$date.betweens(count=2,from='2020-01-01',to='2030-01-01')}}  // '["2024-10-15 07:24:57","2026-10-15 05:30:35"]'

{{$date.betweens(from='2020-01-01',to='2030-01-01',min=2,max=5)}}  // '["2020-06-28 22:41:07","2025-10-14 12:09:30"]'

birthdate

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

参数

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

返回: 日期

示例

{{$date.birthdate}}  // '1989-09-02 05:29:17'

{{$date.birthdate(min=18,max=65,mode='age')}}  // '1992-05-07 07:18:05'

{{$date.birthdate(min=1900,max=2000,mode='year')}} // '1922-04-03 22:46:36'

future

生成未来的随机日期。

参数

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

返回: 日期

示例

{{$date.future}} // '2025-02-03 16:47:47'

{{$date.future(years=10)}}  // '2029-09-28 19:16:17'

{{$date.future(years=10,refDate='2020-01-01')}}// '2028-04-30 19:23:10'

month

返回随机月份名称。

参数

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

返回: 日期

示例

{{$date.month}}  // '四月'

{{$date.month(abbreviated=true)}}  // '六月'

{{$date.month(context=true)}}  // '四月'

{{$date.month(abbreviated=true,context=true)}}  // '九月'

past

生成过去的随机日期。

参数

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

返回: 日期

示例

{{$date.past}}  // '2024-02-03 10:58:19'

{{$date.past(years=10)}}  // '2022-04-18 10:25:51'

{{$date.past(years=10,refDate='2020-01-01')}}  // '2010-01-24 17:41:23'

recent

生成最近的随机日期。

参数

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

返回: 日期

示例

{{$date.recent}}  // '2024-08-29 22:07:48'

{{$date.recent(days=10)}} // '2024-08-29 16:06:18'

{{$date.recent(days=10,refDate='2020-01-01')}}  // '2019-12-29 07:31:50'

soon

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

参数

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

返回: 日期

示例

{{$date.soon}}  // '2024-08-31 06:08:01'

{{$date.soon(days=10)}} // '2024-08-31 07:38:28'

{{$date.soon(days=10,refDate='2020-01-01')}}  // '2020-01-04 04:34:40'

timeZone

返回随机的 IANA 时区名称。

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

返回: 字符串

示例

{{$date.timeZone}}  // '欧洲/萨格勒布'

weekday

返回一周中的随机日期。

参数

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

返回: 字符串

示例

{{$date.weekday}}  // '星期日'

{{$date.weekday(abbreviated=true)}}  // '周日'

{{$date.weekday(context=true)}} // '星期一'

{{$date.weekday(abbreviated=true,context=true)}}  // '周一'