Go 计算时间差

平时做项目时,我们经常需要对比两个时间点:比如计算两个时刻相差了多久、统计某段代码运行了多长时间,或者判断优惠券是否已经过期。

在 Go 语言中,计算两个时间点的差值可以使用 Sub() 方法,统计代码执行耗时可以使用 time.Since() 函数。如果只是想判断时间的先后关系,还可以调用 Before()、After() 和 Equal() 方法。

计算两个时间的差值:Sub()

如果我们已经有了两个 time.Time 时间对象 t1 和 t2,想要计算它们之间相差了多长时间,可以调用 Sub() 方法。其中,sub 是英文 “subtract(相减)” 的缩写。

这里要注意和前面学过的 Add() 区分开:Add() 是在一个时间点上加减时长,而 Sub() 则是拿两个时间点直接相减。

语法:

t2.Sub(t1)

说明:

t2.Sub(t1) 的计算方向相当于数学减法中的 t2 - t1,也就是拿圆点前面的 t2 减去括号里的 t1,返回值为 time.Duration 类型的时长对象。如果 t2 晚于 t1,算出来的差值就是正数;如果 t2 早于 t1,算出来的差值则是负数。

拿到返回的时长对象 diff 之后,我们可以调用以下方法将其折算为指定单位的数值:

  • diff.Hours():返回相差的总小时数,类型为 float64。
  • diff.Minutes():返回相差的总分钟数,类型为 float64。
  • diff.Seconds():返回相差的总秒数,类型为 float64。
  • diff.Milliseconds():返回相差的总毫秒数,类型为 int64。

示例 1:计算相差的时、分、秒

package main

import (
    "fmt"
    "time"
)

func main() {
    t1 := time.Date(2026, 9, 10, 9, 0, 0, 0, time.Local)
    t2 := time.Date(2026, 9, 10, 11, 30, 0, 0, time.Local)

    // 计算 t2 减去 t1 的时间差
    diff := t2.Sub(t1)

    fmt.Println(diff)
    fmt.Println(diff.Hours())
    fmt.Println(diff.Minutes())
    fmt.Println(diff.Seconds())
}

运行结果如下。

2h30m0s
2.5
150
9000

分析:

t2.Sub(t1) 算出从上午 09:00 到 11:30 相差 2h30m0s。

这里小伙伴们要注意,diff.Hours() 和 diff.Minutes() 并不是分别取出 “2 小时 30 分” 里的 2 和 30,而是把整段时长折算成对应单位的总数。比如 2 小时 30 分钟折算成小时是 2.5,折算成分钟则是 150。

下面我们接着看如何计算两个日期之间相差了多少天。

示例 2:计算相差的天数

package main

import (
    "fmt"
    "time"
)

func main() {
    d1 := time.Date(2026, 9, 10, 0, 0, 0, 0, time.Local)
    d2 := time.Date(2026, 9, 25, 0, 0, 0, 0, time.Local)

    // 先算出相差的总小时数,再除以 24 转为整数天数
    days := int(d2.Sub(d1).Hours() / 24)
    fmt.Printf("相差 %d 天\n", days)
}

运行结果如下。

相差 15 天

分析:

time.Duration 没有直接提供获取天数的方法。因为一天有 24 个小时,我们只需要先调用 d2.Sub(d1).Hours() 算出总小时数,除以 24 后再通过 int() 转为整数,就能得到相差的天数。

提示: 按日历计算两个日期相差几天时,建议先把两者的时、分、秒都归零,避免因当天时刻不同导致不足 24 小时而被 int() 少算 1 天。如果手里拿到的是带时分秒的 t,我们可以写成 time.Date(t.Year(), t.Month(), t.Day(), 0, 0, 0, 0, t.Location()) 对齐到当天零点。

统计代码耗时:time.Since()

在测试程序性能时,我们经常需要测量某一个函数或某一段循环从开始执行到运行结束一共花了多少时间。在 Go 语言中,我们可以直接使用 time.Since() 函数来实现。其中,since 是英文 “自从……以来” 的意思。

语法:

time.Since(start)

说明:

start 是一个代表起始时刻的 time.Time 对象。time.Since(start) 会自动计算从过去的时刻 start 到当前时刻一共经过了多长时间,返回值为 time.Duration 类型。

示例 3:统计代码运行耗时

package main

import (
    "fmt"
    "time"
)

func main() {
    // 记录起始时刻
    start := time.Now()

    // 执行需要测速的代码
    sum := 0
    for i := 0; i < 1000000; i++ {
        sum += i
    }

    // 计算从 start 到现在经过的耗时
    cost := time.Since(start)
    fmt.Println(sum)
    fmt.Println(cost)
}

运行结果如下。

499999500000
312.5µs

分析:

在这个例子中,我们在循环开始前调用 time.Now() 记下起始时刻 start。等 100 万次累加执行完毕后,再调用 time.Since(start) 就拿到了运行耗时 312.5µs。其中 µs 是微秒单位,每次运行的耗时数值会随机器性能略有波动。

底层计算耗时的时候,Go 会自动利用 time.Now() 附带的单调时钟读数。哪怕程序运行中途系统时间被校时调整,统计出来的耗时依然准确。

time.Since(start) 本质上是一个简化写法。对于这个例子来说,下面 2 种方式是等价的。

// 方式 1(推荐)
cost := time.Since(start)

// 方式 2
cost := time.Now().Sub(start)

在实际开发中,统计代码耗时更推荐使用方式 1,写起来更简短直观。此外,time 包还提供了一个方向相反的 time.Until(deadline) 函数,作用相当于 deadline.Sub(time.Now())。它专门用来计算从现在到未来的截止时刻 deadline 还剩下多长时间。

比较两个时间的先后顺序

有时我们并不需要算出具体相差了几小时几分钟,只是想判断两个时间点的早晚关系,比如判断活动是否已经开始。由于 time.Time 是一个结构体,不能直接使用 < 或 > 运算符比大小,我们可以调用它提供的 Before()、After() 和 Equal() 方法来判断。

语法:

t1.Before(t2)
t1.After(t2)
t1.Equal(t2)

说明:

以上 3 个方法的返回值均为布尔值(bool),具体含义如下:

  • t1.Before(t2):判断 t1 是否早于 t2;是则返回 true,否则返回 false。
  • t1.After(t2):判断 t1 是否晚于 t2;是则返回 true,否则返回 false。
  • t1.Equal(t2):判断 t1 和 t2 是否代表同一时刻;是则返回 true,否则返回 false。

示例 4:比较时间的早晚

package main

import (
    "fmt"
    "time"
)

func main() {
    t1 := time.Date(2026, 9, 10, 9, 0, 0, 0, time.Local)
    t2 := time.Date(2026, 9, 10, 11, 30, 0, 0, time.Local)

    fmt.Println(t1.Before(t2))    // t1 是否早于 t2
    fmt.Println(t1.After(t2))     // t1 是否晚于 t2
    fmt.Println(t1.Equal(t2))     // t1 与 t2 是否相同
}

运行结果如下。

true
false
false

分析:

在这个例子中,t1 是上午 09:00,t2 是 11:30。因为 t1 比 t2 早,所以 t1.Before(t2) 返回 true,而 t1.After(t2) 和 t1.Equal(t2) 都返回 false。

既然有了 Equal() 方法,可能有些小伙伴会觉得奇怪:直接使用 == 来判断两个时间是否相等不行吗?下面我们通过跨时区的例子对比一下。

示例 5:跨时区判断是否为同一时刻

package main

import (
    "fmt"
    "time"
)

func main() {
    cst := time.FixedZone("CST", 8*3600)
    bjTime := time.Date(2026, 9, 10, 20, 0, 0, 0, cst)
    utcTime := time.Date(2026, 9, 10, 12, 0, 0, 0, time.UTC)

    fmt.Println(bjTime == utcTime)        // 连同时区字段一起比较
    fmt.Println(bjTime.Equal(utcTime))    // 自动换算时区比较时刻
}

运行结果如下。

false
true

分析:

东八区的当晚 20:00 与 UTC 零时区的中午 12:00 实际上是同一个时刻。但由于 == 运算符会连同结构体内部的时区字段一起比对,导致 bjTime == utcTime 返回了 false。

另外,== 还会比对隐藏的单调时钟读数。哪怕两个时间处于同一个时区,只要一个来自 time.Now()、另一个来自字符串解析,使用 == 也可能返回 false。

而调用 Equal() 时,Go 会自动换算时区并忽略单调时钟,只对比真实时刻。因此判断两个时间是否相等时,小伙伴们应该统一使用 Equal() 方法。

上一篇:

下一篇:

给站长反馈

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

邮箱:lvyenet@vip.qq.com

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