zoneinfo 能直接替换 pytz 的 localize 和 normalize，因其用 zoneinfo 实例直接构造带时区 datetime，天然规避 pytz 易错的两步法，且对模糊或不存在时间默认抛错而非静默处理。
zoneinfo 为什么能直接替换 pytz 的 localize 和 normalize
因为 zoneinfo 不需要“本地化”时间对象——它靠时区实例直接构造带时区的 datetime，天然规避了 pytz 那套容易出错的两步法。你写 datetime(2023, 10, 29, 2, 30, tzinfo=ZoneInfo("Europe/Berlin"))，它就真按那个时刻、那个时区的规则解析，不会误判夏令时切换前后的歧义小时。
常见错误现象：pytz 下用 tz.localize(dt) 处理模糊时间（比如夏令时回拨时的 2:30）可能静默选错偏移；zoneinfo 默认抛 AmbiguousTimeError 或 NonExistentTimeError，强制你面对问题。
- 使用场景：读取用户输入的本地时间、解析日志中的无时区时间戳、生成调度任务起始点
- 参数差异：
ZoneInfo构造不接受is_dst参数，改用fold（0 或 1）显式指定歧义时刻倾向 - 性能影响：
ZoneInfo实例可复用且线程安全，比每次pytz.timezone("...")快；但首次加载 IANA 时区数据略慢（后续缓存）
pytz 的 astimezone 在 zoneinfo 里怎么等价写
astimezone 的核心逻辑是“把一个带时区的时间转成另一个时区”，zoneinfo 直接用 datetime.astimezone() 方法就行，但要注意前提：源时间必须带 tzinfo（不能是 naive datetime）。
常见错误现象：对 naive 时间调 .astimezone(ZoneInfo("UTC"))，Python 会按系统本地时区解释再转，结果不可控；pytz 同样有这坑，但新手更容易忽略。
立即学习“Python免费学习笔记（深入）”；
- 正确做法：先用
ZoneInfo显式绑定时区，再调.astimezone()，例如dt.replace(tzinfo=ZoneInfo("Asia/Shanghai")).astimezone(ZoneInfo("UTC")) - 兼容性注意：Python zoneinfo，需
pip install backports.zoneinfo并导入backports.zoneinfo - 别用
dt.tz_convert(...)：那是 pandas 的 API，和标准库无关
IANA 时区名大小写、拼写、缩写陷阱
zoneinfo 只认标准 IANA 名（如 "America/New_York"），不接受缩写（"EST"）、Windows 名（"Eastern Standard Time"）或大小写变体（"america/new_york"）。
常见错误现象：ZoneInfo("est") 报 ZoneInfoNotFoundError；ZoneInfo("US/Eastern") 虽然旧版 IANA 支持，但已弃用，部分新系统可能不加载。
- 查可用名：运行
import zoneinfo; print(zoneinfo.available_timezones())，别凭记忆写 - 生产环境务必用完整路径名，避免依赖系统时区数据库版本差异
-
pytz.all_timezones返回的列表和zoneinfo.available_timezones()不完全一致，迁移时要校验
从 pytz 到 zoneinfo 的最小改动清单
不是重写所有时间处理逻辑，而是聚焦三处关键替换点：时区获取、时间构造、时区转换。
最容易被忽略的是 pytz.utc —— 它不是普通 tzinfo，而是一个特殊对象；zoneinfo 里直接用 ZoneInfo("UTC") 即可，但要注意它和 timezone.utc（datetime.timezone.utc）行为不同：后者是固定偏移，不处理闰秒，也不参与 IANA 规则更新。
- 替换
pytz.timezone("...")→ZoneInfo("...") - 替换
tz.localize(naive_dt)→naive_dt.replace(tzinfo=ZoneInfo("..."))（或datetime(..., tzinfo=ZoneInfo(...))） - 替换
dt.astimezone(tz)→ 确保dt是 aware，再调原生.astimezone() - 删掉所有
pytz的normalize、utcoffset手动调用——zoneinfo的datetime自带正确偏移计算
复杂点在于历史数据回溯：IANA 数据更新后，zoneinfo 会反映真实历史变更（比如某国某年取消夏令时），而旧 pytz 包可能没同步。上线前得拿关键时间点做回归验证。
