Python zoneinfo 处理夏令时重复小时要看 fold 吗

要看，但不是每个带时区的 datetime 都要手动设置 fold。只有当夏令时回拨（或其他 UTC 偏移回退）让同一个本地小时出现两次时，fold 才负责消除歧义：fold=0 表示较早发生的一次，fold=1 表示较晚发生的一次。若时间来自 UTC，优先让 zoneinfo 在转换时自动决定。

官方资料：https://docs.python.org/3/library/zoneinfo.html

重复小时里，fold=0 和 fold=1 到底差在哪里

以 America/Los_Angeles 为例，回拨发生时，本地的 01:30 可能先以 PDT（-07:00）出现，随后又以 PST（-08:00）出现。墙上时钟读数相同，但它们对应的 UTC 时刻相差一小时。

ZoneInfo 把“前一个偏移”放在 fold=0，把“后一个偏移”放在 fold=1。这两个值不是“是否夏令时”的开关：有些历史偏移变化并非夏令时，而且 fold 只在存在两个（或没有）解释的边界上有意义。

构造本地时间时，fold 要由业务选择决定

如果输入是“2020-11-01 01:30”加一个时区名，单靠这三个字段无法知道用户指的是第一次还是第二次。可以先建立默认的第一次，再根据表单、预约规则或人工确认切换到第二次：

from datetime import datetime, timezone
from zoneinfo import ZoneInfo

zone = ZoneInfo("America/Los_Angeles")
first = datetime(2020, 11, 1, 1, 30, tzinfo=zone, fold=0)
second = first.replace(fold=1)

# 用偏移和时间戳确认两次本地读数不是同一个瞬时点
print(first.isoformat(), first.utcoffset(), first.timestamp())
print(second.isoformat(), second.utcoffset(), second.timestamp())

# 进入队列或数据库前转换为 UTC，避免只保存模糊的墙上时间
first_utc = first.astimezone(timezone.utc)
second_utc = second.astimezone(timezone.utc)

这里使用 replace() 只是表达一个明确选择，并不会替你检查业务是否合法。相反，在春季跳跃造成的“缺失时间”里，某个本地读数根本没有真实对应的瞬时点；不要把 fold=1 当成通用的“修复无效时间”按钮。

从 UTC 转换时不要手动猜 fold

服务端事件、消息队列和日志通常更适合携带 UTC。将带 UTC 的 datetime 调用 astimezone() 转到目标区域时，ZoneInfo 会依据时区规则给出正确的本地偏移和 fold，这样不会把第二个 01:30 误当成第一个：

from datetime import datetime, timedelta, timezone
from zoneinfo import ZoneInfo

la = ZoneInfo("America/Los_Angeles")
utc_before = datetime(2020, 11, 1, 8, tzinfo=timezone.utc)
utc_after = utc_before + timedelta(hours=1)

# 来源已经是明确的 UTC 瞬时点，转换时让 zoneinfo 计算本地 fold
local_before = utc_before.astimezone(la)
local_after = utc_after.astimezone(la)
print(local_before.isoformat(), local_before.fold)
print(local_after.isoformat(), local_after.fold)

排查时重点看三项：输入是否带有 tzinfo=timezone.utc、目标是否是 IANA 区域名、转换结果的 fold 和 utcoffset() 是否成对变化。不要通过固定加减一小时模拟夏令时。

接口和数据库要保存哪些时间字段

推荐把 UTC 瞬时点作为排序、过期和计算依据；如果产品要展示原始本地输入或允许重新解释，还要保存区域键和歧义选择：

如果系统只接收 UTC 事件，通常不必额外持久化 fold，因为转换回目标时区可以重新得到它；但只要入口允许用户提交本地时间，就不能只存一个没有时区和 fold 的字符串。

相关问题

fold=1 是不是永远代表冬令时？

不是。它表示偏移回退后较晚的解释；夏令时只是最常见的回拨原因。

普通日期也要把 fold 写进接口吗？

不一定。可以把它设计成可选字段，仅在本地输入命中歧义区间时要求用户确认；服务端仍应保存最终 UTC。

为什么不直接保存 UTC 偏移量？

偏移量能标识一个瞬时点，但不能表达未来规则和用户所在区域。需要重新按当地规则展示时，应同时保留 IANA 时区名。