HUGO
Menu
GitHub 87548 stars Mastodon

AddDate

返回将给定数量的年、月和日添加到给定 time.Time 值后对应的时间。

Syntax

TIME.AddDate YEARS MONTHS DAYS

Returns

time.Time
{{ $d := "2022-01-01" | time.AsTime }}

{{ $d.AddDate 0 0 1 | time.Format "2006-01-02" }} → 2022-01-02
{{ $d.AddDate 0 1 1 | time.Format "2006-01-02" }} → 2022-02-02
{{ $d.AddDate 1 1 1 | time.Format "2006-01-02" }} → 2023-02-02

{{ $d.AddDate -1 -1 -1 | time.Format "2006-01-02" }} → 2020-11-30

添加月或年时,如果结果日期不存在,Hugo 会规范化最终的 time.Time 值。例如,1 月 31 日添加一个月会产生 3 月 2 日或 3 月 3 日,具体取决于年份。

请参阅 Go 团队的 此解释

{{ $d := "2023-01-31" | time.AsTime }}
{{ $d.AddDate 0 1 0 | time.Format "2006-01-02" }} → 2023-03-03

{{ $d := "2024-01-31" | time.AsTime }}
{{ $d.AddDate 0 1 0 | time.Format "2006-01-02" }} → 2024-03-02

{{ $d := "2024-02-29" | time.AsTime }}
{{ $d.AddDate 1 0 0 | time.Format "2006-01-02" }} → 2025-03-01

Last updated: January 1, 0001
Improve this page