如何使用Golang格式化日期时间_Golang time Format与Parse方法解析

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

Go语言中格式化和解析时间,核心是 time.Formattime.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"))     // 2025-05-20 14:30:45
fmt.Println(now.Format("2006/01/02"))              // 2025/05/20
fmt.Println(now.Format("Jan 2, 2006 at 3:04pm"))   // May 20, 2025 at 2:30pm
fmt.Println(now.Format("2006-01-02T15:04:05Z07:00")) // ISO8601 带时区

⚠️ 注意:Format 不会自动处理时区转换,输出的是该 time.Time 值在其原始时区下的表示。如需转为 UTC 或其他时区,先用 t.In(loc) 切换位置再 Format。

time.Parse:把字符串转成 time.Time

调用 time.Parse(layout, value),layout 必须与 value 的结构严格匹配:

s := "2025-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) // 2025-05-20 14:30:45 +0000 UTC(默认解析为本地时区,除非 layout 含时区)

✅ 推荐做法:在 layout 中显式包含时区信息,避免歧义:

  • "2006-01-02 15:04:05 -0700" 解析带偏移的时间,如 "2025-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" 却传入 "2025-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 就不再神秘——它不是语法糖,而是一套明确、一致、无歧义的设计。