Go time.Time JSON 输出为什么带有时区和纳秒

给结构体里的 time.Time 直接调用 json.Marshal，看到的通常不是 Unix 时间戳，而是类似 "2026-09-07T18:30:12.123456789+08:00" 的字符串。这不是 encoding/json 随机拼接的结果：time.Time 实现了 MarshalJSON，默认按 RFC 3339 输出，并在存在子秒时保留精度。

因此，时区来自 Time 当前的数值偏移，纳秒来自值本身的子秒部分。接口若不需要纳秒，应在序列化边界用 time.RFC3339 明确格式化；不要在 JSON 字符串上直接截字符。

先用一个例子看懂默认 JSON

下面的时间刻意设置了固定偏移和纳秒部分，便于观察默认行为。json.Marshal 会发现 time.Time 的 MarshalJSON 方法，并把它编码成 JSON 字符串。

package main

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

func main() {
	zone := time.FixedZone("业务时区", 8*60*60) // 只用于构造 +08:00 偏移
	t := time.Date(2026, 9, 7, 18, 30, 12, 123456789, zone)

	b, err := json.Marshal(t)
	if err != nil {
		panic(err) // 时间超出 RFC3339 可表示范围时应让错误可见
	}
	fmt.Println(string(b)) // 输出带引号的 RFC3339 时间字符串
}

典型结果是 "2026-09-07T18:30:12.123456789+08:00"。如果纳秒值为零，子秒部分不会凭空出现；如果时间使用 UTC，偏移通常写成 Z。所以“为什么带纳秒”的答案是：原始 time.Time 里确实有纳秒字段，而默认方法选择保留子秒精度。

时区输出的是偏移，不是 Location 名称

time.Location 主要影响显示和日历换算。JSON 默认保存的是当时的数值偏移，例如 +08:00，不会把 Asia/Shanghai 或 业务时区 这样的名称一起写进去。把同一个瞬间转换到 UTC 与东八区，两个字符串可能不同，但它们表示的时间点相同。

这也解释了一个常见误判：反序列化后不要通过 Location().String() 判断原来的时区名称仍然存在。若业务需要“按上海规则重新计算夏令时或日期”，应在应用边界明确加载目标 Location；若只需要传输一个可比较的时间点，统一使用 UTC 往往更简单。

type Event struct {
	At time.Time `json:"at"` // 直接使用默认 RFC3339 序列化
}

func normalizeUTC(e Event) Event {
	e.At = e.At.UTC() // 统一传输视图，不改变它代表的瞬间
	return e
}

接口不想要纳秒时，用 Format 明确控制

“去掉纳秒”不是把 ".123456789+08:00" 从 JSON 文本里切掉，而是让时间值按照目标布局重新格式化。time.RFC3339 不包含子秒；time.RFC3339Nano 则允许纳秒，并会去掉末尾多余的零。

type APIEvent struct {
	At string `json:"at"` // API 契约固定为秒级 RFC3339
}

func newAPIEvent(t time.Time) APIEvent {
	return APIEvent{
		At: t.UTC().Format(time.RFC3339), // 先统一 UTC，再按秒输出
	}
}

如果客户端需要纳秒，可以改用 t.UTC().Format(time.RFC3339Nano)。但要注意，RFC3339Nano 为了短一些会去掉小数末尾的零，因此格式化后的字符串长度不固定，也不适合直接当作字典序时间排序依据。需要固定宽度时，应该约定固定 9 位小数的布局并评估客户端兼容性。

把格式规则写进序列化边界

选择格式时，可以先回答三个问题：客户端是否需要纳秒？是否允许不同偏移？是否必须保留地点规则？下面的清单适合放进接口评审或测试用例。

输入侧则保留 json.Unmarshal 的错误：time.Time 需要读取符合 RFC3339 的带引号字符串，客户端传入本地化日期或未约定的空字符串时，应返回可定位的参数错误。零时间也不是“自动为空”，如果业务要表达缺省值，优先使用指针或单独的可选字段规则。

常见问题

为什么 UTC 输出是 Z，东八区却是 +08:00？

RFC3339 用 Z 表示 UTC，非零时区使用数值偏移。两种写法都表达偏移信息，不是 JSON 在猜测机器所在地。

能不能用字符串切片去掉纳秒？

不建议。切片容易误伤时区部分和不同长度的小数，应该调用 Format(time.RFC3339) 重新生成目标格式。

time.RFC3339Nano 适合直接排序吗？

不适合把格式化字符串当作通用排序键。它会去掉末尾零，导致同一字段的文本长度不固定；排序应解析成时间，或使用固定格式的数值键。

默认语义可查阅 Go time.Time 的 MarshalJSON 文档 与 time 包格式常量。接口文档中把时区、精度和缺省值写清楚，通常比在客户端反复兼容更省事。