若要將出版日期和具名時區轉換為精確的午夜時刻，請依照該時區的規則解析當地 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，然後開啟該 app。或者，在 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 那一行則標示同一時刻：從當地時間減去負四小時的偏移量，就會得到 UTC 04:00:00。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 時刻 的值，包括其 Z。輸入前請確認目的地文件說明的輸入格式。單純的日期欄位無法保留該解析時間戳記所代表的所有資訊；若要保留排程意圖，請將原始日期和具名時區一併保存。

RFC 9557 定義了一種可包含具名時區後綴的擴充時間戳記格式，但該格式仍表示已解析的時刻。它也指出，時區資料更新可能導致已儲存的偏移量與時區資訊不一致。只有在接收工具的文件明確說明支援時，才使用擴充格式。RFC 9557：範圍和不一致的偏移量

最後請確認當地輸出顯示的是你預期日期的 00:00:00、具名時區與輸入相符，而且任何重複午夜的選擇都是刻意決定的。確認無誤後，UTC 輸出就是依據該次計算所用規則解析出的午夜時刻。

來源