Python时区处理教程_pytz与zoneinfo使用_技术教程

推荐优先使用标准库 zoneinfo（Python 3.9+），它轻量、符合 IANA 规范；pytz 适用于旧版本但易出错，需严格遵循 localize + astimezone 范式，二者不可混用。

Python 处理时区，推荐优先用标准库 zoneinfo（Python 3.9+），它无需额外安装、更轻量、更符合 IANA 时区数据库规范；pytz 是旧方案，适用于 Python 3.8 及更早版本，但存在易出错的“本地化”逻辑，新手容易踩坑。

zoneinfo：现代、简洁、推荐首选

zoneinfo 将时区视为不可变对象，通过 ZoneInfo 类直接加载，避免了 pytz 中“先创建 naive 时间再 localize”的繁琐步骤。

获取带时区的当前时间：

from zoneinfo import ZoneInfo
from datetime import datetime

beijing = datetime.now(ZoneInfo("Asia/Shanghai"))
new_york = datetime.now(ZoneInfo("America/New_York"))

转换时区（推荐用 astimezone()）：

utc_time = beijing.astimezone(ZoneInfo("UTC"))

注意：ZoneInfo 不支持字符串缩写（如 "CST"、"PDT"），只认 IANA 标准名称（如 "Asia/Shanghai"、"America/Los_Angeles"）；可用 zoneinfo.available_timezones() 查看全部支持列表。

pytz：兼容旧版，但需小心 localize 和 astimezone

pytz 的核心陷阱在于：不能直接用 tz.localize(naive_dt) 以外的方式给 naive 时间加时区，也不能对已有时区时间重复调用 localize —— 否则会报错或结果异常。

正确方式（先 naive，再 localize）：

import pytz
from datetime import datetime

tz = pytz.timezone("Asia/Shanghai")
naive = datetime(2025, 5, 1, 12, 0)
aware = tz.localize(naive)  # ✅ 必须这样

跨时区转换必须用 astimezone()，不是 tz.normalize()（后者仅用于处理夏令时模糊时间）：
```
utc_aware = aware.astimezone(pytz.UTC)  # ✅
```
避免用 datetime(..., tzinfo=pytz.timezone(...)) 构造，这会跳过 DST 规则校验，导致错误。

常见问题与避坑提醒

不要混用 pytz 和 zoneinfo：两者返回的时区对象不兼容，混合使用 astimezone() 或比较会引发 TypeError。
系统时区 ≠ 本地时区：datetime.now().astimezone() 默认用系统时区，但不一定等于你期望的“北京时间”——显式指定 ZoneInfo("Asia/Shanghai") 更可靠。
解析字符串时带时区，优先用 datetime.fromisoformat()（Python 3.7+ 支持带 UTC 偏移的 ISO 字符串）：
```
dt = datetime.fromisoformat("2025-05-01T10:30:00+08:00")  # 自动为 aware
```

若需支持 Python

try:
    from zoneinfo import ZoneInfo
except ImportError:
    from pytz import timezone as ZoneInfo

（注意：这只是占位，实际逻辑仍需区分处理）

总结：选哪个？怎么过渡？

新项目统一用 zoneinfo；维护老项目且无法升级 Python 版本时，坚持 pytz 的 localize + astimezone 范式；迁移时重点检查所有 tz.localize() 和 tz.normalize() 调用，替换为 ZoneInfo 实例和 astimezone()。时区本质是地理标识，不是固定偏移，用对工具才能避开夏令时、历史变更等隐藏陷阱。