GroupByDate

當依日期分組時，該值由您的網站設定決定，預設使用前置資料中的 date 欄位。

layout 字串具有與 time.Format 函數的 layout 字串相同的格式。結果的分組鍵會根據語言和地區進行本地化。

對於選擇性的排序順序，請指定 asc 以進行升冪排序，或 desc 以進行降冪排序。

要按年和月分組內容：

{{ range .Pages.GroupByDate "January 2006" }}
  <p>{{ .Key }}</p>
  <ul>
    {{ range .Pages }}
      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
    {{ end }}
  </ul>
{{ end }}

要按升冪排序分組：

{{ range .Pages.GroupByDate "January 2006" "asc" }}
  <p>{{ .Key }}</p>
  <ul>
    {{ range .Pages }}
      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
    {{ end }}
  </ul>
{{ end }}

每個分組中的頁面也會按日期排序，無論是升冪還是降冪，取決於分組選項。要對每個分組中的頁面進行排序，可以使用其中一種排序方法。例如，要按標題對每個分組中的頁面進行排序：

{{ range .Pages.GroupByDate "January 2006" }}
  <p>{{ .Key }}</p>
  <ul>
    {{ range .Pages.ByTitle }}
      <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
    {{ end }}
  </ul>
{{ end }}

Layout 字串

根據 Go 的參考時間 格式化 time.Time 值：

Mon Jan 2 15:04:05 MST 2006

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

描述 有效組件
年 "2006" "06"
月 "Jan" "January" "01" "1"
週日 "Mon" "Monday"
日 "2" "_2" "02"
年日 "__2" "002"
小時 "15" "3" "03"
分鐘 "4" "04"
秒數 "5" "05"
AM/PM 標記 "PM"
時區偏移 "-0700" "-07:00" "-07" "-070000" "-07:00:00"

如果要顯示 UTC 區域的 Z（而非偏移），請在佈局字串中將符號替換為 Z。

描述 有效組件
時區偏移 "Z0700" "Z07:00" "Z07" "Z070000" "Z07:00:00" 
{{ $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。

GroupByExpiryDate GroupBy