如何使用Golang time包处理时间_time时间格式化与解析_技术教程

Go time.Parse 报错根本原因是强制使用固定参考时间“Mon Jan 2 15:04:05 MST 2006”作布局模板，不支持yyyy-MM-dd等任意格式；必须严格匹配字段位置、大小写及时区标识，推荐优先使用time.RFC3339等内置常量。

Go time.Parse 为什么总是报 parsing time 错误

根本原因在于 Go 的时间解析不接受任意格式字符串，它强制使用固定参考时间 "Mon Jan 2 15:04:05 MST 2006"（即 Unix 时间戳 0 的人类可读表示）作为布局模板。你写的 "2006-01-02 15:04:05" 是对的，但写成 "yyyy-MM-dd HH:mm:ss" 或 "%Y-%m-%d %H:%M:%S" 就会直接 panic。

错误示例：

time.Parse("yyyy-MM-dd HH:mm:ss", "2025-01-01 12:00:00") // panic: parsing time

正确写法必须严格对应参考时间各字段的位置和大小写：
```
time.Parse("2006-01-02 15:04:05", "2025-01-01 12:00:00") // ✅
```
时区容易被忽略：字符串不含时区信息时，默认按 Local 解析；含 Z 或 +0800 则需在 layout 中显式写 Z 或 -0700
年份用 2006（四位），不是 YYYY；小时用 15（24 小时制），不是 HH

time.Format 输出结果和预期不符怎么办

time.Format 的 layout 规则和 Parse 完全一致，只是方向相反。常见问题不是“不会写”，而是没注意默认时区或忽略了 layout 中空格/标点的字面匹配。

如果你调用 t.Format("2006-01-02 15:04:05") 却得到 UTC 时间，大概率是 t 本身是 UTC 时间（比如从 time.Now().UTC() 或 JSON 反序列化来的），而不是本地时区
layout 中所有非占位符字符（如 -、:、空格）都会原样输出，所以 "2006/01/02,15:04:05" 会输出 "2025/01/01,12:00:00"，逗号不会被忽略
毫秒要写 .000（对应参考时间的 .999999999 的前三位），微秒是 .000000，纳秒是 .000000000
星期几用 Monday 或 Mon，不能用 yyyy-MM-dd EEE —— Go 没有这种简写别名

处理带时区的时间字符串（如 RFC3339、ISO8601）

Go 内置了多个标准 layout 常量，比手写更安全。优先用 time.RFC3339、time.RFC3339Nano、time.ISO8601（Go 1.20+），而不是自己拼 "2006-01-02T15:04:05Z07:00"。

time.RFC3339 对应 "2006-01-02T15:04:05Z07:00"，能正确解析 "2025-01-01T12:00:00+08:00" 和 "2025-01-01T04:00:00Z"
time.RFC3339Nano 支持纳秒精度，如 "2025-01-01T12:00:00.123456789+08:00"
注意：time.ISO8601（Go 1.20 起）不带时区偏移，只支持 "2006-01-02" 这种日期，不是完整 ISO8601；完整带时区的 ISO8601 应仍用 RFC3339
解析失败时，err 通常包含具体不匹配位置，比如 parsing time "2025-01-01T12:00" as "2006-01-02T15:04:05Z07:00": cannot parse "" as "Z07:00"，说明缺时区

time.ParseInLocation 需要手动指定时区的典型场景

当输入字符串明确属于某个时区（如“北京时间 2025-01-01 12:00:00”），但字符串本身不带时区标识（如无 +0800），就必须用 time.ParseInLocation，否则 Go 会按本地时区或 UTC 解析，导致时间值错位。

正确做法：

loc, _ := time.LoadLocation("Asia/Shanghai")
t, _ := time.ParseInLocation("2006-01-02 15:04:05", "2025-01-01 12:00:00", l
oc)

不要用 time.FixedZone("CST", 8*60*60) 手动构造——CST 有歧义（美国中部？中国标准？），且 FixedZone 不处理夏令时
如果程序部署在海外服务器，但业务逻辑始终按东八区处理，就一定不能依赖 time.Parse + 环境时区，必须显式传 loc
time.LoadLocation 会查系统 tzdata，若容器镜像精简（如 alpine），可能缺失时区数据，需额外安装 tzdata 包