Go 日期与时间

平时写程序时,记录日志、统计接口耗时、计算会员到期日,或者让程序停顿等待,都离不开日期与时间操作。在 Go 语言中,标准库已经自带了 time 包,不需要安装任何第三方库就能直接使用。

在正式编写时间代码之前,我们需要先分清 time 包里最基础的两个概念:一个是表示 “某一具体时刻” 的 time.Time,另一个是表示 “一段时间长度” 的 time.Duration。

时刻与时长:time.Time 和 time.Duration

很多刚接触 time 包的小伙伴容易把 “时刻” 和 “时长” 混为一谈。你可以拿墙上的挂钟来打个比方:指针指着的 “上午 8 点 30 分” 是一个具体的时间点,也就是 “时刻”。而 “一节课上 45 分钟” 是一段时间跨度,也就是 “时长”。

在 Go 语言中,这两者分别使用不同的类型来表示,它们的区别如下图所示。

time.Time(时刻)与 time.Duration(时长)的区别

在 time 包中,这两个类型的具体职责如下:

  • time.Time:本质上是一个结构体,用来表示某一个具体的日期和时间点,比如 “2026 年 10 月 1 日 08:30:00”。
  • time.Duration:底层基于 int64 整数定义,用来表示两个时间点之间相差的时间长度,比如 “5 秒” 或 “2 小时”。从英文意思上就很容易记住,duration 就是 “持续时间” 的意思。

time.Duration 以 “纳秒” 作为最小计数单位。为了方便我们在代码中直接表示毫秒、秒、分钟或小时,time 包预先定义好了 6 个常用的时间单位常量。

语法:

倍数 * 时间单位常量

说明:

当我们需要表示一段时间长度时,直接拿具体的数值乘以对应的时间单位常量就可以了。time 包中常用的时间单位常量如下表所示。

时间单位常量
常量名 换算关系 说明
time.Nanosecond 1 1 纳秒(十亿分之一秒)
time.Microsecond 1000 * time.Nanosecond 1 微秒(百万分之一秒)
time.Millisecond 1000 * time.Microsecond 1 毫秒(千分之一秒)
time.Second 1000 * time.Millisecond 1 秒
time.Minute 60 * time.Second 1 分钟
time.Hour 60 * time.Minute 1 小时

提示: 在 time 包中,最大的时间单位常量只提供到小时 time.Hour,并没有提供表示 “天” 或 “周” 的常量。这是因为部分地区实行夏令时,一天的长度并不总是固定的 24 小时。平时在代码中如果要表示 1 天,我们直接写成 24 * time.Hour 即可。

示例 1:表示时间长度

package main

import (
    "fmt"
    "time"
)

func main() {
    d1 := 5 * time.Second    // 5 秒
    d2 := 2 * time.Hour      // 2 小时
    d3 := 24 * time.Hour     // 24 小时

    fmt.Println(d1)
    fmt.Println(d2)
    fmt.Println(d3)
    fmt.Printf("d1 的类型:%T\n", d1)
}

运行结果如下。

5s
2h0m0s
24h0m0s
d1 的类型:time.Duration

分析:

5 * time.Second 表示 5 个 1 秒钟,赋值给变量 d1 后会被自动推导为 time.Duration 类型。调用 fmt.Println() 打印时,它会自动转换成直观的时、分、秒形式,比如 2h0m0s 就表示 2 小时 0 分 0 秒。

需要特别注意的是,如果倍数存放在 int 整型变量中,我们不能直接拿它与 time.Second 相乘,而要先转换类型。

n := 5

// 正确方式
d := time.Duration(n) * time.Second

// 错误方式
d := n * time.Second

为什么直接写 5 * time.Second 没问题,换成 n * time.Second 就会报错呢?因为直接写出来的数字 5 还没有定死类型,相乘时会自动顺应 time.Duration 类型。

而一旦执行了 n := 5,变量 n 的类型就被定死成了 int。由于 Go 语言要求不同类型的变量运算前必须先做类型转换,int 变量不能和 time.Duration 直接相乘,我们需要先通过 time.Duration(n) 转换一下才行。

创建指定时间:time.Date()

在 Go 语言中,如果我们想要根据指定的年、月、日、时、分、秒来创建一个 time.Time 时间对象,可以使用 time.Date() 函数。如果只是想获取当前的系统时间,直接调用 time.Now() 函数即可。

语法:

time.Date(year, month, day, hour, minute, sec, nsec, loc)

说明:

time.Date() 函数接收以下 8 个必选参数,调用后会返回一个 time.Time 对象:

  • year(必选):年份,类型为 int,例如 2026。
  • month(必选):月份,类型为 time.Month。我们既可以传入内置的月份常量 time.October,也可以直接传入数字 10。
  • day(必选):当月几号,类型为 int,取值范围为 1 ~ 31。
  • hour、minute、sec(必选):分别表示小时(0 ~ 23)、分钟(0 ~ 59)和秒数(0 ~ 59),类型均为 int。
  • nsec(必选):不足 1 秒的纳秒数,类型为 int,平时不需要精确到纳秒时直接传 0 即可。
  • loc(必选):所属时区,类型为 *time.Location。传入 time.Local 表示使用电脑当前的本地时区,传入 time.UTC 表示使用世界标准时间。

示例 2:创建指定时间

package main

import (
    "fmt"
    "time"
)

func main() {
    // 传入月份常量
    t1 := time.Date(2026, time.October, 1, 8, 30, 0, 0, time.Local)
    fmt.Println(t1)

    // 直接传入数字月份
    t2 := time.Date(2026, 7, 18, 14, 15, 30, 0, time.Local)
    fmt.Println(t2)
}

运行结果如下。

2026-10-01 08:30:00 +0800 CST
2026-07-18 14:15:30 +0800 CST

分析:

在这个例子中,我们使用 time.Date() 创建了两个指定的时间对象。第 2 个参数代表月份,直接写数字 7 或传入常量 time.October 都可以。如果月份存放在一个 int 变量 m 中,小伙伴们记得先写成 time.Month(m) 转换类型。

直接打印 time.Time 对象时,结果末尾还会附带时区信息。在国内本地电脑上运行时,默认显示 +0800 CST(东八区中国标准时间)。如果在在线编译器或部分云服务器上运行,结果里可能会显示 +0000 UTC,这属于运行环境的正常差异。

如果想要得到 "2026-10-01 08:30:00" 这样干净的时间字符串,我们可以配合 Format() 方法来格式化。

判断时间是否为空:IsZero()

在实际项目中,我们经常会把 time.Time 放进结构体里,用来记录订单的支付时间或用户的上次登录时间。如果一个 time.Time 变量只做了声明、还没有赋具体时间,它的默认值并不是 nil,而是公元元年 0001-01-01 00:00:00 +0000 UTC。

初学者在判断时间有没有赋值时,容易习惯写成 if t == nil,这在编译时会直接报错。因为 time.Time 是一个结构体而不是指针,想要判断它是否为空时间(零值),我们应该调用 IsZero() 方法。

示例 3:使用 IsZero() 判断零值

package main

import (
    "fmt"
    "time"
)

func main() {
    var payTime time.Time
    fmt.Println(payTime)
    fmt.Println(payTime.IsZero())    // 尚未赋值

    payTime = time.Date(2026, 10, 1, 9, 0, 0, 0, time.Local)
    fmt.Println(payTime.IsZero())    // 已有具体时间
}

运行结果如下。

0001-01-01 00:00:00 +0000 UTC
true
false

分析:

var payTime time.Time 声明了一个未初始化的时间变量,此时调用 payTime.IsZero() 返回 true,表示它处于零值状态。等我们给 payTime 赋上具体时间后,再次调用 IsZero() 就会返回 false。

平时在业务代码中检查 “订单是否已支付” 或 “截止时间是否已设置” 时,大家直接使用 if payTime.IsZero() 来判断就可以了。

本地时区与 UTC 时区

在处理日期与时间时,我们最常接触的是以下两个标准时区常量:

  • time.UTC:表示世界标准时间(Coordinated Universal Time),也就是零时区的时间。
  • time.Local:表示程序运行所在机器的本地时区。在国内的电脑上运行时,time.Local 默认就是东八区北京时间,比 UTC 时间快 8 个小时。

如果我们已经拿到了一个 time.Time 对象,想要将它切换到其他时区查看对应的时刻,可以调用以下 3 个方法:

  • t.UTC():将时间 t 转换为 UTC 零时区的时间并返回。
  • t.Local():将时间 t 转换为当前系统的本地时区时间并返回。
  • t.In(loc):将时间 t 转换为指定时区 loc 下的时间并返回。

其中,参数 loc 表示目标时区。我们可以通过 time.FixedZone("CST", 8*3600) 按偏移秒数直接创建东八区,这里的 8*3600 代表比 UTC 快 8 小时(1 小时等于 3600 秒)。下面我们来看一个切换时区的例子。

示例 4:切换时区

package main

import (
    "fmt"
    "time"
)

func main() {
    // 创建 UTC 零时区时间
    utcTime := time.Date(2026, 3, 15, 12, 0, 0, 0, time.UTC)
    fmt.Println(utcTime)

    // 切换到东八区(快 8 小时)
    cstZone := time.FixedZone("CST", 8*3600)
    cstTime := utcTime.In(cstZone)
    fmt.Println(cstTime)

    // 再转回 UTC 时间
    fmt.Println(cstTime.UTC())
}

运行结果如下。

2026-03-15 12:00:00 +0000 UTC
2026-03-15 20:00:00 +0800 CST
2026-03-15 12:00:00 +0000 UTC

分析:

utcTime 指定了 time.UTC 零时区,代表世界标准时间中午 12:00:00。随后我们先通过 time.FixedZone("CST", 8*3600) 创建东八区,再调用 utcTime.In(cstZone) 切换时区。这样打印出来的时刻就变成了北京时间当晚 20:00:00。

这里小伙伴们要注意,调用 t.UTC()、t.Local() 或 t.In(loc) 只是改变了时间在屏幕上显示的 “时区视角”,并不会改变它对应的真实时刻。

LoadLocation 与 FixedZone 的区别

除了使用 time.FixedZone() 按偏移秒数创建时区之外,time 包还提供了 time.LoadLocation() 函数。它可以按标准地区名称加载时区,比如 loc, err := time.LoadLocation("Asia/Shanghai")。需要注意的是,该函数会同时返回时区对象和 error 错误值,调用时不能只用一个变量接收。

在实际开发中,有些精简版云服务器或容器环境缺少系统的时区数据包,调用 time.LoadLocation() 就会返回错误。如果项目只需要固定使用东八区北京时间,直接调用不依赖外部文件的 time.FixedZone("CST", 8*3600) 会更省事。

给站长反馈

绿叶网正在不断完善中,小伙伴们如果发现任何问题,还望多多给站长反馈,谢谢!

邮箱:lvyenet@vip.qq.com

「绿叶网」服务号
绿叶网服务号放大
关注服务号,微信也能看教程。
绿叶网服务号