حوّل وقت الإصدار إلى منطقتك الزمنية

حوّل وقت الإصدار من API باستخدام Python

ابدأ بالحقل at للإصدار الاقتصادي. يحتوي على لحظة الإصدار في صورة طابع زمني بتوقيت UTC ينتهي بـ Z. استخدم هذا الطابع الزمني مدخلًا لكل مكان تريد عرض الإصدار بتوقيته، بما في ذلك الأماكن التي يختلف تاريخها المحلي عن تاريخ UTC.

احصل على مفتاح API مجاني لقراءة تواريخ الإصدارات الاقتصادية. تستخدم Narwhal API العنوان https://api.narwhalapi.com بوصفه عنوان URL الأساسي. احفظ المفتاح في متغير البيئة NARWHAL_API_KEY وأرسله بصيغة Authorization: Bearer YOUR_KEY. تشترك REST وMCP في المفتاح نفسه، لذا يبدأ تحويل الطابع الزمني من الحقل at نفسه.

1. اقرأ الطابع الزمني بتوقيت UTC استخدم at لتحويل الوقت. لإصدار مؤشر أسعار المستهلك للولايات المتحدة في 10 نوفمبر 2026، الطابع الزمني هو 2026-11-10T13:30:00Z؛ ويمثل مثال Python وقت UTC نفسه باستخدام +00:00.
2. اختر المنطقة الزمنية المستهدفة استخدم اسم IANA لمكان القارئ، مثل Asia/Jakarta أو America/New_York. يتيح اسم المنطقة الزمنية استخدام قاعدة التوقيت الصيفي لتاريخ الإصدار عند التحويل، بينما يجب أن يتوافق فرق التوقيت الثابت مع ذلك التاريخ.
3. حوّل الطابع الزمني استخدم ZoneInfo في Python مع اسم المنطقة المستهدفة. يحوّل البرنامج النصي إصدار 10 نوفمبر 2026 إلى توقيت نيويورك ولندن وجاكرتا وطوكيو وسيدني، ويطبع التاريخ والوقت المحليين واختصار المنطقة الزمنية لكل مكان.
   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. اقرأ التاريخ المحلي مع الوقت أبقِ التاريخ مع الوقت عند استخدام النتيجة في تقويم أو عند عرضها. لهذا الإصدار المؤرخ في 10 نوفمبر 2026، تقع نتيجة سيدني في 11 نوفمبر 2026، بينما تبقى الأماكن الأخرى في البرنامج النصي ضمن 10 نوفمبر 2026.

حوّل إلى توقيت جاكرتا في جدول بيانات

ضع نص الطابع الزمني بتوقيت UTC من at في الخلية A2. في Google Sheets أو Excel، استخدم الصيغة التالية ونسّق النتيجة كتاريخ ووقت. تستخدم جاكرتا توقيت UTC+7 دون توقيت صيفي، لذا ينطبق فرق التوقيت الثابت نفسه على هذا التحويل.

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

تأخذ الصيغة التاريخ من بداية الطابع الزمني والوقت من الجزء الذي يليه، ثم تضيف فرق توقيت جاكرتا في صورة كسر من اليوم. عند وضع 2026-11-10T13:30:00Z في A2، تكون النتيجة 10 نوفمبر 2026 الساعة 20:30. اعرض جزأي النتيجة ليعطيك جدول البيانات تاريخ الإصدار المحلي ووقته.

لمكان يطبق التوقيت الصيفي، استخدم التحويل في Python أو أضف فرق التوقيت الساري في تاريخ الإصدار. تتضمن صيغة جاكرتا فرق توقيتها؛ فاستخدم فرق التوقيت الساري في المنطقة المستهدفة عند تعديل جدول البيانات لمكان آخر.

في مثال 10 نوفمبر 2026، جزء التاريخ في A2 هو 2026-11-10 وجزء الوقت هو 13:30:00. تضيف الصيغة 7/24 إلى ذلك التاريخ والوقت لتعطي النتيجة بتوقيت جاكرتا.

أي خيار للتحويل يناسب استخدامك؟

اختر المنطقة المستهدفة بحسب من سيقرأ الوقت. لجدولك الخاص، استخدم اسم IANA لمكانك. وعند عرض التوقيت المحلي للجهة الناشرة إلى جانبه، استخدم قيمة timezone الخاصة بها لذلك العرض المنفصل.

لماذا يقع الإصدار في اليوم التالي في سيدني؟

يقع إصدار 10 نوفمبر 2026 في 11 نوفمبر 2026 في سيدني لأن فرق التوقيت UTC+11 ينقله إلى ما بعد منتصف الليل. عند الساعة 13:30 UTC يوم الثلاثاء 10 نوفمبر 2026، تكون الساعة في سيدني 00:30 AEDT يوم الأربعاء 11 نوفمبر 2026. يشير التاريخان إلى لحظة الإصدار نفسها.

هل يغيّر التوقيت الصيفي وقت الإصدار؟

يمكن أن يغيّر التوقيت الصيفي وقت الإصدار بتوقيت UTC بمقدار ساعة لأن موعد الإصدار محدد بالتوقيت المحلي للجهة الناشرة. إصدار CPI للولايات المتحدة في 10 نوفمبر 2026 يكون الساعة 13:30 UTC، أي 08:30 EST في نيويورك. خلال التوقيت الصيفي في الولايات المتحدة، يوافق وقت الإصدار المحلي نفسه الساعة 12:30 UTC.

اقرأ at مجددًا بعد تغيير الساعة. حوّل ذلك الطابع الزمني باستخدام اسم IANA للمنطقة المستهدفة، ليتوافق كل من وقت إصدار الجهة الناشرة بتوقيت UTC والوقت المحلي للقارئ مع تاريخ الإصدار.

ماذا يعطيني حقل timezone؟

يعطيك الحقل timezone منطقة IANA الزمنية للجهة الناشرة، وهي America/New_York للولايات المتحدة. استخدمه عندما تريد عرض وقت الإصدار المحلي للجهة الناشرة بجانب توقيتك. لإصدار 10 نوفمبر 2026، يعني ذلك عرض 08:30 بتوقيت نيويورك إلى جانب 20:30 بتوقيت جاكرتا.

اقرأ at بتوقيت UTC حتى عندما يحدد timezone المصاحب نيويورك. لكل حقل استخدام منفصل: يحدد at اللحظة المراد تحويلها، ويحدد timezone المنطقة الزمنية للجهة الناشرة لعرض التوقيت المحلي.

مثال تطبيقي: CPI في 10 نوفمبر 2026 بتوقيت جاكرتا

خذ الطابع الزمني لإصدار مؤشر أسعار المستهلك للولايات المتحدة 2026-11-10T13:30:00Z. اقرأ التاريخ والوقت بتوقيت UTC، ثم أضف فرق توقيت جاكرتا البالغ سبع ساعات. تبقى النتيجة ضمن 10 نوفمبر 2026، لذا يتطابق تاريخ الإصدار المحلي مع تاريخ UTC.

للمقارنة، يتحول الطابع الزمني نفسه ليوم 10 نوفمبر 2026 إلى 08:30 EST في نيويورك و13:30 GMT في لندن و22:30 JST في طوكيو. تقع جميعها يوم الثلاثاء 10 نوفمبر 2026. وتكون الساعة في سيدني قد بلغت 00:30 AEDT يوم الأربعاء 11 نوفمبر 2026. تستخدم نتيجة جاكرتا توقيت WIB وتبقى يوم الثلاثاء، لذا يكون موعدها في التقويم 10 نوفمبر 2026 الساعة 20:30.