Go 怎么用 time.Location 处理夏令时切换的日期范围

处理带夏令时的日期范围，关键不是把每一天写成 24*time.Hour，而是先用 time.Location 表达业务所在地，再用本地日历构造起止边界。统计“某地 3 月 30 日到 4 月 2 日”的数据时，推荐使用左闭右开范围：起点是 3 月 30 日当地零点，终点是 4 月 2 日当地零点，结束点不参与筛选。

先把日期边界绑定到 time.Location

time.Time 不只是年月日时分秒，还带有用于解释它的 Location。固定偏移量只能表达“永远比 UTC 快几小时”，不能表达某个地区每年变化的夏令时规则，所以业务时区应优先使用 IANA 名称，例如 Europe/Berlin。

loc, err := time.LoadLocation("Europe/Berlin")
if err != nil {
    // 时区数据不可用时不要静默退回本机 Local。
    return err
}

start := time.Date(2024, time.March, 30, 0, 0, 0, 0, loc)
end := time.Date(2024, time.April, 2, 0, 0, 0, 0, loc)

for day := start; day.Before(end); day = day.AddDate(0, 0, 1) {
    // AddDate 按本地日历推进，适合逐日生成报表日期。
    next := day.AddDate(0, 0, 1)
    _ = next // 查询区间可使用 [day, next)。
}

这里的 end 是 4 月 2 日零点，因此循环覆盖 3 月 30 日、31 日和 4 月 1 日。查询数据库或过滤事件时可写成 timestamp >= start AND timestamp ，不需要构造“23:59:59.999999999”这样的脆弱结束时间。

日历天和固定时长要分开

夏令时切换会让本地一天的绝对长度发生变化。Go 官方文档明确说明，AddDate(0, 0, 1) 根据 Location 计算，某些地区可能得到 23 小时或 25 小时的绝对差值；这正是“明天同一当地时间”的语义。相反，Add(24*time.Hour) 表示时间线上确实经过 24 小时，结果的当地钟点可能改变。

loc, err := time.LoadLocation("Europe/Berlin")
if err != nil {
    // 让调用方决定如何处理缺少时区数据。
    panic(err)
}

base := time.Date(2024, time.March, 30, 12, 0, 0, 0, loc)
calendarDay := base.AddDate(0, 0, 1)
fixedDuration := base.Add(24 * time.Hour)

fmt.Println(calendarDay.Format(time.RFC3339), calendarDay.Sub(base))
fmt.Println(fixedDuration.Format(time.RFC3339), fixedDuration.Sub(base))

如果需求是“每天中午执行一次”或“按当地日期统计”，选 AddDate；如果需求是“缓存 24 小时后过期”或“请求超时窗口”，选 Add 或 time.Since。不要用其中一种 API 去替代另一种业务含义。

解析输入时保留所在地语义

没有时区后缀的字符串并不自带地点。time.Parse 会按 UTC 解释这类输入，而 time.ParseInLocation 会按指定 Location 解释；导入用户填写的“2024-03-31 09:00:00”时，后者通常才符合业务约定。

layout := "2006-01-02 15:04:05"
local, err := time.ParseInLocation(layout, "2024-03-31 09:00:00", loc)
if err != nil {
    // 输入错误要返回，不要把零值时间当成有效日期。
    return err
}

utc := local.UTC()
fmt.Println(local.IsDST(), utc.Format(time.RFC3339))

展示给用户时可以用 t.In(loc) 切换显示地点，但它不改变时间瞬间。比较两个值是否代表同一时刻，使用 t.Equal(other)；不要用 == 代替业务判断，因为 == 还会比较 Location 和单调时钟读数。

常见问题

为什么不直接使用 time.FixedZone？

固定偏移适合明确不会变化的协议偏移，但无法表达地区的历史和未来夏令时规则。需要跟随地区规则时使用 LoadLocation。

AddDate 后 Sub 为什么不是 24 小时？

因为 Sub 计算的是两个时间瞬间的差值，而 AddDate 保持的是本地日历字段；夏令时切换日可能只有 23 小时或有 25 小时。

日期范围的结束时间应该写到当天 23:59 吗？

不建议。把结束点写成下一日零点并使用小于判断，可以覆盖任意精度的事件，也能避开纳秒精度和时区转换误差。

如何核对某个时间是否处于夏令时？

在 Location 正确的前提下调用 t.IsDST()。它适合解释当前值，不应拿来代替日期边界或业务时区选择。

需要更新规则时，优先查看 Go time 包文档中的 LoadLocation、ParseInLocation 和 AddDate 说明，并确认部署环境包含所需的 IANA 时区数据。