Go语言time包以固定参考时间“2006-01-02 15:04:05 MST”为layout格式化时间,解析需用ParseInLocation显式指定时区,时间差用Sub得Duration,时区统一用UTC可避免线上bug。

Go 语言的 time 包是处理时间最核心、最可靠的工具。它不依赖系统时区配置(默认使用本地时区,但可显式控制),所有操作都是值类型、线程安全,且设计清晰。掌握格式化、解析和时间差计算,基本覆盖日常开发中 90% 的时间需求。
格式化时间:用固定 layout 而不是惯用占位符
Go 不用 YYYY-MM-dd HH:mm:ss 这类常见模板,而是采用一个**具体的参考时间**作为 layout 字符串:"2006-01-02 15:04:05 MST"(即 Unix 时间元年 + 一秒)。这个时间每个字段都有明确含义,必须严格匹配。
常见格式示例:
-
t.Format("2006-01-02")→"2024-05-20" -
t.Format("2006/01/02 15:04")→"2024/05/20 14:30" -
t.Format("Jan 2, 2006 at 3:04pm")→"May 20, 2024 at 2:30pm" - 带时区:
t.In(time.UTC).Format("2006-01-02T15:04:05Z")
⚠️ 注意:月份是 01(不是 MM),小时是 24 小时制的 15(不是 HH),否则会输出错误内容(比如把 MM 当成“分钟”解析)。
立即学习“go语言免费学习笔记(深入)”;
解析字符串为时间:必须指定 layout 和时区
time.Parse 是唯一入口,它需要 layout 字符串、待解析的字符串、以及隐含的时区信息(layout 中的 MST 仅作占位,不参与时区解析;实际时区由 time.Now().Location() 或显式传入决定)。
推荐做法是始终显式指定时区,避免本地时区干扰:
t, err := time.ParseInLocation("2006-01-02", "2024-05-20", time.UTC)t, err := time.ParseInLocation(time.RFC3339, "2024-05-20T14:30:00+08:00", time.Local)
如果输入可能含多种格式,可依次尝试多个 ParseInLocation,直到成功(err == nil)。
计算时间差:直接用减法,结果是 Duration
两个 time.Time 相减得到 time.Duration(纳秒精度的 int64),非常直观:
-
diff := t2.Sub(t1)→ 正数表示t2在t1之后 -
diff.Hours()、diff.Minutes()、diff.Seconds()返回 float64 -
int64(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 输出(如 "2024-05-20T14:30:00+08:00");若需自定义格式,可实现 MarshalJSON 方法。
定时任务:用 time.Ticker 或 time.AfterFunc,别用循环 + time.Sleep —— 后者无法响应中断且不精确。










