要将发布日期和命名时区转换为精确的午夜时刻，请使用该时区的规则解析本地 00:00:00，检查该时刻是否存在，然后将其转换为 UTC。此 Mac 终端工作流程还会检测重复的午夜时刻。

假设一条虚构的出版记录包含日期 2025-07-15 和时区 America/New_York。你的任务是计算代表该日期开始时午夜的时间戳。下面的工作流程会生成一个时间戳，你可以将其复制到接受 UTC 的工具中，同时保留原始日期和时区以供核对。

哪些信息定义了一个午夜时刻？

在整个计算过程中，请将以下四个值分开处理：

值 虚构示例 含义
民用日期 2025-07-15 不含时间或时区的公历日期
本地日期和时间 2025-07-15T00:00:00 所要求的挂钟读数
命名时区 America/New_York 用于解释该本地读数的规则
已解析时刻 2025-07-15T04:00:00Z 以 UTC 表示的一个特定时刻

Python 使用 date 表示日历日期，使用 datetime 组合日期和时间字段，并使用时区信息解释带时区的 datetime。它的 timezone 类表示固定偏移量；zoneinfo 提供命名时区规则。请参阅官方的 datetime 文档和 zoneinfo 文档。

像 -04:00 这样的偏移量表示某个特定读数下本地时间与 UTC 的差值。命名时区提供的规则可能会在不同日期产生不同偏移量。RFC 9557 解释了为何用固定偏移量替代命名时区会导致后续计算出错。请保留时区名称，不要从另一条出版记录中复制偏移量。RFC 9557：互联网日期和时间：含附加信息的时间戳

在此任务中，“午夜”指所给日期开始时的精确 00:00:00。在开始计算前，请明确这一要求：如果午夜不存在，那么要求某个日历日的第一个有效时刻就需要采用不同的处理规则。

为什么转换前必须检查午夜是否存在？

本地时钟调整可能造成间隙，即某个挂钟读数并未出现；也可能造成折叠，即某个读数出现两次。Python 的 PEP 495 定义了这些情况，并提供 fold 属性来区分重复读数。文档还指出，构造函数和 replace() 不会自动拒绝不存在的本地时间。因此，仅仅附加一个时区并不能验证所要求的午夜。PEP 495 – 本地时间消歧

对于要求精确午夜的出版需求，请使用以下判定规则：

找到的有效午夜时刻数 解释 处理方式
一个 午夜唯一 返回该时刻
两个 午夜重复 在选择较早或较晚时刻的规则前拒绝
无 精确午夜不存在 报告这些输入无法满足要求

下面的程序通过尝试两个 fold 值，将每个候选值转换为 UTC，再转换回命名时区来实现此规则。只有当转换回来的本地字段与所要求的午夜完全一致时，候选值才会保留。重复的 UTC 结果会合并为一个候选值。这个验证流程基于文档中描述的转换和 fold 行为，是额外的应用逻辑。datetime.astimezone()，PEP 495

如何在 Mac 终端中运行计算？

打开 Spotlight，输入 Terminal，然后打开该应用。或者，在 Finder 中打开 /Applications/Utilities，并双击 Terminal。这是 Apple 文档介绍的打开命令窗口的方法。在 Mac 上打开或退出终端

运行以下命令检查 Python 版本：

python3 --version

此示例需要 Python 3.9 或更高版本，该版本开始提供 zoneinfo。如果未安装 Python，或版本较旧，请按照官方 macOS 安装指南，从 Python.org 获取当前受支持的 Python 安装程序，然后再次检查版本。此工作流程使用标准库模块。zoneinfo — IANA 时区支持，在 macOS 上使用 Python

将下面的整个代码块复制到终端并按 Return。这是一个包含 Python 程序的完整命令。要计算其他发布日期的时间戳，请在粘贴前编辑 DATE_TEXT 和 ZONE_NAME。除非你已明确选择重复午夜的处理规则，否则请将 REPEATED 保持为 reject。

python3 - <<'PY'
from datetime import date, datetime, time, timezone
from zoneinfo import ZoneInfo, ZoneInfoNotFoundError

DATE_TEXT = '2025-07-15'
ZONE_NAME = 'America/New_York'
REPEATED = 'reject'  # 'reject', 'earlier', or 'later'


def resolve_midnight(date_text, zone_name, repeated='reject'):
    if repeated not in {'reject', 'earlier', 'later'}:
        raise ValueError('Repeated-time policy must be reject, earlier, or later.')

    day = date.fromisoformat(date_text)
    if day.isoformat() != date_text:
        raise ValueError('Use a date in YYYY-MM-DD format.')

    zone = ZoneInfo(zone_name)
    wall = datetime.combine(day, time.min)
    candidates = set()

    for fold in (0, 1):
        guess = wall.replace(tzinfo=zone, fold=fold)
        instant = guess.astimezone(timezone.utc)
        back = instant.astimezone(zone)
        if back.replace(tzinfo=None) == wall:
            candidates.add(instant)

    ordered = sorted(candidates)
    if not ordered:
        raise ValueError('Exact midnight does not exist on this date in this zone.')

    if len(ordered) == 2 and repeated == 'reject':
        choices = ', '.join(x.isoformat() for x in ordered)
        raise ValueError(
            'Midnight repeats. Choose earlier or later. UTC choices: ' + choices
        )

    chosen = ordered[-1] if repeated == 'later' else ordered[0]
    return chosen.astimezone(zone), chosen


try:
    local, utc = resolve_midnight(DATE_TEXT, ZONE_NAME, REPEATED)
except ZoneInfoNotFoundError:
    raise SystemExit(
        'Zone not found. Check the IANA name and time zone data installation.'
    )
except (ValueError, OverflowError) as exc:
    raise SystemExit(str(exc))

print('Civil date:', DATE_TEXT)
print('Named zone:', ZONE_NAME)
print('Local midnight:', local.isoformat())
print('UTC instant:', utc.isoformat().replace('+00:00', 'Z'))
PY

对于给定示例，输出如下：

民用日期：2025-07-15
命名时区：America/New_York
本地午夜：2025-07-15T00:00:00-04:00
UTC 时刻：2025-07-15T04:00:00Z

请结合起来阅读这两行时间戳。本地时间行确认所要求的挂钟时间是午夜。UTC 行标识同一时刻：减去负四小时的本地偏移量后，得到 04:00:00 UTC。RFC 3339 定义的时间戳由日期、时间以及数字偏移量或 Z 组成。RFC 3339：互联网日期和时间：时间戳

如何核对常规和特殊结果？

以下输入是为测试程序而选取的虚构出版示例。结果由上述解析器使用可用的时区数据库计算得出；它们并非实际出版记录。请更改两个输入值，并针对每种情况重新运行完整命令。

日期 命名时区 解析器结果
2025-01-15 America/New_York 一个时刻：2025-01-15T05:00:00Z
2025-07-15 America/New_York 一个时刻：2025-07-15T04:00:00Z
2018-11-04 America/Sao_Paulo 精确午夜不存在；拒绝
2020-11-01 America/Havana 午夜重复；默认拒绝
2011-12-30 Pacific/Apia 精确午夜不存在；拒绝

前两行说明了为什么日期必须参与计算：同一命名时区会将午夜解析为不同的 UTC 小时。对于哈瓦那的重复午夜示例，设置 REPEATED = 'earlier' 会选择 2020-11-01T04:00:00Z；将其设为 later 则会选择 2020-11-01T05:00:00Z。这些名称指 UTC 时间线上的先后顺序。

遇到午夜不存在的结果时，需要根据出版需求作出决定。如果精确午夜不可或缺，请明确选择另一个日期或时区。如果实际要求是该日期的第一个有效时刻，请单独定义并实现这一操作，包括整天都不存在时的处理方式。此解析器会明确报告失败，而不会悄悄替换成另一个本地时间。

输入失败时该怎么办？

如果日期错误，请提供符合 YYYY-MM-DD 格式的有效公历日期，例如 2025-07-15。程序会检查日历日期是否有效，以及格式是否完全符合要求。像 2025-02-30 这样的输入会报错，而不会被带入下一个月。

如果出现 Zone not found，请检查完整的 IANA 标识符，包括拼写和大小写。Python 文档指出，此异常可能表示键无效，也可能表示时区数据不可用。标准查找会先使用系统数据，再将官方的 tzdata 软件包作为后备。如果缺少相关数据，请将该软件包安装到你正在使用的 Python 环境中，然后重新运行解析器。PEP 615 – 在标准库中支持 IANA 时区数据库

请在工作笔记中将原始日期、时区名称、重复时刻的选择以及解析得到的 UTC 时间戳放在一起。如果不同电脑上的计算结果不一致，请比较它们使用的时区数据来源。安装后备软件包不会自动替换 Python 已找到的系统数据。zoneinfo 数据源

应将哪个值复制到其他工具中？

如果目标工具接受 UTC 时间戳，请复制 UTC instant 的值，包括其 Z。输入前请确认目标工具文档说明的输入格式。纯日期字段无法保留已解析时间戳所代表的全部信息；如需保留预定时间的意图，请同时记录原始日期和命名时区。

RFC 9557 定义了一种可包含命名时区后缀的扩展时间戳格式，但该格式仍表示一个已解析的时刻。它还指出，时区数据更新可能导致存储的偏移量与时区信息不一致。只有在接收工具明确说明支持时，才使用扩展表示法。RFC 9557：范围与不一致的偏移量

最后检查本地输出是否显示你所需日期的 00:00:00，命名时区是否与输入一致，以及是否经过慎重选择重复午夜的处理方式。通过这些检查后，UTC 输出就是根据本次计算所用规则解析出的午夜时刻。

来源