Python datetime fold 如何处理夏令时重复时刻

夏令时结束时，时钟会向后拨，某一段本地时间会出现两次。例如美国东部时间在回拨日可能两次经过 01:30。只保存 2024-11-03 01:30，系统无法知道它是回拨前还是回拨后的那一次。

datetime.fold 就是为这个歧义设计的：在使用支持 IANA 时区的 ZoneInfo 时，fold=0 表示较早的那次，fold=1 表示较晚的那次。它不是“是否启用夏令时”的总开关，而是重复或缺失本地时间时的消歧标记。

fold 解决的是哪一种时间问题

时区切换向后拨钟叫作 fold，落在这段区间的本地时间是 ambiguous；向前拨钟则产生 gap，落在跳过区间的本地时间是 missing。两者都不能只靠年月日时分来判断真实瞬间。

可以把本地时间看成“显示值”，把 UTC 偏移看成“解释方式”。在重复区间里，同一个显示值对应两个瞬间；fold 只负责选择这两个解释中的哪一个。非歧义时间通常使用默认的 fold=0 即可。

用 ZoneInfo 明确区分两次 01:30

不要手写夏令时偏移，使用标准库 zoneinfo 读取 IANA 时区。下面的例子把纽约回拨日的两次 01:30 转成可观察的偏移和时间戳：

from datetime import datetime, timezone
from zoneinfo import ZoneInfo

zone = ZoneInfo("America/New_York")

# fold=0 选择回拨前的较早时刻，fold=1 选择回拨后的较晚时刻。
first = datetime(2024, 11, 3, 1, 30, tzinfo=zone, fold=0)
second = first.replace(fold=1)

for label, value in (("第一次", first), ("第二次", second)):
    # 先打印偏移，再转 UTC，便于日志和排障时看出差异。
    print(label, value.isoformat(), value.utcoffset())
    print("UTC:", value.astimezone(timezone.utc).isoformat())
    print("timestamp:", value.timestamp())

# 两次墙上时间相同，但它们代表不同的瞬间。
assert first.replace(tzinfo=None) == second.replace(tzinfo=None)
assert first.timestamp() != second.timestamp()

这个例子里，两个对象的日期、时分完全相同，但 UTC 偏移不同，转换后的 UTC 和 Unix 时间戳也不同。若事件是预约、支付、日志或消息投递，时间戳的差异才是先后关系的重要证据。

比较、存储和展示时别把 fold 丢掉

最稳妥的边界是：输入阶段保留用户选择的本地时区与重复时刻标记，业务计算阶段转换到 UTC，展示阶段再转回用户时区。数据库可以保存一个 UTC 时间戳，再保存原始时区名；需要还原用户当时选择时，再额外记录 fold 或完整的带偏移字符串。

还要注意一个容易误判的行为：只改变 fold 的 datetime 在比较时可能被视为相等，因此不要把这类对象直接当作事件唯一键。需要区分重复时刻时，显式比较 fold、UTC 值或 timestamp()。固定偏移的 timezone.utc 本身没有这种本地重复问题。

春季 gap 与部署时区数据的边界

春季向前拨钟会跳过一段本地时间，例如 02:30 可能根本没有真实对应的 UTC 瞬间。构造器和 replace() 不会替你做严格的日历有效性校验，所以用户输入落在 gap 时，应结合业务规则提示重新选择，而不是把 fold=1 当成修复按钮。

ZoneInfo 优先使用系统时区数据库；某些 Windows 部署环境没有可用的 IANA 数据，跨平台项目可以显式依赖 PyPI 的 tzdata。如果找不到时区数据，创建 ZoneInfo 会失败，这属于部署依赖问题，不应悄悄退回固定偏移。

常见问题

fold=1 是否代表一定处于夏令时？

不是。它表示重复区间中的较晚解释；非歧义时刻也可以被构造为 fold=1，但那不等于有效的夏令时状态。

为什么两个 datetime 打印时间一样却 timestamp 不同？

打印常关注本地显示值，而 timestamp 还考虑 UTC 偏移。重复的 01:30 有两种偏移，所以 Unix 时间戳不同。

能不能一直使用固定的 -05:00？

固定偏移只能表达一种偏移，不能表达全年规则和历史变化。需要处理地区民用时区时，应使用 ZoneInfo("Area/City")。