Go time.Time Round 后为什么保留或丢失单调时钟

time.Now() 返回的 time.Time 可能同时带有墙上时钟和当前进程的单调时钟。Round 只要被调用，结果就会进入“墙上时间计算”路径，单调读数会被剥离；所以不是“Round(0) 会丢、Round(1秒) 会留”，而是所有 Round(d) 都会清理它。要测耗时，保留原始 time.Now()；要得到可比较、可序列化的业务时间，显式使用 Round(0) 或格式化结果。

一、先看 Round 为什么会拿掉单调时钟

Go 的设计把“报时”和“计时”放在同一个 Time 值里：墙上时钟用于日期展示，单调时钟用于进程内的比较和相减。官方 time 包把 Add 视为同时推进两种读数，但把 AddDate、Round、Truncate 视为墙上时间计算，因此返回值不再携带单调读数。

源码中的关键动作就是先执行 stripMono，再处理舍入余数。也就是说，Round 的核心不是“复制原值再改纳秒”，而是先把内部的单调部分转成墙上时间表示。下面这张图只表达字段和方法的静态关系，属于操作示意图。

now := time.Now()
rounded := now.Round(time.Second)
stripped := now.Round(0)

// Round 的参数只决定墙上时间如何舍入；无论参数是否为 0，结果都不保留 monotonic reading。
fmt.Println(now.String())
fmt.Println(rounded.String())
fmt.Println(stripped.String())

二、区分 Round(0)、Round(1*time.Second) 和时间展示

Round(0) 的特殊价值是“不改变墙上时间，只清理单调时钟”，因此它适合把进程内采样值转换成稳定的业务值。Round(time.Second) 则还会按“自零时刻以来的绝对时间”进行四舍五入，不是按本地显示的秒、分字段截断。官方文档也特别提醒，Round(time.Hour) 可能因为 Location 不同而得到非整点的显示结果。

不要用打印结果判断内部是否保留单调时钟。String 在存在单调读数时会显示 m=+ 调试字段，但 Format、JSON、文本和二进制序列化都不会保存它。一个值从 JSON 读回来后没有 monotonic reading，是预期行为，不是数据损坏。

三、比较和耗时场景应该怎么修

最常见的误修是为了“统一精度”把计时起点和终点都 Round(time.Millisecond)。这样确实统一了墙上时间，但同时丢掉了单调时钟，并引入舍入误差。计时应保留原值；只有要把时间放进业务对象、缓存键或跨进程协议时，才做显式清理。

四、用检查清单避免再次误判

• 看到 Round、Truncate、UTC、Local、In 后，默认检查 monotonic reading 是否已经被移除。
• 看到 == 时，确认两边 Location 是否一致；比较时间点通常改成 Equal。
• 跨进程或持久化后的时间不要期待保留单调时钟；它只属于原进程的 Time 值。
• 机器睡眠后如果实际经过时间与 Sub 不一致，结合系统行为判断是否需要先清理单调时钟。

相关问题

Round(0) 会改变时间戳吗？

不会改变墙上时间和 Location，只会移除单调时钟读数。

为什么 time.Now().String() 有 m=，JSON 没有？

m= 是调试输出；序列化格式有意忽略只在当前进程有意义的单调读数。

time.Time 可以直接用作 map 的 key 吗？

可以编译，但必须先保证 Location 一致并清理单调读数；多数业务判断更适合使用 Equal。