GroupByPublishDate
返回給定頁面集合按發布日期降序分組。
Syntax
PAGES.GroupByPublishDate LAYOUT [SORT]
Returns
page.PagesGroup
按發布日期分組時，值由您的 站點配置 確定，默認為 front matter 中的 publishDate 字段。
布局字符串 的格式與 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 }}布局字符串
基於 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" |
| 上午/下午標記 | "PM" |
| 時區偏移 | "-0700" "-07:00" "-07" "-070000" "-07:00:00" |
將布局字符串中的符號替換為 Z 以打印 Z 而不是 UTC 時區的偏移。
| 描述 | 有效組件 |
|---|---|
| 時區偏移 | "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。