京公网安备11010502063487号时间相关的 bug 多半出在时区和夏令时上。这篇用真实运行验证几个典型问题:跨夏令时加一天、不存在和重复的时刻、字符串解析时的时区、LoadLocation 的代价,以及最容易在上线时才发现的:容器里没有时区数据库。
纽约 2026-03-07 12:00 (春季跳时前一天)+ Add(24h) = 2026-03-08 13:00 EDT;AddDate(0,0,1) = 2026-03-08 12:00 EDT 两者相差 -1h0m0s 不存在的时刻 time.Date(2026,3,8,2,30,…,纽约)(当天 2:00 直接跳到 3:00):得到 2026-03-08 01:30 EST -0500 重复出现的时刻 time.Date(2026,11,1,1,30,…,纽约)(当天 1:30 出现两次):得到 2026-11-01 01:30 EDT -0400 纽约 3 月 8 日这一天(跳时日)有 23 小时 纽约 11 月 1 日这一天(回拨日)有 25 小时
纽约 3 月 7 日 12:00 加 24 小时到了 3 月 8 日 13:00 EDT,而 AddDate(0,0,1) 是 12:00 EDT,差一个小时。跳时那天只有 23 小时,回拨那天有 25 小时。要“明天同一时刻”用 AddDate。
time.Parse(无时区的字符串):2026-06-01T12:00:00Z;ParseInLocation(…, 上海):2026-06-01T12:00:00+08:00;两者相差 8h0m0s time.Parse(…, "… EST"):err=<nil>,区名 "EST",偏移 0 秒(没有系统认识 EST 时,偏移为 0,不是 −5 小时) time.ParseInLocation(…, "… EST", 纽约):区名 "EDT",偏移 -14400 秒(字符串里写的 EST 没有生效,按位置 6 月的实际规则得到 EDT) layout "2006-1-2" 解析 "2026-06-01":err=<nil>
3 月 8 日 2:30 并不存在,time.Date 得到 01:30 EST;11 月 1 日 1:30 出现两次,得到的是先出现的 EDT。文档本来就说这种情况下选哪个时区“不保证”,不要依赖。
time.LoadLocation("Asia/Shanghai") 17498 ns/次(10 次分配);t.In(已加载的位置) 0 ns/次;t.Format(RFC3339) 34 ns/次time.Parse 对不带时区的字符串按 UTC,ParseInLocation 才按指定位置;带 EST 这类缩写时,Parse 并不会把它换算成 −5 小时(偏移 0 秒)。解析业务时间时优先用 ParseInLocation,最好用带数字偏移的 RFC3339。
TZ="":time.Local = UTC;现在 05:57 UTC +0000 TZ="UTC":time.Local = UTC;现在 05:57 UTC +0000 TZ="Asia/Shanghai":time.Local = Asia/Shanghai;现在 13:57 CST +0800 TZ="America/New_York":time.Local = America/New_York;现在 01:57 EDT -0400
每次 LoadLocation 约 17498 ns、10 次分配;加载后 t.In 不要钱。启动时加载一次。
二进制大小:不带 tzdata 2.86 MB;加 -tags timetzdata 3.25 MB(多 381 KiB)
[普通编译] time.LoadLocation("Asia/Shanghai") 失败:unknown time zone Asia/Shanghai
[-tags timetzdata] time.LoadLocation("Asia/Shanghai") 成功:20:00 CST +0800环境变量 TZ 为空串或 UTC 时 time.Local 是 UTC,设成地区名则按该地区。同一份程序在不同机器、不同容器里 Local 可能不同。
LoadLocation returns a Location with the given name. If the name is "" or "UTC", LoadLocation returns UTC. If the name is "Local", LoadLocation returns Local. Otherwise, a new Location is created where the name is taken to be a location name corresponding to a file in the IANA Time Zone database, such as "America/New_York". LoadLocation looks for the IANA Time Zone database in the following locations in order: - the directory or uncompressed zip file named by the ZONEINFO environment variable - on a Unix system, the system standard installation location - $GOROOT/lib/time/zoneinfo.zip - the time/tzdata package, if it was imported
没有 /usr/share/zoneinfo 的最小镜像里,LoadLocation("Asia/Shanghai") 报 unknown time zone;编译时加 -tags timetzdata(或导入 time/tzdata)把数据库嵌进二进制,多 381 KiB。文档里的查找顺序也包括 $GOROOT/lib/time/zoneinfo.zip 与 ZONEINFO 环境变量。