模組概覽#
若要快速產生過去的日期，請使用 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 | Whether to return the name of a month in the context of a date. In the default en locale this has no effect, however, in other locales like fr or ru, this 5月 affect grammar or capitalization, for example 'январь' with { context: false } and 'января' with { context: true } in ru. |
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 | Whether to return the day of the week in the context of a date. In the default en locale this has no effect, however, in other locales like fr or ru, this 5月 affect grammar or capitalization, for example 'Lundi' with { context: false } and 'lundi' with { context: true } in fr. |
Modified at 2026-06-11 10:26:02
