Go语言时间格式化与解析基于参考时间“Mon Jan 2 15:04:05 MST 2006”,time.Format将time.Time转字符串,time.Parse将字符串转time.Time,二者均需严格匹配该参考时间风格的layout,不可用yyyy-MM-dd等其他格式。

Go语言中格式化和解析时间,核心是 time.Format 和 time.Parse 方法,它们不使用常见的 yyyy-MM-dd HH:mm:ss 这类模板,而是基于 Go 的“参考时间”(Reference Time)——Mon Jan 2 15:04:05 MST 2006。这个固定时间点的每个字段都对应一个特定值,用它来定义格式模板。
为什么用 "Mon Jan 2 15:04:05 MST 2006"?
这是 Go 官方选定的“参考时间”,因为它的年月日时分秒时区全部非零且具代表性,且按美式习惯排列。Go 用这个时间的字面值作为格式占位符:
- 2006 → 年(4位)
- Jan → 英文缩写月份(如 Jan、Feb)
- Mon → 英文缩写星期(如 Mon、Tue)
- 2 → 日期(1–31,不补零)
- 02 → 日期(两位,补零)
- 15 → 小时(24小时制)
- 03 → 小时(12小时制)
- 04 → 分钟
- 05
- MST → 时区缩写(如 UTC、CST、PST;注意:不能直接解析“CST”这类歧义缩写,推荐用 ±0700)
- -0700 → 数字时区偏移(推荐用于 Parse)
time.Format:把 time.Time 转成字符串
调用 t.Format(layout),layout 是上面参考时间风格的字符串:
now := time.Now()
fmt.Println(now.Format("2006-01-02 15:04:05")) // 2024-05-20 14:30:45
fmt.Println(now.Format("2006/01/02")) // 2024/05/20
fmt.Println(now.Format("Jan 2, 2006 at 3:04pm")) // May 20, 2024 at 2:30pm
fmt.Println(now.Format("2006-01-02T15:04:05Z07:00")) // ISO8601 带时区
⚠️ 注意:Format 不会自动处理时区转换,输出的是该 time.Time 值在其原始时区下的表示。如需转为 UTC 或其他时区,先用 t.In(loc) 切换位置再 Format。
立即学习“go语言免费学习笔记(深入)”;
time.Parse:把字符串转成 time.Time
调用 time.Parse(layout, value),layout 必须与 value 的结构严格匹配:
s := "2024-05-20 14:30:45"
t, err := time.Parse("2006-01-02 15:04:05", s)
if err != nil {
log.Fatal(err)
}
fmt.Println(t) // 2024-05-20 14:30:45 +0000 UTC(默认解析为本地时区,除非 layout 含时区)
✅ 推荐做法:在 layout 中显式包含时区信息,避免歧义:
- 用
"2006-01-02 15:04:05 -0700"解析带偏移的时间,如"2024-05-20 14:30:45 +0800" - 用
"2006-01-02 15:04:05 MST"需确保 MST 是 Go 内置支持的时区名(如 UTC、PST、CET),但不推荐——很多缩写(如 CST、IST)有歧义 - 若输入无时区,默认按 本地时区 解析;如需强制 UTC,可后续调用
t.UTC()
常见坑与建议
❌ 错误:用 "yyyy-MM-dd" 或 "%Y-%m-%d" —— Go 不识别这些 C/Python 风格格式,会原样输出或 panic
❌ 错误:layout 中写 "01/02/2006" 却传入 "2024-05-20" —— 格式不匹配导致 Parse 失败
✅ 建议:
- 记牢参考时间:Mon Jan 2 15:04:05 MST 2006,它是唯一“模板”
- 优先使用带数字时区(
-0700)的 layout,更可靠 - 对用户输入时间,先 Normalize 时区(如统一转为 UTC),再存储或比较
- 用
time.RFC3339(即"2006-01-02T15:04:05Z07:00")处理 API 时间字段,它是标准且 Go 内置常量
基本上就这些。掌握参考时间模型,Format 和 Parse 就不再神秘——它不是语法糖,而是一套明确、一致、无歧义的设计。










