Go 读取 OpenWRT 时区信息

Go 语言获取时间

如果需要获取当前时间,一般都会这么写:

package main

import (
    "fmt"
    "time"
)

func main() {
    fmt.Println(time.Now().Format("2006-01-02 15:04:05"))
}

在机器上运行,也确实可以得到诸如2020-09-07 16:07:28的时间,看上去并没有任何问题

但是如果在 OpenWRT 上运行,很可能会发现,输出的时间和实际时间并不相同,是当前时间的 8 个小时前。尽管可能在大部分情况下这都不会造成严重的问题,但是一般而言,OpenWRT 通常的最终目的——透明代理所常用的 V2Ray 刚好也是 Go 实现的,然后就会神奇地发现日志中的时间都是错的……

根据时间错了 8 个小时,如果拥有基本的常识,应该很容易就明白问题出在时区。中国位于东八区,刚好比零时区快了 8 个小时。那么,Go 到底是如何获取当前时间的呢?

首先,通过系统调用,程序可以获取当前的 UTC 时间。接着程序会尝试将其转换为本地时间:

  1. 读取TZ环境变量
  2. 读取/etc/localtime文件
  3. 本地时区读取失败,使用 UTC 时间

同时,这里的时区,尽管一般而言只是大洲名+城市名的字符串,但实际上并不能随便填写,其应该符合 IANA Time Zone Database。这些数据通常存放在/usr/share/zoneinfo/,如Asia/Shanghai实际上对应的是文件/usr/share/zoneinfo/Asia/Shanghai,程序通过读取相应的文件得知究竟应该如何根据 UTC 时间计算出本地时间(在某些国家和地区,还存在夏令时等情况,计算实际上很复杂)。

而不幸的是,OpenWRT 默认可能没有该文件。因此即使设置了TZ环境变量或/etc/localtime,仍然无法计算出本地时区。

另外,值得一提的是time.Now()默认是本地时间(如果可以成功获取时区的话),而time.Parse()默认是 UTC 时间,如果需要解析时区信息,需要使用time.ParseInLocation()

由于错误解析或其他原因,即使是 UTC 时间也可能输出的字符串与本地时间相同,但实际上这可能会引发各种奇怪的 Bug,因此实际上任何情况下输出时间都应该携带时区信息,或者统一使用 UTC 时间。否则在不同时区的设备上很可能造成奇怪的结果。

OpenWRT 安装时区依赖

由于我们只需要中国的时区,因此只需要安装亚洲的时区信息即可(毕竟 OpenWRT 硬盘容量有限,能省就省)

opkg update
opkg install zoneinfo-asia

接着,设置时区为上海时间

ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

再次使用上面提到的 Go 程序或 V2Ray,应该就可以正确输出本地时间了

参考资料