time.AsTime
语法
time.AsTime INPUT [TIMEZONE]
返回值
time.Time
别名
time
概述
Hugo 提供了函数和方法来格式化、本地化、解析、比较和操作日期/时间值。在使用日期/时间值的字符串表示形式执行任何这些操作之前,您必须首先使用 time.AsTime
函数将其转换为 time.Time
值。
{{ $t := "2023-10-15T13:18:50-07:00" }}
{{ time.AsTime $t }} → 2023-10-15 13:18:50 -0700 PDT (time.Time)
可解析的字符串
如上所示,第一个参数必须是日期/时间值的可解析字符串表示形式。例如
格式 | 时区 |
---|---|
2023-10-15T13:18:50-07:00 |
美国/洛杉矶 |
2023-10-15T13:18:50-0700 |
美国/洛杉矶 |
2023-10-15T13:18:50Z |
Etc/UTC |
2023-10-15T13:18:50 |
默认为 Etc/UTC |
2023-10-15 |
默认为 Etc/UTC |
2023 年 10 月 15 日 |
默认为 Etc/UTC |
最后三个示例不是完全合格的,并且默认为 Etc/UTC
时区。
要覆盖默认时区,请在站点配置中设置timeZone
或为 time.AsTime
函数提供第二个参数。例如
{{ time.AsTime "15 Oct 2023" "America/Los_Angeles" }}
有效时区的列表可能依赖于系统,但应包括 UTC
、Local
或 IANA 时区数据库中的任何位置。
确定时区的优先级顺序为
- 日期/时间字符串中的时区偏移量
- 作为
time.AsTime
函数的第二个参数提供的时区 - 在站点配置中指定的时区
Etc/UTC
时区