强制zoneinfo使用Python tzdata及跨平台UTC偏移差异排查

问题现象 #

在不同平台使用zoneinfo计算Europe/Amsterdam时区1970年前日期的UTC偏移时，结果出现明显差异：

• Linux平台（Ubuntu 2026a、Raspbian 2025b）：1923年和1023年的偏移均为1172秒
• MacOS（2025c）和Windows（tzdata 2026b）：1923年偏移为0秒，1023年偏移为1050秒

已确认IANA时区邮件列表中对应版本间无Europe/Amsterdam文件的变更记录。

测试详情 #

Ubuntu noble（tzdata 2026a-0ubuntu0.24.04） #

Python 3.12.3 (main, Mar 23 2026, 19:04:32) [GCC 13.3.0]
Type 'copyright', 'credits' or 'license' for more information
IPython 9.5.0 -- An enhanced Interactive Python. Type '?' for help.

In [1]: import zoneinfo
In [2]: from datetime import datetime
In [3]: zoneinfo.ZoneInfo("Europe/Amsterdam").utcoffset(datetime(1923, 12, 1, 13, 43, 12)).total_seconds()
Out[3]: 1172.0
In [4]: zoneinfo.ZoneInfo("Europe/Amsterdam").utcoffset(datetime(1023, 12, 1, 13, 43, 12)).total_seconds()
Out[4]: 1172.0
In [5]: zoneinfo.TZPATH
Out[5]: 
('/usr/share/zoneinfo',
 '/usr/lib/zoneinfo',
 '/usr/share/lib/zoneinfo',
 '/etc/zoneinfo')

MacOS Sequoia 15.7.2（zoneinfo版本2025c） #

Python 3.12.12 (main, Mar 23 2026, 19:04:32) [GCC 13.3.0]
Type 'copyright', 'credits' or 'license' for more information
IPython 9.5.0 -- An enhanced Interactive Python. Type '?' for help.

In [13]: import zoneinfo
In [14]: from datetime import datetime
In [15]: zoneinfo.ZoneInfo("Europe/Amsterdam").utcoffset(datetime(1923,12,1,13,43,12)).total_seconds()
Out[15]: 0.0
In [16]: zoneinfo.ZoneInfo("Europe/Amsterdam").utcoffset(datetime(1023,12,1,13,43,12)).total_seconds()
Out[16]: 1050.0
In [17]: zoneinfo.TZPATH
Out[17]:
('/usr/share/zoneinfo',
 '/usr/lib/zoneinfo',
 '/usr/share/lib/zoneinfo',
 '/etc/zoneinfo')

Raspbian bookworm（tzdata 2025b-0+deb12u2） #

Python 3.11.2 (main, Apr 28 2025, 14:11:48) [GCC 12.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import zoneinfo
>>> from datetime import datetime
>>> zoneinfo.ZoneInfo("Europe/Amsterdam").utcoffset(datetime(1923, 12, 1,13,43,12)).total_seconds()
1172.0
>>> zoneinfo.ZoneInfo("Europe/Amsterdam").utcoffset(datetime(1023, 12, 1,13,43,12)).total_seconds()
1172.0
>>> zoneinfo.TZPATH
('/usr/share/zoneinfo', '/usr/lib/zoneinfo', '/usr/share/lib/zoneinfo', '/etc/zoneinfo')

Windows 10（uv安装Python，tzdata 2026b） #

Python 3.12.1 (tags/v3.12.1:2305ca5, Dec  7 2023, 22:03:25) [MSC v.1937 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.                                      
>>> import zoneinfo
>>> import tzdata
>>> from datetime import datetime
>>> zoneinfo.ZoneInfo("Europe/Amsterdam").utcoffset(datetime(1923, 12, 1,13,43,12)).total_seconds()
0.0
>>> zoneinfo.ZoneInfo("Europe/Amsterdam").utcoffset(datetime(1023, 12, 1,13,43,12)).total_seconds()
1050.0
>>> zoneinfo.TZPATH
()
>>> tzdata.IANA_VERSION
'2026b' 

原因分析 #

1. 数据源优先级与处理差异：
   • Linux平台的zoneinfo优先加载系统级tzdata（/usr/share/zoneinfo），这部分数据直接基于IANA原始数据编译，完整保留了历史时区（包括LMT本地平均时）的计算逻辑。
   • MacOS的系统tzdata由Apple维护，可能对1970年前的历史时区做了简化或调整；Windows平台无系统级tzdata，默认使用Python的tzdata包，但结果与MacOS一致，推测是tzdata包的IANA数据在处理极早期时区时，与Linux系统编译的tzdata存在逻辑或编译参数差异。
2. 1970年前时区的特殊处理：IANA时区数据对1970年之前的时区（尤其是LMT）的定义，不同编译环境可能存在实现差异，部分平台可能默认忽略1970年前的非标准时区偏移，或采用不同的计算方式。

解决方案：强制使用虚拟环境的tzdata包 #

要让zoneinfo优先使用虚拟环境中安装的tzdata包（而非系统tzdata），可通过以下方法：

方法1：修改zoneinfo.TZPATH #

在代码开头插入以下内容，将tzdata的目录加入TZPATH并放在最前面：

import zoneinfo
import tzdata
# 获取tzdata的时区文件目录
tzdata_dir = tzdata.directory
# 插入到TZPATH的首位，确保优先加载
zoneinfo.TZPATH = (tzdata_dir,) + zoneinfo.TZPATH

方法2：设置环境变量TZPATH #

在启动Python前，设置环境变量TZPATH为tzdata的目录路径：

• Linux/MacOS：

  export TZPATH=$(python -c "import tzdata; print(tzdata.directory)")
  

• Windows（PowerShell）：

  $env:TZPATH = python -c "import tzdata; print(tzdata.directory)"
  

方法3：直接从文件加载时区 #

通过ZoneInfo.from_file()直接加载tzdata包中的时区文件，完全绕过系统数据源：

import zoneinfo
import tzdata
import os
from datetime import datetime

# 构造Europe/Amsterdam的时区文件路径
tz_file = os.path.join(tzdata.directory, "Europe", "Amsterdam")
# 加载时区
amsterdam_tz = zoneinfo.ZoneInfo.from_file(tz_file)
# 计算偏移
print(amsterdam_tz.utcoffset(datetime(1923, 12, 1, 13, 43, 12)).total_seconds())

内容的提问来源于stack exchange，提问作者zeitkunst