Go 时间做 JSON 往返后为什么丢失单调时钟信息

Go 时间做 JSON 往返后，丢失的是 time.Time 里只对当前进程有意义的单调时钟读数，不是日期、时分秒或时区偏移。time.Now() 得到的值可以同时参与墙上时间展示和本地耗时计算；MarshalJSON 只输出可跨进程解释的时间表示，UnmarshalJSON 重新得到的值自然没有原来的 monotonic 部分。

Go 的 time.Time 为什么看起来同时有两种时间

time.Now() 返回的 Time 可能含有墙上时间和单调时钟。前者会受系统校时影响，适合日志、订单发生时间和过期时间展示；后者只在当前进程的时间线上有意义，适合 Sub、Since、Until 等耗时运算。打印 Time.String() 时看到的 m=+... 是调试痕迹，不是可以写入接口的字段。

JSON 往返保留了什么，又为什么不会保留 monotonic

time.Time 的 JSON 方法使用 RFC3339 语义表达时间点。这个字符串可以被另一台机器、另一个进程或不同语言解析，但单调读数依赖创建它的进程时钟基准，离开该进程后没有可比对象。因此 Go 官方文档明确规定，MarshalJSON、MarshalText 等序列化形式省略单调读数，UnmarshalJSON 得到的时间也不含它。

package main

import (
    "encoding/json"
    "fmt"
    "time"
)

func main() {
    original := time.Now()
    data, err := json.Marshal(original)
    if err != nil {
        panic(err) // 序列化失败时停止，避免把不完整时间写入接口。
    }

    var roundTrip time.Time
    if err := json.Unmarshal(data, &roundTrip); err != nil {
        panic(err) // 解析失败时不能继续比较时间结果。
    }

    fmt.Println(string(data))
    fmt.Println(original.Equal(roundTrip)) // 比较时间点，不要求内部单调状态相同。
}

这里即使两个值代表同一时间点，也不要用 original == roundTrip 推断 JSON 失败。== 还会比较位置和单调读数；业务上的时间点判断应优先使用 Equal，而且应先明确是否需要保留原始时区名称。

持久化时间和本地耗时要分开设计

事件发生时间应按协议需要保存为 RFC3339、Unix 秒或 Unix 纳秒，并明确精度和时区。性能统计、超时计算则应在同一进程里从开始时刻到结束时刻直接调用 Sub；如果结果要发给另一个服务，发送已经算出的 Duration 数值，而不是试图把单调读数塞回 JSON。

type EventDTO struct {
    OccurredAt time.Time `json:"occurred_at"`
    ElapsedNS  int64     `json:"elapsed_ns,omitempty"`
}

func measure() EventDTO {
    started := time.Now()
    // 这里代表当前进程内的业务操作，耗时只在本地计算。
    doWork()
    elapsed := time.Since(started)
    return EventDTO{
        OccurredAt: time.Now().UTC(),
        ElapsedNS:  elapsed.Nanoseconds(), // 显式传结果，不传内部 monotonic 状态。
    }
}

如果字段代表截止时间而不是发生时间，接收端应使用自己的 time.Now() 与解析后的墙上时间比较，并为网络延迟、时钟偏差设置边界。不要把序列化前后的 Sub 结果当成跨服务精确计时。

比较、时区和系统睡眠的排查清单

需要去掉本地单调信息、只保留墙上时间时，可以使用官方文档推荐的 t.Round(0)。UTC、Local、In 等改变时间解释的操作也会去掉单调读数，但它们不等于修复业务时区。另一个边界是系统睡眠：部分系统在睡眠期间会暂停单调时钟，此时用它表示真实经过的日历时间可能不准确。

• 要比较同一进程里的两个采样点：优先 Sub、Since、Before 等语义明确的方法。
• 要判断两个业务时间点是否相同：使用 Equal，不要依赖 ==。
• 要写入 JSON、数据库或消息队列：明确使用 UTC、RFC3339 或 Unix，并记录精度。
• 要计算跨进程耗时：传已经计算出的整数 Duration，并说明单位。

相关问题

JSON 能不能恢复原来的单调时钟信息

不能。JSON 只保存可移植的墙上时间表示；如果需要耗时，发送端必须在本地计算后额外传输结果。

为什么打印 time.Now 会看到 m=+ 数字

这是 String 为调试而显示的进程内单调读数，不是 RFC3339 的一部分，也不会被 JSON 方法编码。

Round(0) 会不会改变日期时间

它会去掉单调读数，但保留墙上时间的时刻值；使用前仍要确认你的比较语义和时区要求。