TheCloud/hugoDocs
1
0
Fork 0
mirror of https://github.com/gohugoio/hugoDocs.git synced 2025-09-15 06:05:41 -04:00
Code Issues Packages Projects Releases Wiki Activity

tpl: Update Hugo time to support optional [LOCATION] parameter

Browse Source
This commit is contained in:
Mark Johnson 2020-10-19 15:58:05 -07:00 committed by Bjørn Erik Pedersen
parent 72ffeb026e
commit f3b8eccd26
1 changed files with 15 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
content/en/functions/time.md
View File

@ -10,8 +10,8 @@ categories: [functions]
menu: menu:
docs: docs:
parent: "functions" parent: "functions"
keywords: [dates,time] keywords: [dates,time,location]
signature: ["time INPUT"] signature: ["time INPUT [LOCATION]"]
workson: [] workson: []
hugoversion: hugoversion:
relatedfuncs: [] relatedfuncs: []
@ -19,7 +19,7 @@ deprecated: false
aliases: [] aliases: []
--- ---
`time` converts a timestamp string into a [`time.Time`](https://godoc.org/time#Time) structure so you can access its fields: `time` converts a timestamp string with an optional timezone into a [`time.Time`](https://godoc.org/time#Time) structure so you can access its fields:
``` ```
{{ time "2016-05-28" }} → "2016-05-28T00:00:00Z" {{ time "2016-05-28" }} → "2016-05-28T00:00:00Z"
@ -27,6 +27,18 @@ aliases: []
{{ mul 1000 (time "2016-05-28T10:30:00.00+10:00").Unix }} → 1464395400000, or Unix time in milliseconds {{ mul 1000 (time "2016-05-28T10:30:00.00+10:00").Unix }} → 1464395400000, or Unix time in milliseconds
``` ```
## Using Timezone
The optional 2nd parameter [LOCATION] argument is a string that references a timezone that is associated with the specified time value. If the time value has an explicit timezone or offset specified, it will take precedence over an explicit [LOCATION].
```
{{ time "2020-10-20" }} → 2020-10-20 00:00:00 +0000 UTC
{{ time "2020-10-20" "America/Los_Angeles" }} → 2020-10-20 00:00:00 -0700 PDT
{{ time "2020-01-20" "America/Los_Angeles" }} → 2020-01-20 00:00:00 -0800 PST
```
> **Note**: Timezone support via the [LOCATION] parameter is included with Hugo `0.77`.
## Example: Using `time` to get Month Index ## Example: Using `time` to get Month Index
The following example takes a UNIX timestamp---set as `utimestamp: "1489276800"` in a content's front matter---converts the timestamp (string) to an integer using the [`int` function][int], and then uses [`printf`][] to convert the `Month` property of `time` into an index. The following example takes a UNIX timestamp---set as `utimestamp: "1489276800"` in a content's front matter---converts the timestamp (string) to an integer using the [`int` function][int], and then uses [`printf`][] to convert the `Month` property of `time` into an index.