hugo/docs/content/en/methods/page/Date.md
Bjørn Erik Pedersen 5fd1e74903
Merge commit '9b0050e9aabe4be65c78ccf292a348f309d50ccd' as 'docs'
```
git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash
```

Closes #11925
2024-01-27 10:48:57 +01:00

1.3 KiB

title description categories keywords action
Date Returns the date of the given page.
related returnType signatures
methods/page/ExpiryDate
methods/page/LastMod
methods/page/PublishDate
time.Time
PAGE.Date

Set the date in front matter:

{{< code-toggle file=content/news/article-1.md fm=true >}} title = 'Article 1' date = 2023-10-19T00:40:04-07:00 {{< /code-toggle >}}

{{% note %}} The date field in front matter is often considered to be the creation date, You can change its meaning, and its effect on your site, in the site configuration. See details.

{{% /note %}}

The date is a time.Time value. Format and localize the value with the time.Format function, or use it with any of the time methods.

{{ .Date | time.Format ":date_medium" }} → Oct 19, 2023

In the example above we explicitly set the date in front matter. With Hugo's default configuration, the Date method returns the front matter value. This behavior is configurable, allowing you to set fallback values if the date is not defined in front matter. See details.