Go语言time包以固定参考时间“2006-01-02 15:04:05 MST”为layout格式化时间,解析需用ParseInLocation显式指定时区,时间差用Sub得Duration,时区统一用UTC可避免线上bug。
Go 语言的 time 包是处理时间最核心、最可靠的工具。它不依赖系统时区配置(默认使用本地时区,但可显式控制),所有操作都是值类型、线程安全,且设计清晰。掌握格式化、解析和时间差计算,基本覆盖日常开发中 90% 的时间需求。
Go 不用 YYYY-MM-dd HH:mm:ss 这类常见模板,而是采用一个**具体的参考时间**作为 layout 字符串:"2006-01-02 15:04:05 MST"(即 Unix 时间元年 + 一秒)。这个时间每个字段都有明确含义,必须严格匹配。
常见格式示例:
t.Format("2006-01-02") → "2025-05-20"
t.Format("2006/01/02 15:04") → "2025/05/20 14:30"
t.Format("Jan 2, 2006 at 3:04pm") → "May 20, 2025 at 2:30pm"
t.In(time.UTC).Format("2006-01-02T15:04:05Z")
⚠️ 注意:月份是 01(不是 MM),小时是 24 小时制的 15(不是 HH),否则会输出错误内容(比如把 MM 当成“分钟”解析)。
time.Parse 是唯一入口,它需要 layout 字符串、待解析的字符串、以及隐含的时区信息(layout 中的 MST 仅作占位,不参与时区解析;实际时区由 time.Now().Location() 或显式传入决定)。
推荐做法是始终显式指定时区,避免本地时区干扰:
t, err := time.ParseInLocation("2006-01-02", "2025-05-20", time.UTC)t, err := time.ParseInLocation(time.RFC3339, "2025-05-20T14:30:00+08:00", time.Local)如果输入可能含多种格式,可依次尝试多个 ParseInLocation,直到成功(err == nil)。
两个 time.Time 相减得到 time.Duration(纳秒精度的 int64),非常直观:
diff := t2.Sub(t1) → 正数表示 t2 在 t1 之后diff.Hours()、diff.Minutes()、diff.Seconds() 返回 float64int64(diff / time.Second) 获取整秒数(推荐用 diff.Round(time.Second).Seconds() 避免浮点误差)if time.Since(lastUpdate) > 5*time.Minute { ... }
注意:Duration 是绝对值,不带方向;比较大小可用 >/,但别用 == 判断相等(纳秒级精度下极难命中)。
时区是关键:未显式指定时区的解析(如只用 time.Parse)会使用 time.Local,线上服务器常因时区设置不一致导致 bug。生产环境建议统一用 UTC 存储和传输,展示时再转本地。
零值陷阱:time.Time{} 是 0001-01-01 00:00:00 +0000 UTC,不是 nil;判空应写 t.IsZero()。
JSON 序列化:结构体中嵌入 time.Time 默认按 RFC3339 输出(如
"2025-05-20T14:30:00+08:00");若需自定义格式,可实现 MarshalJSON 方法。
定时任务:用 time.Ticker 或 time.AfterFunc,别用循环 + time.Sleep —— 后者无法响应中断且不精确。