GroupByPublishDate

當按發佈日期分組時，值由您的 網站配置 決定，預設使用 publishDate 欄位。

layout 字串 與 time.Format 函數的格式相同。生成的分組鍵會根據語言與區域進行 本地化。

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

按年與月分組內容：

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

按升冪排序分組：

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

每個分組內的頁面也會根據發佈日期排序，根據您的分組選項，排序順序為升冪或降冪。若要對每個分組內的頁面進行排序，可使用排序方法之一。例如，若要按標題排序每個分組內的頁面：

{{ range .Pages.GroupByPublishDate "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。

HasChildren GroupByParamDate