GroupByLastmod
Syntax
PAGES.GroupByLastmod 布局 [排序]
Returns
page.PagesGroup
在按最后修改日期分组时,值由您的站点配置确定,默认为前置元数据(front matter)中的lastmod
字段。
布局字符串的格式与time.Format
函数的布局字符串相同。所得到的分组键是针对语言和地区进行本地化的。
对于可选的排序顺序,可以指定 asc
表示升序,或者 desc
表示降序。
按年份和月份分组内容:
{{ range .Pages.GroupByLastmod "January 2006" }}
<p>{{ .Key }}</p>
<ul>
{{ range .Pages }}
<li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
{{ end }}
</ul>
{{ end }}
按升序排序分组:
{{ range .Pages.GroupByLastmod "January 2006" "asc" }}
<p>{{ .Key }}</p>
<ul>
{{ range .Pages }}
<li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
{{ end }}
</ul>
{{ end }}
每个分组中的页面也可以按最后修改日期排序,根据分组选项的不同,可以按升序或降序排序。要对每个分组内的页面进行排序,请使用其中一种排序方法。例如,要按标题对每个分组中的页面进行排序:
{{ range .Pages.GroupByLastmod "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
。