time.Format

对 time.Time 值使用 time.Format 函数：

{{ $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，UTC 时区就会打印 Z 而不是偏移量。

{{ $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 值。

可以使用上文所述的布局字符串，也可以使用下面某个标记（token）。例如：

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

本地化为 en-US：

本地化为 de-DE：