Time 方法 on Hugo 中文文档

Add

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

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}

{{ $d1 = time.ParseDuration "3h20m10s" }}
{{ $d2 = time.ParseDuration "-3h20m10s" }}

{{ $t.Add $d1 }} → 2023-01-28 03:05:08 -0800 PST
{{ $t.Add $d2 }} → 2023-01-27 20:24:48 -0800 PST

AddDate

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

{{ $d := "2022-01-01" | time.AsTime }}

{{ $d.AddDate 0 0 1 | time.Format "2006-01-02" }} → 2022-01-02
{{ $d.AddDate 0 1 1 | time.Format "2006-01-02" }} → 2022-02-02
{{ $d.AddDate 1 1 1 | time.Format "2006-01-02" }} → 2023-02-02

{{ $d.AddDate -1 -1 -1 | time.Format "2006-01-02" }} → 2020-11-30

After

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

{{ $t1 := time.AsTime "2023-01-01T17:00:00-08:00" }}
{{ $t2 := time.AsTime "2010-01-01T17:00:00-08:00" }}

{{ $t1.After $t2 }} → true

Before

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

{{ $t1 := time.AsTime "2023-01-01T17:00:00-08:00" }}
{{ $t2 := time.AsTime "2030-01-01T17:00:00-08:00" }}

{{ $t1.Before $t2 }} → true

Day

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

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.Day }} → 27

Equal

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

{{ $t1 := time.AsTime "2023-01-01T17:00:00-08:00" }}
{{ $t2 := time.AsTime "2023-01-01T20:00:00-05:00" }}

{{ $t1.Equal $t2 }} → true

Format

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

{{ $t := "2023-01-27T23:44:58-08:00" }}
{{ $t = time.AsTime $t }}
{{ $format := "2 Jan 2006" }}

{{ $t.Format $format }} → 27 Jan 2023

Format 方法可用于任何 time.Time 值，包括前置元数据中四个预定义的日期：

{{ $format := "2 Jan 2006" }}

{{ .Date.Format $format }}
{{ .PublishDate.Format $format }}
{{ .ExpiryDate.Format $format }}
{{ .Lastmod.Format $format }}

Hour

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

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.Hour }} → 23

IsDST

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

{{ $t1 := time.AsTime "2023-01-01T00:00:00-08:00" }}
{{ $t2 := time.AsTime "2023-07-01T00:00:00-07:00" }}

{{ $t1.IsDST }} → false
{{ $t2.IsDST }} → true

IsZero

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

{{ $t1 := time.AsTime "2023-01-01T00:00:00-08:00" }}
{{ $t2 := time.AsTime "0001-01-01T00:00:00-00:00" }}

{{ $t1.IsZero }} → false
{{ $t2.IsZero }} → true

Local

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

{{ $t := time.AsTime "2023-01-28T07:44:58+00:00" }}
{{ $t.Local }} → 2023-01-27 23:44:58 -0800 PST

Minute

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

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.Minute }} → 44

Month

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

把 time.Month 值转换为字符串：

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.Month.String }} → January

把 time.Month 值转换为整数：

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.Month | int }} → 1

Nanosecond

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

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.Nanosecond }} → 0

Round

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

对中间值的舍入行为是向上舍入。

Round 方法把 TIME 当作自 zero time（零时刻）起的绝对时长来处理，而不是对时间的呈现形式进行操作。如果 DURATION 是一小时的整数倍，Round 返回的时间的分钟数可能不为零，具体取决于时区。

Second

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

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.Second }} → 58

Sub

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

{{ $t1 := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t2 := time.AsTime "2023-01-26T22:34:38-08:00" }}

{{ $t1.Sub $t2 }} → 25h10m20s

Truncate

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

Truncate 方法把 TIME 当作自 zero time（零时刻）起的绝对时长来处理，而不是对时间的呈现形式进行操作。如果 DURATION 是一小时的整数倍，Truncate 返回的时间的分钟数可能不为零，具体取决于时区。

UTC

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

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.UTC }} → 2023-01-28 07:44:58 +0000 UTC

Unix

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

参见 Unix 时间戳。

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.Unix }} → 1674891898

UnixMicro

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

参见 Unix 时间戳。

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.UnixMicro }} → 1674891898000000

UnixMilli

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

参见 Unix 时间戳。

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.UnixMilli }} → 1674891898000

UnixNano

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

参见 Unix 时间戳。

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.UnixNano }} → 1674891898000000000

Weekday

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

把 time.Weekday 值转换为字符串：

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.Weekday.String }} → Friday

把 time.Weekday 值转换为整数：

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.Weekday | int }} → 5

Year

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

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.Year }} → 2023

YearDay

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

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}
{{ $t.YearDay }} → 27