Python zoneinfo 与 fold 结合时如何格式化重复时间

夏令时回拨或其他时区偏移回退时，同一个本地钟面时间可能出现两次。Python 的 zoneinfo 会用 fold=0 表示较早的那次，用 fold=1 表示较晚的那次；但 strftime() 默认不会把 fold 单独打印出来。实际格式化时，应至少同时输出本地时间、%Z、%z 和 fold，必要时再附上 UTC 值。

先用 ZoneInfo 选出重复时间的两个时刻

ZoneInfo 代表 IANA 时区规则。以美国洛杉矶 2020 年回拨为例，2020-11-01 01:30 出现两次：第一次仍是 PDT，偏移为 -07:00；第二次已经是 PST，偏移为 -08:00。构造本地时间后，用 replace(fold=1) 选中第二次出现的钟面时间。

from datetime import datetime, timezone
from zoneinfo import ZoneInfo

la = ZoneInfo("America/Los_Angeles")

# fold=0 表示回拨前的第一次 01:30。
first = datetime(2020, 11, 1, 1, 30, tzinfo=la, fold=0)
# 只改变重复时间的选择，不改变日期、时分或时区规则。
second = first.replace(fold=1)

for label, value in (("first", first), ("second", second)):
    print(
        label,
        value.isoformat(),
        "fold=", value.fold,
        "utc=", value.astimezone(timezone.utc).isoformat(),
    )

first 2020-11-01T01:30:00-07:00 fold= 0 utc= 2020-11-01T08:30:00+00:00
second 2020-11-01T01:30:00-08:00 fold= 1 utc= 2020-11-01T09:30:00+00:00

这里的关键不是把字符串改成“第一次”或“第二次”，而是让对象携带有效的时区规则和 fold。如果时间来自 UTC 再调用 astimezone(la)，Python 会根据转换结果设置正确的 fold；如果是用户手工输入本地钟面时间，则必须由业务规则、选择框或其他上下文决定取哪一次。

把 offset、时区名和 fold 一起格式化

strftime 可以输出时区名和偏移：%Z 是时区名称，%z 是类似 -0700 的 UTC 偏移。由于格式化指令没有一个通用的 %fold，应在格式字符串外显式拼接 value.fold。

def format_ambiguous_time(value: datetime) -> str:
    # %Z 说明时区名，%z 说明偏移，fold 说明重复时间的选择。
    local_part = value.strftime("%Y-%m-%d %H:%M:%S %Z %z")
    # UTC 便于跨服务排序和排查，保留 +00:00 这样的明确偏移。
    utc_part = value.astimezone(timezone.utc).isoformat()
    return f"{local_part} [fold={value.fold}] [utc={utc_part}]"

print(format_ambiguous_time(first))
print(format_ambiguous_time(second))

输出会类似 2020-11-01 01:30:00 PDT -0700 [fold=0] 和 2020-11-01 01:30:00 PST -0800 [fold=1]。对用户界面，可把 fold=0 显示为“回拨前”，把 fold=1 显示为“回拨后”；对日志则建议同时记录 ISO 8601 值和 UTC 值，避免下游只读取前面的钟面时间。

存储与测试要分清展示格式和时间身份

重复时间最容易在序列化和排序时丢失信息。仅保存 2020-11-01 01:30:00 会丢掉时区与偏移；只保存带偏移字符串虽然能区分这两个例子，但跨服务比较时仍应统一解析为 aware datetime 或 UTC。展示格式可以面向人，存储格式则要保留能定位具体时刻的字段。

回归测试至少断言三件事：两个对象的 fold 不同；utcoffset() 不同；转换到 UTC 后的结果不同。不要只比较 strftime("%H:%M")，因为那恰好会把两个事件格式化成同一个钟面字符串。

相关问题

fold=1 在所有时间里都代表夏令时结束吗？

不是。它表示重复区间中的较晚一次，具体偏移由对应 tzinfo 的时区规则决定，不能把它硬编码成“标准时间”。

为什么只调用 strftime 看不出 fold？

strftime 有时区名和偏移指令，但没有通用的 fold 指令。需要在格式化结果后显式拼接 value.fold。

从 UTC 转成本地时间还需要手动设置 fold 吗？

通常不需要。对带时区的 UTC 时间调用 astimezone() 时，zoneinfo 会根据目标时区规则设置正确的 fold；手工创建本地钟面时间时才需要明确选择。