ZoneInfo不能像pytz那样直接调用replace()，因其仅设tzinfo不校验DST，无localize方法；需先用ZoneInfo构造时区再astimezone()转换。
zoneinfo 是 Python 3.9+ 官方推荐的时区处理方案，它直接读取系统 IANA 时区数据库（如 /usr/share/zoneinfo），无需额外安装、无运行时依赖、API 更简洁——但不能直接替换 pytz 的所有用法，尤其涉及 localize() 和 astimezone() 的旧模式时容易出错。
为什么 zoneinfo.ZoneInfo 不能像 pytz.timezone() 那样直接调用 replace()
pytz 的 timezone('Asia/Shanghai') 返回一个“可感知时区”的类实例，允许对 naive datetime 调用 .localize()；而 zoneinfo.ZoneInfo 只是一个时区定义对象，本身不提供 localize 方法。直接对 naive datetime 调用 .replace(tzinfo=ZoneInfo('Asia/Shanghai')) 在绝大多数情况下是安全的，但要注意：
- 该操作仅设置 tzinfo 字段，不校验 DST 过渡或历史偏移变化（
zoneinfo在fromisoformat()或astimezone()时才真正查表） - 若 datetime 表示的是模糊时间（如夏令时回拨重叠点），
replace()不会报错，也不会自动选择早/晚版本——需手动用ZoneInfo.resolve_ambiguous()或检查.fold - 不要对已带 tzinfo 的 datetime 再
replace(tzinfo=...)，这会覆盖原有时区信息且不触发转换
如何正确将本地时间转换为 UTC 或其他时区
核心原则：先用 ZoneInfo 构造目标时区，再用 .astimezone() 做转换。避免手动加减 offset。
from datetime import datetime
from zoneinfo import ZoneInfo
<h1>✅ 正确：naive 时间 + ZoneInfo → aware，再 astimezone</h1><p>sh = datetime(2023, 10, 1, 12, 0, tzinfo=ZoneInfo('Asia/Shanghai'))
utc_time = sh.astimezone(ZoneInfo('UTC'))</p><h1>✅ 正确：从字符串解析后直接指定时区</h1><p>dt_str = '2023-10-01T12:00:00'
dt = datetime.fromisoformat(dt_str).replace(tzinfo=ZoneInfo('Asia/Shanghai'))</p><h1>❌ 错误：用 pytz 风格的 localize 模拟（zoneinfo 没有 localize 方法）</h1><h1>tz = ZoneInfo('Asia/Shanghai')</h1><h1>tz.localize(naive_dt) # AttributeError!</h1><p></p>
迁移 pytz.all_timezones 和动态加载时区的场景
zoneinfo 不提供内置的全时区列表，但可通过遍历系统 zoneinfo 目录获取（行为与 pytz.all_timezones 接近，但不含 Etc/GMT±N 这类反向缩写）：
- 使用
zoneinfo.available_timezones()获取全部有效 IANA 名称（Python 3.9+） - 该函数返回 set，不含排序，如需稳定顺序请
sorted(available_timezones()) -
Etc/UTC、Etc/GMT存在，但Etc/GMT+8是反直觉的（实际表示 UTC−8），不建议使用；应统一用Asia/Shanghai等地理名称 - 如果代码曾依赖
pytz.country_timezones['cn']，需自行维护映射，或改用第三方库如tzdata（仅用于 Windows 或旧系统补全数据库）
Windows 上缺少系统 zoneinfo 数据库怎么办
Windows 默认不带 /usr/share/zoneinfo，Python 3.9+ 会自动 fallback 到 tzdata 包（纯 Python 实现的 IANA 数据）。但需显式安装：
pip install tzdata
否则首次使用 ZoneInfo('Europe/London') 会抛出 ZoneInfoNotFoundError。macOS 和 Linux 通常自带，无需额外操作。注意：tzdata 包版本需与 Python 的 zoneinfo 兼容（一般装最新版即可），且它不会更新系统级时区数据，只供 Python 进程内使用。
最易被忽略的一点：ZoneInfo 实例是可缓存的，重复创建相同名称的 ZoneInfo 对象开销极小，但不要在循环里反复调用 ZoneInfo('UTC')——建议模块级缓存，例如 UTC = ZoneInfo('UTC')。另外，zoneinfo 不处理闰秒，这点和 pytz 一致。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
