Python时区处理 - zoneinfo与pytz详解

Naive与Aware - 首先要掌握的区别

Python的datetime对象分为两种：naive(没有tzinfo属性)和aware(设置了tzinfo)。datetime.now()默认返回naive datetime，在序列化或比较时会隐式采用服务器的本地时区。一个在JST环境下本地开发、部署到UTC服务器上的代码库，很容易产生9小时偏移的bug，而任何测试都捕捉不到，因为两边都默认了错误的假设。

专业做法是尽早将输入时间戳转换为aware，在内部全程使用aware进行计算，仅在边界处序列化回字符串。混合使用naive和aware datetime进行算术运算会引发TypeError，因此在mypy或pyright中添加区分AwareDatetime和datetime的类型别名，可以提供强大的静态保护。

zoneinfo - Python 3.9+的标准库方案

PEP 615在Python 3.9中引入了zoneinfo模块，无需第三方依赖即可直接访问IANA时区数据库。zoneinfo.ZoneInfo(“Asia/Tokyo”)返回一个tzinfo实例，可以直接传给datetime，消除了pytz特有的一整类问题。去掉第三方包也简化了依赖管理和供应链审计。

默认情况下，zoneinfo从操作系统读取tzdata。Linux和macOS自带/usr/share/zoneinfo，但Windows原生不包含IANA数据。标准补救方法是pip install tzdata，它提供一个Python包作为zoneinfo的备选数据源。基于Alpine的Docker镜像通常因体积小而被选用，但也默认不包含tzdata，必须显式配置。

pytz - 有特殊陷阱的传统选择

自2003年以来，pytz一直是IANA时区的事实标准选择。它适用于所有仍在使用的Python版本，但有一个不寻常的API。不能将pytz时区直接传入datetime构造函数；这样做会用一个历史性的地方平均时(LMT)偏移量初始化datetime，该偏移比现代标准差数分钟。对于东京，这个LMT bug会产生9小时19分钟的偏移，而非预期的9小时。

pytz的正确用法是对naive datetime使用tz.localize(naive_dt)，对已有时区信息的datetime使用dt.astimezone(tz)。迁移到zoneinfo时，pytz代码库中分散的tz.normalize()调用可以完全移除，因为zoneinfo的算术运算无需手动规范化即可产生正确结果。

fold属性 - 解决夏令时歧义

Python 3.6为datetime添加了fold属性，以解决一个长期存在的问题：夏令时结束时，同一挂钟时间会出现两次。2026年11月1日凌晨1:30(美国东部时间)，这个时刻是模糊的。fold=0选择第一次出现(EDT, UTC-4)，fold=1选择第二次出现(EST, UTC-5)。没有这个区分，程序无法明确表示这两个时刻。

相反的情况是夏令时开始时挂钟时间向前跳跃，产生一个在时钟上不存在的间隙。zoneinfo将这段跳过的时间视为跳转前的时刻来处理，但进行闹钟调度或定时任务的应用必须显式处理这两种情况。边界测试应同时包含春季前跳和秋季回落重叠的场景。

保持tzdata更新 - 运维注意事项

IANA时区数据库每年会收到5到10次更新，反映夏令时取消或标准时间调整等政策变化。截至2026年，多个国家仍在讨论其夏令时政策，这意味着使用过期tzdata的系统可能计算出错误的未来时间。容器部署尤其容易出现这个问题，因为基础镜像的tzdata版本在构建时固定，只有重建镜像时才会刷新。

在托管运行时(如AWS Lambda或Cloud Run)上，无法直接验证捆绑的tzdata版本。对于计算未来时间戳的关键业务负载，最安全的方法是通过pip安装tzdata包，并通过TZPATH环境变量配置ZoneInfo优先使用它。这将时区数据版本置于显式控制之下，而非隐藏在运行时内部。

实践建议

对于Python 3.9及更高版本的新项目，zoneinfo是正确的默认选择。在混合使用pytz和zoneinfo的现有代码库中，两者可以通过tzinfo接口共存，无需立即重构。从API的入口和出口开始逐一迁移边界，变更会逐步传播到整个系统，无需大规模重写。

同样重要的是将内部状态保持为UTC的策略。在Asia/Tokyo或America/Los_Angeles中执行算术运算会招来夏令时相关的意外。在输入边界转换，在UTC中计算，仅在向用户展示或持久化到语义要求本地时间的列时才转换回去。PostgreSQL的TIMESTAMP WITH TIME ZONE始终在内部存储UTC，是这种方法的天然对应。