Go语言time.AddDate在America/Santiago时区DST转换时为何结果不一致？

问题背景 #

2024年9月8日00:00，America/Santiago时区正式进入夏令时（时钟向前拨1小时，时区偏移从UTC-4变为UTC-3）。在该转换节点使用Go语言的time.AddDate方法时，出现了与预期不符的时间计算结果，同时存在t3 != t4的疑惑。

测试代码 #

func TestTimezone1(t *testing.T) {
    loc, err := time.LoadLocation("America/Santiago")
    if err != nil {
        panic(err)
    }
    t1, err := time.ParseInLocation(time.DateTime, "2024-09-07 00:00:00", loc)
    if err != nil {
        panic(err)
    }

    fmt.Println(t1.Unix(), t1.Format(time.DateTime))

    t2 := t1.AddDate(0, 0, 1)
    fmt.Println(t2.Unix(), t2.Format(time.DateTime), t2.Unix()-t1.Unix())

    t3 := t2.AddDate(0, 0, 1)
    fmt.Println(t3.Unix(), t3.Format(time.DateTime), t3.Unix()-t2.Unix())

    t4 := t1.AddDate(0, 0, 2)
    fmt.Println(t4.Unix(), t4.Format(time.DateTime), t4.Unix()-t3.Unix())
}

实际运行结果 #

=== RUN   TestTimezone1

1725681600 2024-09-07 00:00:00

1725764400 2024-09-07 23:00:00 82800

1725847200 2024-09-08 23:00:00 82800

1725850800 2024-09-09 00:00:00 3600

--- PASS: TestTimezone1 (0.00s)

预期结果 #

1725681600 2024-09-07 00:00:00

1725768000 2024-09-08 01:00:00 86400

1725850800 2024-09-09 00:00:00 82800

1725850800 2024-09-09 00:00:00 0

核心原因解析 #

1. time.AddDate的设计逻辑 #

time.AddDate是基于本地日历的日期增量操作，而非绝对时间的秒数累加。它的执行流程是：

• 直接对原时间的本地年、月、日字段加上指定增量，得到新的本地日历时间
• 将该日历时间转换为对应时区的有效时间戳（Unix时间）

这种设计只关注日历日期的变化，不会自动处理时区转换带来的绝对时间偏差。

2. 夏令时转换导致的异常 #

在America/Santiago时区的夏令时转换节点：

• t1为2024-09-07 00:00:00（标准时间UTC-4），对应Unix时间戳1725681600。
• 调用t1.AddDate(0,0,1)时，先得到本地日历时间2024-09-08 00:00:00，但该时间在时区中不存在——因为9月8日00:00一到，时钟直接跳至01:00:00（夏令时启动）。
• Go的time包会将这种不存在的本地时间映射为最接近的有效时间，即2024-09-07 23:00:00（标准时间UTC-4），对应Unix时间戳1725764400，与t1的绝对时间差为23小时（82800秒），而非预期的24小时。

3. 为什么t3 != t4 #

• t3是t2.AddDate(0,0,1)：t2为2024-09-07 23:00:00（标准时间UTC-4），加1天日历日期得到2024-09-08 23:00:00（夏令时UTC-3）。此时夏令时已启动，该本地时间有效，但本地日历的24小时间隔对应绝对时间的23小时（因夏令时拨快1小时），所以t3的Unix时间戳为1725847200。
• t4是t1.AddDate(0,0,2)：直接对t1的本地日历日期加2天，得到2024-09-09 00:00:00（夏令时UTC-3），该时间有效，对应Unix时间戳1725850800。
• 两者的绝对时间差为1小时，因为t3是两次连续受夏令时影响的日期增量结果，而t4是直接跳过中间转换、基于初始日期加2天的结果，因此时间戳不同。

解决方案 #

如果需要基于绝对时间的天数增量（每次增加24小时的秒数），应使用time.Add替代AddDate：

t2 := t1.Add(24 * time.Hour)
t3 := t2.Add(24 * time.Hour)
t4 := t1.Add(48 * time.Hour)

该方式基于绝对时间秒数累加，会符合你预期的计算结果。

内容的提问来源于stack exchange，提问作者Chi Feng