اعثر على تاريخ إصدار CPI التالي

نفّذ ذلك باستخدام واجهة API

استخدم GET /v1/economics/calendar لطلب جدول إصدارات لدولة ونطاق تواريخ. لا يوجد مرشح للموضوع في الطلب، لذا تختار شيفرة Python إصدارات أسعار المستهلك من استجابة التقويم. عند حذف معامل الدولة، قد يشمل اختيار أسعار المستهلك إصدارات من عدة دول، لذا أبقِ countries=USA عندما تريد جدول الولايات المتحدة.

1. احصل على مفتاح احصل على مفتاح API مجاني واحتفظ به في متغير بيئة باسم NARWHAL_API_KEY. تُرسل الطلبات إلى https://api.narwhalapi.com مع المفتاح في ترويسة Authorization: Bearer YOUR_KEY؛ ويقرأ البرنامج ذلك المفتاح من البيئة.
2. اختر الدولة ونطاق التواريخ اضبط countries على USA لتقويم الولايات المتحدة، مع تحديد النطاق المطلوب باستخدام start_date وend_date؛ ويستخدم البرنامج تاريخ تشغيله وتاريخ نهاية بعده بـ120 يومًا. لعدة دول، كرر المعامل بصيغة countries=USA&countries=GBR، أو احذف countries لإعادة إصدارات جميع الدول.
3. اختر إصدارات أسعار المستهلك المجدولة اطلب التقويم، ثم احتفظ بالإصدارات التي تكون فيها قيمة topic هي consumer_prices وقيمة status هي scheduled وتحتوي على قيمة at. يختار البرنامج أقرب قيمة at زمنيًا من بين هذه النتائج ويطبع الفترة المرجعية ووقت الإصدار بتوقيت UTC والمنطقة الزمنية للناشر.
   Python، إصدار أسعار المستهلك التالي للولايات المتحدة

   import os
   from datetime import date, timedelta
   import requests
   
   r = requests.get(
       "https://api.narwhalapi.com/v1/economics/calendar",
       params={
           "countries": "USA",
           "start_date": date.today().isoformat(),
           "end_date": (date.today() + timedelta(days=120)).isoformat(),
           "limit": 100,
       },
       headers={"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"},
       timeout=10,
   )
   r.raise_for_status()
   cpi = [
       x
       for x in r.json()["releases"]
       if x.get("topic") == "consumer_prices" and x["status"] == "scheduled" and "at" in x
   ]
   nxt = min(cpi, key=lambda x: x["at"])
   print(nxt["period"], nxt["at"], nxt["timezone"])

4. اقرأ حقول الإصدار يحتوي كل إصدار على release_id وcountry وname وtopic، ويحدد period الشهر الذي تغطيه الأرقام، بينما يصف status الإصدار المجدول. لأسعار المستهلك في الولايات المتحدة، تكون قيمة series_id هي usa-consumer-prices؛ وعند وجودهما، يحدد at اللحظة بتوقيت UTC، ويحدد timezone منطقة الناشر وفق IANA، وهي America/New_York.
5. تابع الصفحات المتبقية تحتوي الصفحة على 100 إصدار كحد أقصى، ويقرأ البرنامج الإصدارات الموجودة في صفحة استجابته. إذا تضمنت الاستجابة next_cursor، فاستخدمه لقراءة الصفحات المتبقية قبل اختيار أقرب إصدار مطابق زمنيًا من جميع نتائج التقويم؛ وراجع وثائق واجهة API للإصدارات الاقتصادية للاطّلاع على نقطة نهاية التقويم.

مهلة الطلب 10 ثوانٍ. يسبق raise_for_status() قراءة البرنامج لمصفوفة releases في JSON، لذا يوقف خطأ HTTP هذا المسار قبل اختيار أسعار المستهلك؛ وتقرأ عملية الاختيار حقول الإصدار من المصفوفة في الاستجابة.

اعثر على التاريخ دون شيفرة

افتح صفحات البيانات الاقتصادية واستخدم صفحة التضخم للدولة للاطّلاع سريعًا على إصدار أسعار المستهلك القادم. تتضمن صفحة التضخم لكل دولة تاريخ الإصدار التالي، بينما تسرد صفحات التقويم الاقتصادي الإصدارات القادمة حسب الدولة.

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

لتلقي تنبيه على هاتفك، استخدم اشتراكًا في التقويم. يضيف موجز البيانات الإصدارات إلى Google Calendar أو Outlook أو Apple Calendar؛ واتبع خطوات إعداد تنبيه لإصدار اقتصادي لاستخدام هذه الطريقة.

متى تستخدم كل خيار

هل تاريخ إصدار CPI مؤكد؟

يبقى الإصدار بقيمة status: scheduled حتى يُنشر، وقد يتغير وقته في at. أعد قراءة التقويم قبل الاعتماد على التاريخ في نموذج أو لوحة معلومات أو تنبيه يستخدم وقت الإصدار المجدول.

تتضمن خطافات الويب في خطتي Basic وPro حدث release.rescheduled عند تغيير الجدول. يظل حقل at في التقويم هو وقت الإصدار بتوقيت UTC الذي تقرؤه عندما تحتاج إلى اللحظة المجدولة، بينما يحدد timezone منطقة الناشر وفق IANA.

لماذا يسبق الشهر المرجعي شهر الإصدار؟

يمثّل period الشهر الذي تغطيه الأرقام، لذا يغطي الإصدار المجدول في 10 نوفمبر 2026 شهر أكتوبر 2026. وتكون قيمة period فيه 2026-10، مع أن تاريخ إصداره يقع في نوفمبر.

استخدم period لتحديد شهر أرقام CPI، وat لتحديد وقت نشرها المجدول. تُبقي قراءة هذين الحقلين بصورة منفصلة الشهر المرجعي مرتبطًا بالأرقام عند نقل تاريخ الإصدار إلى نموذج أو لوحة معلومات.

ماذا لو لم يكن للإصدار وقت محدد؟

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

يشترط الاختيار في Python وجود at ويستبعد تلك البنود من النتائج المطابقة. إذا كنت تحتاج إلى إصدارات لها تاريخ فقط أو نطاق زمني، فاقرأ بنودها في التقويم بصورة منفصلة عن البنود ذات الوقت الدقيق؛ فالتاريخ وحده لا يحدد لحظة يمكن تحويلها إلى منطقة زمنية أخرى.

مثال تطبيقي: CPI للولايات المتحدة لشهر أكتوبر 2026

لإصدار CPI للولايات المتحدة لشهر أكتوبر 2026، ابدأ بـ period: 2026-10. قيمة at المجدولة هي 2026-11-10T13:30:00Z، والمنطقة الزمنية للجهة الناشرة هي America/New_York.

اقرأ القيمة بتوقيت UTC على أنها 13:30 يوم الثلاثاء 10 نوفمبر 2026. تستخدم نيويورك توقيت EST، أي UTC-5، في نوفمبر، لذا اطرح خمس ساعات من 13:30 لتحصل على 08:30 في التاريخ نفسه.

للفترة المرجعية لشهر أكتوبر 2026، تعرض القيم المطبوعة الفترة أولًا، ثم الطابع الزمني المجدول بتوقيت UTC والمنطقة الزمنية للجهة الناشرة:

2026-10 2026-11-10T13:30:00Z America/New_York

من المقرر إصدار بيانات الفترة المرجعية لشهر نوفمبر 2026 في 10 ديسمبر 2026 الساعة 13:30 UTC. ومن المقرر إصدار بيانات الفترة المرجعية لشهر ديسمبر 2026 في 13 يناير 2027 الساعة 13:30 UTC.