time.Format

使用 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

使用這些組件創建一個佈局字串：

如果要顯示 UTC 區域的 Z（而非偏移），請在佈局字串中將符號替換為 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 值。

可使用上述描述的格式字串，或者下列標記之一。例如：

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

在地化為 en-US：

在地化為 de-DE：