输入约定已经写清楚:2026-11-22 09:00:00 是上海当地的九点,字符串里却没有时区。按常见写法先 time.Parse,再 .In 转到 Asia/Shanghai,打印出来却是下午五点。日期还是 22 号,钟点偏了八小时。如果只看转到上海之后的字符串,很容易以为是显示层的问题。要找出时间在哪一步偏了,可以把 RFC3339 和 UTC 一起打印出来:
package main
import (
"fmt"
"time"
)
func main() {
raw := "2026-11-22 09:00:00"
t, err := time.Parse("2006-01-02 15:04:05", raw)
if err != nil {
fmt.Println(err)
return
}
loc, err := time.LoadLocation("Asia/Shanghai")
if err != nil {
fmt.Println(err)
return
}
fmt.Println(t.Format(time.RFC3339))
fmt.Println(t.UTC().Format(time.RFC3339))
fmt.Println(t.In(loc).Format(time.RFC3339))
}
在本机 Go go1.27.3(linux/amd64)上,前两行都是 2026-11-22T09:00:00Z,第三行是 2026-11-22T17:00:00+08:00。t.Location() 给出的是 UTC。把 .In(loc) 前后的值做 Equal,结果为真:还是同一个瞬间,只是显示位置换成了上海。看起来像少减了八小时,可这个差额只对应文中 2026-11-22 这份上海样本的显示结果。拿它去改时间值,遇到别的国家或历史日期,补偿量并不是固定的八小时。
time 包文档 里,Parse 对没有时区标志的输入会得到 UTC 时间。Time.In 的说明则是:返回同一瞬间的副本,并把位置信息改成传入的 Location,供显示使用。它不会把已经按 UTC 读进来的九点,重新理解成上海的九点。给一段没有时区的文本选定来源时区,和把已经解析好的时刻换个时区去显示,是两件不同的事。文档里还有按偏移去匹配本地时区的分支,那是输入已经带了时区信息时的事,不要套到这条没有时区的样本上。
这里不该先 Parse、再 .In 来把时间改回上海九点,也不要手工减八小时。只有在输入契约已经明确这是上海当地钟点、而且字符串本身不带时区时,才在解析前加载 Asia/Shanghai,用 ParseInLocation,并把错误传回去。下面这个函数只接收已经确认属于上海当地时间的字符串,它不会自动猜测来源时区:
package main
import (
"fmt"
"time"
)
func parseShanghai(raw string) (time.Time, error) {
loc, err := time.LoadLocation("Asia/Shanghai")
if err != nil {
return time.Time{}, err
}
return time.ParseInLocation("2006-01-02 15:04:05", raw, loc)
}
func main() {
t, err := parseShanghai("2026-11-22 09:00:00")
if err != nil {
fmt.Println(err)
return
}
fmt.Println(t.Format(time.RFC3339))
fmt.Println(t.UTC().Format(time.RFC3339))
}
同一段输入,这样解析后的 RFC3339 是 2026-11-22T09:00:00+08:00,对应的 UTC 是 2026-11-22T01:00:00Z。当地钟点仍是上午九点,这个瞬间和刚才那条错误路径已经不是同一时刻。LoadLocation 找不到对应名称时会返回错误,要把错误返回去,不要改成 time.Local,也不要忽略加载失败的错误。加载失败时不要继续拿空的 Location 去调用 .In,文档写明 loc 为 nil 时 In 会 panic。测试环境里有时区数据库,不代表所有精简运行镜像都有。失败时按官方说明核对该名称和数据库来源即可。
如果字符串本身已经带了偏移,就按它自带的信息解析,不要再套一层纠偏。2026-11-22T09:00:00+08:00 用 RFC3339 直接 Parse,和上面的 parseShanghai 结果做 Equal,两者标识同一瞬间。另一条 2026-11-22T09:00:00Z 解析后是 2026-11-22T09:00:00Z,它和前面那次无时区 Parse 的结果 Equal,却不等于上海当地九点那条。字符串已经声明自己是 UTC 九点,就不要再按上海当地九点去改。
非法日期也应当返回错误。2026-02-30 09:00:00 交给 parseShanghai 会失败,错误里是 day out of range。LoadLocation("not/a-real-zone") 则是 unknown time zone,不会悄悄换成本地时区。用这些合成日期在 TZ=UTC 和 TZ=America/New_York 下各跑一遍,上面这些结果一致,不依赖进程默认时区来决定输入的业务含义。
系统时钟没对准,或者工作流按别的时区排队,是另一类问题,可以看 本机时钟校准 和 定时任务的调度时区。本题的问题出在无时区字符串被 Parse 解释成 UTC,不是去改机器钟,也不是去改调度器。
time 包文档 页面的 Version 标为 go1.27.4。这是滚动文档的版本,本机实跑的是 go1.27.3,两者要分开,也不能把页面版本当成这些函数的最低支持版本。