Go time包易出错:格式必须为2006-01-02 15:04:05;time.Now()返回带时区的time.Time;字符串解析须用ParseInLocation并指定时区;Parse失败返回零值需检查错误;Unix纳秒参数非毫秒,推荐用UnixMilli等方法。

Go 的 time 包不是“用起来就顺”的那种——格式字符串必须是 2006-01-02 15:04:05,时区不显式指定就默认本地,Parse 失败不报错而是返回零值时间加错误,这些都容易在上线后突然暴露。
time.Now() 返回的是带时区的 time.Time,不是“当前秒数”
很多人以为 time.Now() 就是获取一个“纯时间点”,其实它返回的 time.Time 值里已经绑定了 loc *Location 字段(比如 time.Local 或 time.UTC)。这个时区信息会直接影响后续所有操作:
- 调用
Format()时,输出的是该时区下的本地表示(例如2026-05-22 16:09:00是北京时间,但 UTC 是08:09:00) - 调用
Unix()得到的是 UTC 秒数,和时区无关;但Hour()/Minute()等方法返回的是该时区下的值 - 跨时区比较或转换前,务必确认两个
time.Time是否在同一个Location下,否则t1.Before(t2)可能逻辑正确但语义错乱
字符串转 time.Time 必须用 time.ParseInLocation,别信 time.Parse
time.Parse(layout, s) 默认使用 time.UTC 作为解析时区。如果你传入 "2026-05-22 16:09:00" 这种无时区标识的字符串,它会被当成 UTC 时间解析——而你本意很可能是“按本地时间理解”。结果就是:解析出来的 time.Time 值比你预期早/晚了若干小时。
- 正确做法是明确指定目标时区:
time.ParseInLocation("2006-01-02 15:04:05", s, time.Local) - 如果输入字符串自带时区(如
"2026-05-22T16:09:00+08:00"),可用time.Parse,但 layout 中必须包含时区字段(如"2006-01-02T15:04:05Z07:00") - 永远检查错误:
if err != nil { /* 不要忽略 */ },time.Parse*失败时返回的time.Time是零值(1年1月1日),极易引发下游空指针或逻辑异常
Format 的 layout 不是占位符,是“锚点时间”的镜像
Go 强制用 "2006-01-02 15:04:05" 作为 layout 模板,是因为它对应 Go 诞生时间(2006-01-02 15:04:05 MST)——这不是约定俗成,而是硬编码匹配。你改数字、换顺序都会导致解析错位。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
立即学习“go语言免费学习笔记(深入)”;
-
"2006/01/02"合法,"2026/01/02"非法(年份必须是 2006) -
"02/01/2006"表示“日/月/年”,不是“月/日/年”——layout 中的数字位置决定含义,不是文字含义 - 12 小时制要用
"03:04:05 PM",其中03是小时占位,PM是字面量,不能写成"12:04:05 PM" - 需要补零输出?用
01(月)、02(日)、15(24 小时)等;不需要补零?用1、2、3——但 layout 字符串本身仍得是"2006-1-2 15:4:5"这种形式
time.Unix(sec, nsec) 的纳秒参数不是“毫秒”或“微秒”
time.Unix(sec, nsec) 的第二个参数是**纳秒部分**,不是毫秒。常见误用是把毫秒时间戳直接传进去:
- 错误:
time.Unix(1747929540, 123)—— 把毫秒当纳秒,实际加了 123 纳秒,不是 123 毫秒 - 正确转毫秒时间戳:
time.Unix(1747929540, 123*1e6)(乘以 10⁶) - 更安全的方式是用专用方法:
time.UnixMilli(1747929540123)(Go 1.17+),或time.UnixMicro(1747929540123000)(Go 1.19+) - 注意:
UnixMilli等方法返回的time.Time默认使用time.UTC时区,若需本地时区,再调用.In(time.Local)
最常被跳过的细节是:所有时间运算(Add、Sub、Before)都基于纳秒精度,但显示和序列化时区依赖 Location。一旦你忘了 In(loc) 或用了错误的 ParseInLocation,时间就悄悄偏移了——而这种 bug 在日志里看不出,只在跨时区服务交互时爆发。

















