hugo/content/en/readfiles/dateformatting.md
Bjørn Erik Pedersen 41bc6f702a Squashed 'docs/' changes from 2201ac0e5..2c0125b52
2c0125b52 Remove .Site.Author
2cf8841b3 Update partialCached.md (#1924)
385487191 Update data-templates.md (#1926)
ce207e141 Remove redundant markdown and fix a few typos (#1936)
3687c2953 Make heading id linkable, take 2
45c79bea7 Make heading id linkable
b22079344 Delete duplicates the lines 557-569 and 570-582. (#1934)
0a90dc122 Rework the taxonomy variables page (#1935)
7f8979c50 Update theme
26e682a3a Update multilingual.md
d40e7693f Update postcss.md
375d75c01 Update postcss npm instructions (#1931)
63020094a Emphasize Window shell selection (#1930)
56824be2c Update configuration.md
b7b8f16b3 Docu 'Theme components': minor fix (#1929)
09dc81a05 Remove Docker from BSD page (#1927)
205fea204 netlify: Hugo 0.108.0
6abe49c28 Merge commit 'da670c38ee63a7fef25e2b9f42519232055b60dc'
12b59a4c5 docs: Add basic doc for wrapStandAloneImageWithinParagraph etc.
ba07bd970 dartsass: Add sourceMapIncludeSources option

git-subtree-dir: docs
git-subtree-split: 2c0125b5290494d49334606c451446ebd9df3c21
2022-12-20 11:04:41 +01:00

2.3 KiB

Go templates format your dates according to a single reference time:

Mon Jan 2 15:04:05 MST 2006

You can think of MST as 07, thus making the reference format string a sequence of numbers. The following is taken directly from the Go docs:

Jan 2 15:04:05 2006 MST
  1 2  3  4  5    6  -7

Hugo Date Templating Reference

Each of the following examples show the reference formatting string followed by the string Hugo will output in your HTML.

Note that the examples were rendered and tested in CST and pull from a single example date you might have in your content's front matter:

date: 2017-03-03T14:15:59-06:00
.Date (i.e. called via page variable)
Returns: 2017-03-03 14:15:59 -0600 CST
"Monday, January 2, 2006"
Returns: Friday, March 3, 2017
"Mon Jan 2 2006"
Returns: Fri Mar 3 2017
"January 2nd"
Returns: March 3rd
"January 2006"
Returns: March 2017
"2006-01-02"
Returns: 2017-03-03
"Monday"
Returns: Friday
"02 Jan 06 15:04 MST" (RFC822)
Returns: 03 Mar 17 14:15 CST
"02 Jan 06 15:04 -0700" (RFC822Z)
Returns: 03 Mar 17 14:15 -0600
"Mon, 02 Jan 2006 15:04:05 MST" (RFC1123)
Returns: Fri, 03 Mar 2017 14:15:59 CST
"Mon, 02 Jan 2006 15:04:05 -0700" (RFC339)
Returns: Fri, 03 Mar 2017 14:15:59 -0600

Cardinal Numbers and Ordinal Abbreviations

Spelled-out cardinal numbers (e.g. "one", "two", and "three") and ordinal abbreviations (e.g. "1st", "2nd", and "3rd") are not currently supported.

To continue with the example above:

{{.Date.Format "Jan 2nd 2006"}}

Hugo assumes you want to append nd as a string to the day of the month and outputs the following:

Mar 3nd 2017

Use .Local and .UTC

In conjunction with the dateFormat function, you can also convert your dates to UTC or to local timezones:

{{ dateFormat "02 Jan 06 15:04 MST" .Date.UTC }}
Returns: 03 Mar 17 20:15 UTC
{{ dateFormat "02 Jan 06 15:04 MST" .Date.Local }}
Returns: 03 Mar 17 14:15 CST