Go 时间加减

以某个时间点为起点往前或往后推算新时间,是日常写代码时经常遇到的需求。比如计算订单 30 分钟后的超时时间,或者推算会员 1 年后的到期日。

在 Go 语言中,我们可以根据时间单位的不同选择对应的方法:加减 “时、分、秒” 使用 Add() 方法,加减 “年、月、日” 则使用 AddDate() 方法。

加减时、分、秒:Add()

当我们想要在某个时间点的基础上增加或减少几小时、几分钟、几秒钟时,可以调用 time.Time 的 Add() 方法。

语法:

t.Add(d)

说明:

Add() 方法接收一个 time.Duration 类型的时长参数 d,计算并返回一个新的 time.Time 对象,不会修改原来的时间变量 t。关于参数 d 的正负取值,我们需要清楚以下 2 点:

  • 传入正数时长:表示将时间往后推迟,比如 t.Add(2 * time.Hour) 表示 t 的 2 小时之后。
  • 传入负数时长:表示将时间往前倒退,比如 t.Add(-30 * time.Minute) 表示 t 的 30 分钟之前。

示例 1:往后增加时间

package main

import (
    "fmt"
    "time"
)

func main() {
    // 基准时间:2026-08-15 10:00:00
    base := time.Date(2026, 8, 15, 10, 0, 0, 0, time.Local)
    fmt.Println(base.Format(time.DateTime))

    // 往后加 2 小时
    t1 := base.Add(2 * time.Hour)
    fmt.Println(t1.Format(time.DateTime))

    // 往后加 45 分钟
    t2 := base.Add(45 * time.Minute)
    fmt.Println(t2.Format(time.DateTime))
}

运行结果如下。

2026-08-15 10:00:00
2026-08-15 12:00:00
2026-08-15 10:45:00

分析:

base.Add(2 * time.Hour) 表示在上午 10:00:00 的基础上往后加 2 小时,得到中午 12:00:00。base.Add(45 * time.Minute) 则表示往后加 45 分钟,得到 10:45:00。

如果需要同时加上 2 小时 30 分,我们不用连调两次 Add()。直接把两段时长相加写成 base.Add(2*time.Hour + 30*time.Minute) 就可以了。

需要注意的是,Add() 不会改动原变量 base 本身。平时调用时我们必须用新变量接收它返回的新时间对象,再配合 Format() 方法打印查看。

推算过去的时间同样很简单,只需要把时长改成负数传给 Add() 即可,请看下面例子。

示例 2:往前减去时间

package main

import (
    "fmt"
    "time"
)

func main() {
    base := time.Date(2026, 8, 15, 10, 0, 0, 0, time.Local)

    // 往前减 30 分钟
    t1 := base.Add(-30 * time.Minute)
    fmt.Println(t1.Format(time.DateTime))

    // 往前减 2 小时
    t2 := base.Add(-2 * time.Hour)
    fmt.Println(t2.Format(time.DateTime))
}

运行结果如下。

2026-08-15 09:30:00
2026-08-15 08:00:00

分析:

在 Go 语言中,并没有名为 Minus 的时间减法方法。想要推算过去的某个时间,我们直接调用 Add() 方法并在时长前面加上负号(-)即可。比如 base.Add(-30 * time.Minute) 就会往前倒退 30 分钟得到 09:30:00。

这里小伙伴们要注意避开一个常见误区:很多初学者想要减去 1 小时,看到 time.Time 有一个 Sub() 方法,就把时长直接传了进去。

// 正确方式
t := base.Add(-1 * time.Hour)

// 错误方式
t := base.Sub(time.Hour)

在 Go 语言中,Sub() 接收的参数必须是另一个 time.Time 时间点,专门用来计算两个时间之间的差值。想要在某个时间点上减去一段时长,我们必须使用 Add(-d) 才行。

加减年、月、日:AddDate()

每个月的天数并不固定,有的月 30 天、有的月 31 天,2 月还有平年和闰年之分。涉及年、月、日的加减时,手动拿天数乘以 24 * time.Hour 不仅繁琐,跨月或跨闰年时还很容易算错。

在 Go 语言中,我们可以使用专门的 AddDate() 方法来按日历规则加减日期。

语法:

t.AddDate(years, months, days)

说明:

AddDate() 方法接收以下 3 个必选的 int 整数参数,计算并返回一个新的 time.Time 对象。参数传正数表示往后加,传负数表示往前减,保持不变则传 0:

  • years(必选):要加减的年数,比如传 1 表示往后加 1 年。
  • months(必选):要加减的月数,比如传 2 表示往后加 2 个月。
  • days(必选):要加减的天数,比如传 -20 表示往前减 20 天。

示例 3:加减年、月、日

package main

import (
    "fmt"
    "time"
)

func main() {
    base := time.Date(2026, 8, 15, 10, 0, 0, 0, time.Local)
    fmt.Println(base.Format(time.DateOnly))

    // 往后加 1 年
    t1 := base.AddDate(1, 0, 0)
    fmt.Println(t1.Format(time.DateOnly))

    // 往后加 2 个月零 10 天
    t2 := base.AddDate(0, 2, 10)
    fmt.Println(t2.Format(time.DateOnly))

    // 往前减 20 天
    t3 := base.AddDate(0, 0, -20)
    fmt.Println(t3.Format(time.DateOnly))
}

运行结果如下。

2026-08-15
2027-08-15
2026-10-25
2026-07-26

分析:

在这个例子中,base.AddDate(1, 0, 0) 表示年份加 1,月份和天数传 0 保持不变,计算结果为 2027-08-15。

而 base.AddDate(0, 0, -20) 表示从 8 月 15 日往前减 20 天。Go 会自动按日历跨月倒推(7 月有 31 天),准确算出 2026-07-26。

提示: 当我们需要计算 “明天这个时候” 或 “3 天前” 时,虽然也可以写 t.Add(24 * time.Hour),但平时更推荐写成 t.AddDate(0, 0, 1) 和 t.AddDate(0, 0, -3)。这样既不用手动计算小时乘法,代码读起来也更直观。

在使用 AddDate() 按月加减时,如果刚好遇到月末的 31 号,结果会变成哪一天呢?下面我们来看一个容易忽略的边界例子。

示例 4:月底加减月份的顺延

package main

import (
    "fmt"
    "time"
)

func main() {
    // 2026 年 1 月 31 日
    d := time.Date(2026, 1, 31, 0, 0, 0, 0, time.Local)

    // 往后加 1 个月
    next := d.AddDate(0, 1, 0)
    fmt.Println(next.Format(time.DateOnly))
}

运行结果如下。

2026-03-03

分析:

从运行结果可以看出,2026 年 1 月 31 日往后加 1 个月,得到的并不是 2 月 28 日,而是 "2026-03-03"。这是因为 AddDate(0, 1, 0) 会先推算出 “2 月 31 日”。而 2026 年是平年,2 月只有 28 天,多出的 3 天会自动顺延到 3 月 3 日。

小伙伴们在推算月底账单日或月度会员到期日时,记得留意这一顺延规则。如果业务上需要直接算出某个月的最后一天,我们可以利用 Go 的日期自动进退规则,把下个月的 day 参数传为 0 来一步搞定。

// 把 3 月的日期传为 0,自动回退到 2 月最后一天
febEnd := time.Date(2026, 3, 0, 0, 0, 0, 0, time.Local)

上面这句代码会自动算出 2026-02-28。如果遇到闰年(如 2028 年),它也会自动算出 2028-02-29,不需要我们自己写判断平年闰年的逻辑。

上一篇:

下一篇:

给站长反馈

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

邮箱:lvyenet@vip.qq.com

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