time.Format

time.Format LAYOUT INPUT

string

dateFormat

将 time.Format 函数与 time.Time 值一起使用

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

或将 time.Format 与日期/时间值的可解析字符串表示形式一起使用

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

可解析字符串表示形式的示例

最后三个示例不是完全限定的，并且默认为 Etc/UTC 时区。

要覆盖默认时区，请在站点配置中设置 timeZone。确定时区的优先级顺序是

1. 日期/时间字符串中的时区偏移量
2. 在站点配置中指定的时区
3. Etc/UTC 时区

布局字符串

根据 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。

本地化

使用 time.Format 函数将 time.Time 值本地化为当前语言和地区。

使用如上所述的布局字符串，或使用下面的令牌之一。例如

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

本地化为 en-US

本地化为 de-DE