Go time.Time.Round 为什么会改变日期：单调时钟、时区与序列化边界

把订单时间按小时归档时，最容易踩的坑不是格式化，而是把“屏幕上看到的本地时间”误当成了 time.Time.Round 的计算基准。Round 按时间点相对于零时刻的绝对距离取整，结果可能跨过本地日期；而 Round(0) 还有一个常被忽略的作用：剥离单调时钟读数。

Round(d) 不是“把显示出来的分钟四舍五入”。需要按本地日历边界归档时先明确业务时区；需要做稳定比较或作为键时，再统一 Location 并用 Round(0) 清理单调时钟。

先把 Round 的“零点”找出来

下面的示例刻意使用带固定偏移的时区。它把同一个时间点显示成前一天晚上，方便观察“显示日期”和“绝对取整”不是一回事。

package main

import (
    "fmt"
    "time"
)

func main() {
    loc := time.FixedZone("UTC-11", -11*60*60)
    t := time.Date(2026, 8, 27, 23, 40, 0, 0, loc)

    fmt.Println("t     =", t)
    fmt.Println("Round =", t.Round(24*time.Hour))
    fmt.Println("Trunc =", t.Truncate(24*time.Hour))
}

这里的 Round 把时间点映射到从 Go 的零时间开始计算的 24 小时倍数，而不是把 23:40 先变成“当天第 23 小时”再取整。Truncate 也采用绝对时间基准，只是向零时间方向截断。两者都可能得到读者直觉之外的本地日期。

为什么换了 Location，结果看起来又不一样

Location 不会改变时间点，只改变解释它的时区。可以先把同一个 instant 转到 UTC，再分别查看取整结果：

utc := t.UTC()
local := utc.In(loc)

fmt.Println(utc.Equal(local)) // true：是同一个时间点
fmt.Println(utc == local)     // false：Location 可能不同
fmt.Println(local.Round(time.Hour))

Equal 比较的是时间点；== 还会比较 Location 和单调时钟读数。于是“日志里打印相同”并不代表两个值适合直接做键。这个结果先别下结论：如果业务要按北京时间的自然日分组，不能用 Round(24*time.Hour) 代替日历运算，应先在目标 Location 中取出年月日，或者明确使用业务定义的日界线。

Round(0) 清理的不是时区，而是单调时钟

由 time.Now() 得到的值可能同时包含墙上时间和当前进程的单调时钟读数。单调读数适合计算经过时长，却不应该跟着时间值进入稳定键或跨进程序列化比较。

started := time.Now()
clean := started.Round(0)

fmt.Println(started.Equal(clean)) // true
fmt.Println(started == clean)     // 通常为 false：单调读数被清理

encoded, err := started.MarshalJSON()
if err != nil {
    panic(err)
}
fmt.Println(string(encoded))

Round(0) 保留墙上时间和 Location，只去掉单调时钟部分。JSON、文本或二进制序列化本身也不会保留进程内的单调读数，所以从序列化前后的值做 == 比较，经常会得到意外的 false；判断是否代表同一个 instant，应使用 Equal。

按业务边界选择 Round、Truncate 还是日历运算

常见问题：时间取整的几个边界

Round 和 Truncate 哪个更适合整点分桶？

需要“最近的桶”时用 Round，需要“当前时间之前的桶”时用 Truncate。先写清桶的绝对起点和时区，否则两种写法都可能与产品定义不一致。

Round(0) 会把时间转成 UTC 吗？

不会。它只剥离单调时钟读数；若要统一时区，要显式调用 UTC、Local 或 In。

为什么两个打印结果一样，== 还是 false？

打印通常只展示墙上时间；== 还考虑 Location 和单调时钟读数。比较时间点用 Equal，比较稳定结构前先统一 Location 并清理单调读数。

把检查动作留在代码里

时间相关测试至少覆盖跨日期、非 UTC Location、Round(0)、JSON 往返和 Equal。尤其不要只断言格式化字符串；那只能证明显示结果，不能证明时间点、时区元数据和比较语义都符合业务边界。