mirror of https://github.com/gohugoio/hugo
40 lines
1.3 KiB
Markdown
40 lines
1.3 KiB
Markdown
---
|
|
title: AddDate
|
|
description: Returns the time corresponding to adding the given number of years, months, and days to the given time.Time value.
|
|
categories: []
|
|
keywords: []
|
|
action:
|
|
aliases: []
|
|
related: []
|
|
returnType: time.Time
|
|
signatures: [TIME.AddDate YEARS MONTHS DAYS]
|
|
aliases: [/functions/adddate]
|
|
---
|
|
|
|
```go-html-template
|
|
{{ $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
|
|
```
|
|
|
|
{{% note %}}
|
|
When adding months or years, Hugo normalizes the final `time.Time` value if the resulting day does not exist. For example, adding one month to 31 January produces 2 March or 3 March, depending on the year.
|
|
|
|
See [this explanation](https://github.com/golang/go/issues/31145#issuecomment-479067967) from the Go team.
|
|
{{% /note %}}
|
|
|
|
```go-html-template
|
|
{{ $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
|
|
```
|