將發布時間換算為你的時區

使用 Python 換算 API 的發布時間

先讀取經濟數據發布項目的 at 欄位。此欄位以結尾為 Z 的 UTC 時間戳記表示發布時刻。無論要顯示哪個地點的發布時間，都以此時間戳記作為輸入，包括當地日期與 UTC 日期不同的地點。

取得免費 API 金鑰，以讀取經濟數據發布日期。Narwhal API 的基底網址是 https://api.narwhalapi.com。將金鑰存放在 NARWHAL_API_KEY 環境變數中，並以 Authorization: Bearer YOUR_KEY 傳送。REST 與 MCP 共用同一個金鑰，因此時間戳記換算皆從相同的 at 欄位開始。

1. 讀取 UTC 時間戳記 使用 at 換算時間。2026 年 11 月 10 日美國消費者物價數據發布的時間戳記為 2026-11-10T13:30:00Z；Python 範例以 +00:00 表示相同的 UTC 時間。
2. 選擇目標時區 使用讀者所在地的 IANA 時區名稱，例如 Asia/Jakarta 或 America/New_York。指定時區名稱後，換算時就能套用發布日期當天的日光節約時間規則；使用固定時差時，則必須確認該時差適用於當天。
3. 換算時間戳記 將目標時區名稱傳入 Python 的 ZoneInfo。此指令碼會將 2026 年 11 月 10 日的發布時間換算為紐約、倫敦、雅加達、東京與雪梨的時間，並輸出各地的當地日期、時間與時區縮寫。
   Python，同一發布時間在五個時區的換算

   from datetime import datetime
   from zoneinfo import ZoneInfo
   
   release = datetime.fromisoformat(
       "2026-11-10T13:30:00+00:00"
   )  # the "at" field is always UTC
   for zone in [
       "America/New_York",
       "Europe/London",
       "Asia/Jakarta",
       "Asia/Tokyo",
       "Australia/Sydney",
   ]:
       print(
           f"{zone:18}",
           release.astimezone(ZoneInfo(zone)).strftime("%a %d %b %Y %H:%M %Z"),
       )

4. 同時讀取當地日期與時間 將結果用於行事曆或畫面顯示時，請一併保留日期。以這次 2026 年 11 月 10 日的發布為例，雪梨的換算結果落在 2026 年 11 月 11 日，而指令碼中的其他地點仍是 2026 年 11 月 10 日。

在試算表中換算為雅加達時間

將 at 中的 UTC 時間戳記文字放入儲存格 A2。在 Google Sheets 或 Excel 中使用下方公式，並將結果格式設為日期時間。雅加達使用 UTC+7，且不採用日光節約時間，因此這項換算一律適用相同的固定時差。

=DATEVALUE(LEFT(A2,10))+TIMEVALUE(MID(A2,12,8))+7/24

公式會從時間戳記開頭擷取日期，再從後面的部分擷取時間，接著加上以一天的分數表示的雅加達時差。當 A2 的值為 2026-11-10T13:30:00Z 時，結果是 2026 年 11 月 10 日 20:30。請同時顯示結果中的日期與時間，讓試算表提供當地發布日期及時間。

若地點採用日光節約時間，請使用 Python 換算，或加上發布日期當天適用的時差。雅加達公式使用的是雅加達時差；將試算表改用於其他地點時，請使用目標地點適用的時差。

在 2026 年 11 月 10 日的範例中，A2 的日期部分是 2026-11-10，時間部分是 13:30:00。公式會將該日期時間加上 7/24，得到雅加達的換算結果。

哪種換算方式適合你的用途？

依據時間的讀者選擇目標時區。若用於自己的行程，請使用所在地的 IANA 時區名稱。若要在旁邊顯示發布單位的當地時間，請另外使用發布單位的 timezone 值來顯示。

為什麼雪梨的發布日期會落在隔天？

2026 年 11 月 10 日的發布在雪梨落於 2026 年 11 月 11 日，因為加上 UTC+11 時差後會跨過午夜。2026 年 11 月 10 日星期二 13:30 UTC，對應雪梨的 2026 年 11 月 11 日星期三 00:30 AEDT。這兩個日期指的是同一個發布時刻。

日光節約時間會改變發布時間嗎？

由於發布時間是依發布單位的當地時間設定，日光節約時間可能使 UTC 發布時間相差一小時。2026 年 11 月 10 日美國 CPI 的發布時間是 13:30 UTC，即紐約的 08:30 EST。在美國採用日光節約時間期間，相同的當地發布時間會對應 12:30 UTC。

時鐘調整後，請重新讀取 at。使用目標地點的 IANA 時區名稱換算該時間戳記，讓發布單位的 UTC 發布時間與讀者的當地時間都依照發布日期換算。

timezone 欄位提供什麼資訊？

timezone 欄位提供發布單位的 IANA 時區，美國使用的是 America/New_York。若要在自己的當地時間旁顯示發布單位的當地發布時間，請使用此欄位。以 2026 年 11 月 10 日的發布為例，就是同時顯示紐約時間 08:30 與雅加達時間 20:30。

即使隨附的 timezone 指定紐約，仍應將 at 視為 UTC。這兩個欄位各有用途：at 提供要換算的時刻，timezone 則提供發布單位的時區，供顯示其當地時間使用。

實作範例：2026 年 11 月 10 日 CPI 的雅加達時間

以美國消費者物價數據發布的時間戳記 2026-11-10T13:30:00Z 為例。讀取 UTC 日期與時間，再加上雅加達的七小時時差。相加後仍在 2026 年 11 月 10 日之內，因此當地發布日期與 UTC 日期相同。

作為比較，同一個 2026 年 11 月 10 日的時間戳記，換算後是紐約的 08:30 EST、倫敦的 13:30 GMT 與東京的 22:30 JST。這些地點的日期都是 2026 年 11 月 10 日星期二。雪梨則已是 2026 年 11 月 11 日星期三 00:30 AEDT。雅加達的換算結果使用 WIB，日期仍是星期二，因此行事曆項目使用 2026 年 11 月 10 日 20:30。