time.Format

Use the time.Format function with time.Time values:

{{ $t := time.AsTime "2023-10-15T13:18:50-07:00" }}
{{ time.Format "2 Jan 2006" $t }} → 15 Oct 2023

Or use time.Format with a parsable string representation of a date/time value:

{{ $t := "15 Oct 2023" }}
{{ time.Format "January 2, 2006" $t }} → October 15, 2023

Examples of parsable string representations:

最後三個示例不是完全限定的，默認為 Etc/UTC 時區。

To override the default time zone, set the timeZone in your site configuration. The order of precedence for determining the time zone is:

1. The time zone offset in the date/time string
2. The time zone specified in your site configuration
3. The Etc/UTC time zone

Layout string

基於 Go 的參考時間 格式化 time.Time 值：

Mon Jan 2 15:04:05 MST 2006

使用這些組件創建布局字符串：

將布局字符串中的符號替換為 Z 以打印 Z 而不是 UTC 時區的偏移。

{{ $t := "2023-01-27T23:44:58-08:00" }}
{{ $t = time.AsTime $t }}
{{ $t = $t.Format "Jan 02, 2006 3:04 PM Z07:00" }}

{{ $t }} → Jan 27, 2023 11:44 PM -08:00

諸如 PST 和 CET 之類的字符串不是時區。它們是時區 縮寫。

諸如 -07:00 和 +01:00 之類的字符串不是時區。它們是時區 偏移。

時區是具有相同本地時間的地理區域。例如，由 PST 和 PDT（取決於夏令時）縮寫的時區是 America/Los_Angeles。

Localization

Use the time.Format function to localize time.Time values for the current language and region.

Use the layout string as described above, or one of the tokens below. For example:

{{ .Date | time.Format ":date_medium" }} → Jan 27, 2023

Localized to en-US:

Localized to de-DE: