时间函数 on Hugo 中文文档

time.AsTime

Fri, 02 Oct 2026 00:00:00 +0800

概述

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`	`America/Los_Angeles`
`2023-10-15T13:18:50-0700`	`America/Los_Angeles`
`2023-10-15T13:18:50Z`	`Etc/UTC`
`2023-10-15T13:18:50`	默认为 `Etc/UTC`
`2023-10-15`	默认为 `Etc/UTC`
`15 Oct 2023`	默认为 `Etc/UTC`

最后三个示例不是完整限定的时间，默认使用 Etc/UTC 时区。

time.Duration

Fri, 02 Oct 2026 00:00:00 +0800

time.Duration 函数返回一个 time.Duration 值，可与任意 Duration 方法配合使用。

以下模板：

{{ $duration := time.Duration "hour" 24 }}
{{ printf "There are %.0f seconds in one day." $duration.Seconds }}

渲染为：

There are 86400 seconds in one day.

时间单位必须是以下之一：

时长	有效时间单位
hours	`hour`, `h`
minutes	`minute`, `m`
seconds	`second`, `s`
milliseconds	`millisecond`, `ms`
microseconds	`microsecond`, `us`, `µs`
nanoseconds	`nanosecond`, `ns`

time.Format

Fri, 02 Oct 2026 00:00:00 +0800

对 time.Time 值使用 time.Format 函数：

{{ $t := time.AsTime "2023-10-15T13:18:50-07:00" }}
{{ time.Format "2 Jan 2006" $t }} → 15 Oct 2023

也可以对可解析的日期/时间值字符串表示使用 time.Format：

{{ $t := "15 Oct 2023" }}
{{ time.Format "January 2, 2006" $t }} → October 15, 2023

可解析的字符串表示示例：

time.In

Fri, 02 Oct 2026 00:00:00 +0800

（0.146.0 新增）

time.In 函数返回给定日期/时间在指定 IANA 时区中的表示。

如果时区为空字符串或 UTC，时间以 UTC 返回。
如果时区为 Local，时间以系统的本地时区返回。
其它情况下，时区必须是有效的 IANA 时区名称。

{{ $layout := "2006-01-02T15:04:05-07:00" }}
{{ $t := time.AsTime "2025-03-31T14:45:00-00:00" }}

{{ $t | time.In "America/Denver" | time.Format $layout }}     → 2025-03-31T08:45:00-06:00
{{ $t | time.In "Australia/Adelaide" | time.Format $layout }} → 2025-04-01T01:15:00+10:30
{{ $t | time.In "Europe/Oslo" | time.Format $layout }}        → 2025-03-31T16:45:00+02:00

time.Now

Fri, 02 Oct 2026 00:00:00 +0800

例如，在 America/Los_Angeles 时区的 2023 年 10 月 15 日构建站点时：

{{ time.Now }}

这会生成一个 time.Time 值，其字符串表示类似：

2023-10-15 12:59:28.337140706 -0700 PDT m=+0.041752605

要格式化并本地化该值，请把它传给 time.Format 函数：

{{ time.Now | time.Format "Jan 2006" }} → Oct 2023

time.Now 函数返回 time.Time 值，因此可以对结果链式调用任意时间方法。例如：

time.ParseDuration

Fri, 02 Oct 2026 00:00:00 +0800

time.ParseDuration 函数返回一个 time.Duration 值，可与任意 Duration 方法配合使用。

时长字符串是可能带符号的十进制数序列，每个数可带小数部分与单位后缀，例如 300ms、-1.5h 或 2h45m。有效的时间单位为 ns、us（或 µs）、ms、s、m、h。