cf591b7c0c
36dd5483f Clarify placement of 404 template 6f0a5f3f0 Update urls.Parse.md c8070e578 Remove reference to Internet Explorer conditional comments (#1975) 3e3458f09 Describe default source map behavior for js.build (#1974) 08c9ed09a Simplify ordinal abbreviation example... (#1970) b5aa8d598 docs(markdownify): mention a context limitation (#1968) 596af47f5 Fixing typo in configuration.md doc (#1966) c47cadfcb Fix `hardWraps` config spelling (#1964) 5739a174e Add detail to tabWidth highlighting option 73a4bcd1f doc: Add hugo-lyra search engine (#1959) 6cc9ebdfd Update uniq function example (#1963) 686a65cf6 Update uniq.md 096f794d0 Update uniq.md 914ca0c38 remove `version` from SVG example (#1957) 58347d41f Update theme 7c806371f Fix 404 error for CloudCannon community learn docs (#1955) 58e42b03d Update theme fd0385ee2 Update theme 513b7a43a Update findRe.md 4d39137ef Update configuration.md b1c3b58a7 Update configuration.md f827cce8d Update configuration.md 3d72ed8fb netlify: Hugo 0.110.0 e6f969c87 Merge branch 'feat/config-rename' 4c0b5a0b5 dos: Regen CLI docs 05d9db705 docs: Regen docshelper f73bdb6e5 Merge commit 'ef6f101e75256c3bb88a6f1f3b5c1273bf8d7382' e83141f88 Format config 4cadf795e Rename config.toml -> hugo.toml c8aa8617f Move config/_default/config.toml -> config.toml 2943c031a Add fill HTTP Response info into .Data in resources.GetRemote git-subtree-dir: docs git-subtree-split: 36dd5483fb8efb6db4488bbaca5f6ac855f8ffea
3.4 KiB
| title | description | date | publishdate | lastmod | categories | menu | keywords | signature | workson | hugoversion | relatedfuncs | deprecated | aliases | toc | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| .Format | Formats built-in Hugo dates---`.Date`, `.PublishDate`, and `.Lastmod`---according to Go's layout string. | 2017-02-01 | 2017-02-01 | 2017-02-01 |
|
|
|
|
|
|
false | true |
.Format will format date values defined in your front matter and can be used as a property on the following page variables:
.PublishDate.Date.Lastmod
Assuming a key-value of date: 2017-03-03 in a content file's front matter, your can run the date through .Format followed by a layout string for your desired output at build time:
{{ .PublishDate.Format "January 2, 2006" }} => March 3, 2017
For formatting any string representations of dates defined in your front matter, see the dateFormat function, which will still leverage the Go layout string explained below but uses a slightly different syntax.
Go's Layout String
Hugo templates format your dates via layout strings that point to a specific reference time:
Mon Jan 2 15:04:05 MST 2006
While this may seem arbitrary, the numerical value of MST is 07, thus making the layout string a sequence of numbers.
Here is a visual explanation taken directly from the Go docs:
Jan 2 15:04:05 2006 MST
=> 1 2 3 4 5 6 -7
Hugo Date and Time Templating Reference
The following examples show the layout string followed by the rendered output.
The examples were rendered and tested in CST and all point to the same field in a content file'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 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"(RFC1123Z)- Returns:
Fri, 03 Mar 2017 14:15:59 -0600
More examples can be found in Go's documentation for the time package.
Cardinal Numbers and Ordinal Abbreviations
Spelled-out cardinal numbers (e.g. "one", "two", and "three") are not currently supported.
Use the humanize function to render the day of the month as an ordinal number:
{{ humanize .Date.Day }} of {{ .Date.Format "January 2006" }}
This will output:
5th of March 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