Python zoneinfo：正确处理夏令时重复时间与不存在时间
“凌晨一点半”不是永远唯一的时刻。某些地区秋季调回时钟时会重复一段本地时间，春季前拨时又会跳过一段时间。仅保存日期和小时分钟，可能无法还原用户的真实选择。本文使用 Python 3.14 标准库说明；zoneinfo 从 Python 3.9 起提供，实际时区规则还取决于系统数据库或 tzdata 包。
AI生成概念配图：相同墙钟读数可能沿不同时区偏移对应两个时刻。仅辅助理解，不代表真实界面或实测结果。
先使用时区名称，而不是固定小时差
from datetime import datetime, timezone
from zoneinfo import ZoneInfo
zone = ZoneInfo('America/Los_Angeles')
instant = datetime(2020, 11, 1, 8, 30, tzinfo=timezone.utc)
local = instant.astimezone(zone)
print(local.isoformat(), local.fold)这里使用历史日期作为可复查示例。IANA 名称代表一套地区规则，固定的 UTC 偏移只表达某个偏移量，二者不等价。已经表示一个明确时刻的 datetime，应通过 astimezone 转换显示；replace(tzinfo=...) 只是赋予或替换时区解释，不会替你保持同一个时刻，混用后常见整体偏移数小时的问题。
输入不带时区时，应先确定它是用户当地墙钟时间、服务器时间还是 UTC，不能因为程序部署在哪里就自动猜在哪里。日志事件适合保存明确的 UTC 时刻；未来的当地日程往往还需要保留地区名称和原始墙钟规则，避免把一次换算当作永久不变的业务含义。
用 fold 区分重复的本地时间
first = datetime(2020, 11, 1, 1, 30, tzinfo=zone, fold=0) second = datetime(2020, 11, 1, 1, 30, tzinfo=zone, fold=1) print(first.astimezone(timezone.utc).isoformat()) print(second.astimezone(timezone.utc).isoformat())
在这个回拨示例中，fold=0 选择变化前的偏移，fold=1 选择变化后的偏移，所以相同的一点半对应两个 UTC 时刻。用户界面可以展示偏移或“第一次、第二次”的明确选择。不要在没有业务约定时静默选一个，更不要把 fold 当作通用的“是否夏令时”布尔开关；它表达的是歧义区间中的先后。
能构造对象，不代表当地时间有效
candidate = datetime(2020, 3, 8, 2, 30, tzinfo=zone) back = candidate.astimezone(timezone.utc).astimezone(zone) print(candidate.replace(tzinfo=None) == back.replace(tzinfo=None))
示例位于春季跳过的时间段，往返 UTC 后不会保持原来的墙钟读数。datetime 构造函数不会自动拒绝所有这类输入，因此“没有异常”不能作为有效性检查。上面只是演示检测思路；完整入口应结合两个 fold 候选的往返结果，区分唯一、重复和不存在，再按业务约定拒绝、询问或调整，不能把所有情况一律向后平移。
排序或计算实际经过时长时，先统一到 UTC，再做相应运算；如果业务问的是“当地明天同一时间”，则应按日历语义处理。一天的墙钟安排与固定经过二十四小时不是永远同一件事。明确这层差异，比到处加减小时更能减少定时任务和账单边界错误。
把时区数据当作部署依赖
zoneinfo 优先读取可用的系统时区数据库，缺少时可使用官方 tzdata 包；两者都没有时可能抛出 ZoneInfoNotFoundError。跨平台项目应明确数据来源，并在部署记录中保存相关版本。仅固定 Python 包版本，不代表系统时区规则也固定，排查两台机器结果不同前先核对这件事。
验收至少包含普通日期、回拨重复时间、前拨缺失时间、跨日转换和错误地区名称。对未来计划还应考虑地区规则更新，并把显示时间、存储时刻和调度策略分别说明。本文不涉及闰秒处理，也不建议用手写地区偏移表替代时区数据库。
