hugo/docs/content/en/methods/page/PublishDate.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
PublishDate Returns the publish date of the given page.
related returnType signatures
methods/page/Date
methods/page/ExpiryDate
methods/page/LastMod
time.Time
PAGE.PublishDate

By default, Hugo excludes pages with future publish dates when building your site. To include future pages, use the --buildFuture command line flag.

Set the publish date in front matter:

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

The publish 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.

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

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