当前位置：首页 > 文章列表 > Golang > Go教程 > GolangJSON时间格式化设置教程

GolangJSON时间格式化设置教程

2026-02-19 11:08:52 0浏览收藏

Go语言中json.Marshal默认将time.Time序列化为纳秒级RFC3339格式（如"2024-05-20T14:23:18.123456789+08:00"），虽保证可逆性但常导致前端解析失败、数据库报错、日志冗长及跨语言对接不一致等问题；标准库不支持`time_format`等struct tag，强行预转字符串或手动Format会破坏类型安全与反序列化能力；最可靠、可控且符合Go设计哲学的方案是定义嵌入time.Time的自定义类型（如JSONTime），实现json.Marshaler和json.Unmarshaler接口，精准控制输出格式（如"2006-01-02 15:04:05"）并妥善处理时区与解析逻辑——既复用原生能力，又避免全局污染，兼顾清晰性、安全性和协作兼容性。

Golang Encoding/Json自定义时间格式化_解决Time默认输出格式

Go json.Marshal 输出时间不是 RFC3339？

默认情况下，json.Marshal 会把 time.Time 序列化成带纳秒精度的 RFC3339 字符串（如 "2024-05-20T14:23:18.123456789+08:00"），但多数 API 不需要纳秒、也不想要时区偏移里的冒号。这不是 bug，是 Go 的设计选择——它优先保证可逆性，而非“好看”。

常见错误现象：
前端解析失败、数据库入库报错、日志里时间字段太长难读、和 Python/Java 服务对接时格式不一致。

别试图用 fmt.Sprintf 预先转成字符串再塞进 struct —— 这会让反序列化失效，且破坏类型安全
别在每次 Marshal 前手动调用 .Format() —— 失去结构体统一控制，容易漏改
真正该做的是让 time.Time 自己知道怎么序列化

自定义 Time 类型实现 json.Marshaler 接口

最稳妥的做法是定义一个新类型，嵌入 time.Time，然后实现 MarshalJSON() 和 UnmarshalJSON()。这样既复用原生能力，又完全掌控序列化行为。

典型使用场景：API 响应中的 created_at、updated_at 字段必须为 "2006-01-02 15:04:05" 格式（MySQL 默认 datetime 格式）。

示例：

type JSONTime time.Time
<p>func (t JSONTime) MarshalJSON() ([]byte, error) {
st := time.Time(t).Format("2006-01-02 15:04:05")
return []byte(<code>"</code> + st + <code>"</code>), nil
}</p><p>func (t <em>JSONTime) UnmarshalJSON(data []byte) error {
s := strings.Trim(string(data), <code>"</code>)
tt, err := time.Parse("2006-01-02 15:04:05", s)
if err != nil {
return err
}
</em>t = JSONTime(tt)
return nil
}</p>

注意：UnmarshalJSON 必须是指针接收者，否则修改不了原值
格式字符串必须是 Go 的固定基准时间 "2006-01-02 15:04:05"，写错会 panic
如果要支持 UTC 或固定时区，time.Time(t).In(time.UTC).Format(...) 更安全

struct tag 里加 time_format 不起作用？

Go 原生 encoding/json **不识别** time_format 这类 tag（那是 github.com/goccy/go-json 或某些 ORM 才支持的）。写 json:"created_at,time_format:\"2006-01-02\"" 完全无效，字段照样按默认 RFC3339 输出。

容易踩的坑：