منهجية التقويم وتغطيته

العطلات الرسمية، من دون ضمان إغلاق الجهات

تتوفر واجهة API للتقويم لسنوات البلدان المنشورة أدناه. وتستخدم الأحداث التواريخ المدنية المحلية. ولا تحدد هذه التواريخ ساعات عمل البنوك أو جلسات البورصات أو تواريخ التسوية أو ما إذا كان صاحب عمل بعينه سيغلق.

الـ scope يميز الحقل بين العطلات الوطنية والإقليمية وعطلات البنوك وتقويمات الحكومة والإجازة الجماعية. nationwide يصف الجغرافيا، لا ما إذا كان كل صاحب عمل أو قطاع يراعي الحدث. قد تكون حالة observed/substitute null عندما لا يذكرها المصدر.

تتوفر تغطية الدول والسنوات المنشورة باستخدام مفتاح Narwhal الخاص بك. أما التغطية الأخرى فغير متاحة صراحةً.

يبقى الهدف 19 دولة. وتغطي أستراليا حاليًا نيو ساوث ويلز فقط. وتستبعد فرنسا العطلات الإقليمية الإضافية؛ ويغطي تقويم الولايات المتحدة الموظفين الفيدراليين. وتحافظ عطلات البنوك في المملكة المتحدة على التقسيمات الثلاثة المنشورة. وتستبعد الصين أيام العمل التعويضية، بينما تفصل إندونيسيا بين العطلات الوطنية والإجازة الجماعية.

يمثل نطاق الإدخال 1900–2200 حدّاً للتحقق، وليس تغطية تاريخية. يجب ألا تُفسَّر سنة غير متاحة على أنها سنة بلا عطلات.

المصادر الرسمية ونَسب المحتوى

تستخدم التقاويم المنشورة وثائق رسمية راجعتها الجهة وجداول تواريخ واقعية. ويرتبط كل منشور بالتقاط المصدر المراجع وأدلة إعادة الاستخدام والنطاق المعلن. ولا يعني اعتماد المصدر تغطية كل سنة أو منطقة.

• AUS: حكومة نيو ساوث ويلز · المشاع الإبداعي نسب المصنف 4.0.
• CHN: إشعار رسمي لمجلس الدولة.
• FRA: Etalab / calendrier.api.gouv.fr · Licence Ouverte 2.0.
• GBR: واجهة GOV.UK لعطلات البنوك · رخصة الحكومة المفتوحة الإصدار 3.0.
• IDN: مرسوم الوزراء الثلاثة الإندونيسي · تواريخ واقعية.
• JPN: مكتب مجلس الوزراء الياباني · رخصة البيانات العامة الإصدار 1.0.
• USA: مكتب إدارة شؤون الموظفين الأمريكي · جدول حكومي واقعي.
• ZAF: الجريدة الرسمية لحكومة جنوب أفريقيا 52178 · إشعار رسمي.

تتطلب تغييرات المصدر مراجعة قبل نشر تواريخ الاستبدال. وتُحفظ نسب المصادر المطلوبة هنا؛ أما تخطيطات صفحات المزودين وأعمالهم الفنية فليست جزءًا من بيانات API.

التحديثات والتغطية المفقودة

تبحث فحوص المصدر اليومية عن التغييرات. ولا يثبت الفحص الناجح وحده وجود تواريخ جديدة. ويحافظ التحديث الفاشل على النشر المعتمد السابق؛ ويمنع سحب الاعتماد تقديمه.

تعيد التغطية المفقودة أو المسحوبة 503 calendar_coverage_unavailableيمكن لنقطة نهاية التاريخ أن تعيد عدم وجود مطابقات فقط ضمن سنة منشورة. تبحث نقطة النهاية التالية في السنة المطلوبة، ثم في السنة التالية عند الحاجة فقط. ولا تخمّن تواريخ غير منشورة.

اقرأ العقود الدقيقة · نظرة عامة على التقاويم