قائمة مختصرة بالمزوّدين
كل الأرقام مأخوذة من صفحات كل مزود، وقد قرأناها في 3 نوفمبر 2026. أما من يُدفع له وكم في يوم العطلة فيحدده قانون العمل وعقودك، ولا تجيب عنه أي API. تملك شركة Nusantara Ventures, LLC واجهة Narwhal API وتديرها.
واجهة Narwhal API
لحساب الرواتب في الدول الـ 37 المغطاة، حين تشترك أسعار الصرف والبيانات الاقتصادية وMCP في المفتاح نفسه.
Calendarific
بداية شهرية رخيصة مع تفاصيل المناطق وأنواع العطل عبر قائمة دول واسعة جدًا.
HolidayAPI
مناسب لرواتب متعددة الدول تحتاج إلى التواريخ المرصودة وحساب أيام العمل وحق الاحتفاظ بالنتائج.
Nager.Date
مناسب للنماذج الأولية والأدوات الداخلية حيث تكفي API مستضافة مجانية بلا مفتاح ولا حد معلن للمعدل.
Abstract API
مناسب للفرق التي تستخدم أصلًا واجهات Abstract الأخرى وتريد نقطة نهاية واحدة للعطل تتضمن مدخلات إقليمية.
date-holidays
مناسب لمحركات الرواتب بـ Node.js التي تريد قواعد العطل داخل العملية، بلا حصة ولا استدعاء شبكي.
خدمات Federal Reserve Financial Services
مناسب لتحريك تواريخ صرف الرواتب بالإيداع المباشر في الولايات المتحدة بعيدًا عن أيام إغلاق بنوك الاحتياطي.
قارن الخيارات
كون المزوّد الأنسب لا يعني تكافؤ الميزات. تحقق من الأدلة والقيود معًا.
| المزود | الأفضل لـ | الأدلة التي جرى التحقق منها | قيد مهم |
|---|---|---|---|
| واجهة Narwhal API | لحساب الرواتب في الدول الـ 37 المغطاة، حين تشترك أسعار الصرف والبيانات الاقتصادية وMCP في المفتاح نفسه. | مصادر حكومية رسمية. تتيح البحث حسب السنة وحسب التاريخ وعن العطلة التالية، مع النطاق والاسم المحلي ورموز التقسيمات الفرعية. يحصل كل حساب على رصيد مجاني قدره $10 شهريًا، مع السماح باستخدام التطبيقات التجارية. | عدد الدول أقل بكثير من المزودين الكبار. لا تحمل الاستجابات التي قرأناها حقلًا للتاريخ المرصود، وتُحسب أيام العمل في شيفرتك أنت. |
| Calendarific | بداية شهرية رخيصة مع تفاصيل المناطق وأنواع العطل عبر قائمة دول واسعة جدًا. | أكثر من 230 دولة وأكثر من 3,300 منطقة، مع مرشحات المواقع بمعيار ISO 3166-2 في كل الخطط. تبدأ Starter بـ $12 شهريًا أو $100 سنويًا مقابل 10,000 استدعاء. | لا يوجد حقل للتاريخ المرصود ولا أداة لأيام العمل في الوثائق. خطة Free تتيح 500 استدعاء مع اشتراط الإسناد، وتُحدَّث بيانات Free وStarter كل ربع سنة. |
| HolidayAPI | مناسب لرواتب متعددة الدول تحتاج إلى التواريخ المرصودة وحساب أيام العمل وحق الاحتفاظ بالنتائج. | 250 دولة، وتواريخ مرصودة، ونقطتا النهاية /workday و/workdays، وسنوات من 1 إلى 2050 وما بعدها. تكلف Countries $249 سنويًا مقابل 1,000,000 طلب شهريًا، مع الاستخدام التجاري والتخزين دون اتصال. | الفوترة سنوية فقط. تحتاج العطل الإقليمية إلى خطة States & Provinces بسعر $399 سنويًا، ولم يُنشر حد الطلبات للخطة المجانية. |
| Nager.Date | مناسب للنماذج الأولية والأدوات الداخلية حيث تكفي API مستضافة مجانية بلا مفتاح ولا حد معلن للمعدل. | شيفرة بترخيص MIT، و204 دول في نقطة نهاية الدول المتاحة، وستة أنواع من العطل منها Bank، ومناطق من المستوى الأول. أعاد اختبارنا السنوات من 2025 إلى 2031. | تشترط الشروط رعاية فعلية للاستخدام التجاري دون ذكر مبلغ. تُستثنى تواريخ العيد، وبعض التواريخ موسومة بأنها تقريبية أو مبدئية. |
| Abstract API | مناسب للفرق التي تستخدم أصلًا واجهات Abstract الأخرى وتريد نقطة نهاية واحدة للعطل تتضمن مدخلات إقليمية. | أكثر من 190 دولة وأكثر من 3,500 منطقة، وسنوات من 1 م إلى ما بعد 2050. تتيح Free 1,000 طلب بمعدل طلب واحد في الثانية، وتكلف Standard $99 شهريًا بالفوترة السنوية. | لا تُذكر الشروط التجارية. تقول إحدى الصفحات إن البيانات تُراجع أسبوعيًا وتقول أخرى شهريًا، وتذكر الوثائق روسيا بالرمز RE والباهاما بالرمز BH. |
| date-holidays | مناسب لمحركات الرواتب بـ Node.js التي تريد قواعد العطل داخل العملية، بلا حصة ولا استدعاء شبكي. | 207 دول، ومناطق بمعيار ISO 3166-2، وخمسة أنواع من العطل، وعلامة لليوم البديل، ودالة isHoliday(date). نُشر الإصدار 3.38.0 في 24 أكتوبر 2026. | عليك نشر التحديثات بنفسك. البيانات بترخيص CC BY-SA 3.0 مع شرط ShareAlike، وتذكر بيانات npm الوصفية سلسلة ترخيص مختلفة، فراجع الشروط قبل تخزين بيانات مشتقة. |
| خدمات Federal Reserve Financial Services | مناسب لتحريك تواريخ صرف الرواتب بالإيداع المباشر في الولايات المتحدة بعيدًا عن أيام إغلاق بنوك الاحتياطي. | جدول FedCash للفترة 2026 إلى 2030، وجدول FedACH بأوقات انتهاء المعالجة واستئنافها. إذا صادفت العطلة يوم السبت تبقى البنوك مفتوحة يوم الجمعة السابق. | صفحة ويب وليست API، وتغطي أنظمة الدفع بالدولار الأمريكي فقط. انسخ التواريخ إلى جدولك الخاص. |
اختر حسب الحاجة
حين تصادف العطلة عطلة نهاية الأسبوع
لا يوثق اليوم المنقول سوى مصدرين. تعيد HolidayAPI تاريخًا مرصودًا يختلف عن التاريخ الأصلي حين تصادف العطلة عطلة نهاية الأسبوع. وتضع date-holidays علامة substitute على اليوم البديل. أما Nager.Date وCalendarific وAbstract فلا توثق حقلًا كهذا، ولا تحمله استجابات Narwhal التي قرأناها. وسواء دُفع للموظفين يوم الجمعة السابق أو يوم الإثنين التالي فهذا قرار سياستك، فاحتفظ بهذه القاعدة في جدول بجوار قائمة العطل.
العطل الإقليمية
تقبل Calendarific رموز ISO 3166-2 مثل us-ny أو de-by في جميع الخطط. أما HolidayAPI فتحتاج لذلك إلى خطة States & Provinces بسعر $399 سنويًا. يتوقف Nager.Date عند المستوى الأول، فيعرض Epiphany للرموز DE-BW وDE-BY وDE-ST دون أي تفصيل أدق من الولاية. وتتبع date-holidays معيار ISO 3166-2. تحمل مدخلات Narwhal رموز التقسيمات الفرعية، لكن تحقق من حقل coverage لكل دولة قبل الاعتماد على المناطق.
عطل البنوك والعطل الرسمية والمناسبات
غالبًا ما تُصرف الرواتب في العطل الرسمية وتُتجاهل المناسبات، لذا يهم حقل type. يضم Nager.Date ستة أنواع منها Bank وSchool وOptional، وتضم date-holidays خمسة. وتقدم Calendarific أربع فئات ومرشح type في كل الخطط. وتضبط HolidayAPI حقل public على true أو false، وتستخدم Abstract نصًا حرًا. أما Narwhal فتسم كل مدخل بنطاق مثل federal government أو national public.
كم سنة قادمة تتاح
يحتاج احتساب الإجازات وتخطيط الورديات إلى تقويم العام القادم مبكرًا. تصل HolidayAPI وAbstract معًا إلى 2050 وما بعدها. أعاد اختبارنا لـ Nager.Date السنوات من 2025 إلى 2031 وخطأ خارج هذه النافذة. وتقول Calendarific إنها تدعم السنوات الماضية والمستقبلية دون ذكر رقم. أما date-holidays فتحسب من القواعد دون نطاق ثابت. تأخذ Narwhal السنة في المسار، لذا اختبر السنوات التي تحتاجها لكل دولة أولًا.
تخزين النتائج
تتيح خطط HolidayAPI المدفوعة التخزين دون اتصال طوال مدة الاشتراك، بينما تقيّده Free بـ 24 ساعة. تمنع شروط Nager.Date تشغيل بوابة عطل خاصة بك وتطلب من المستخدمين التجاريين الرعاية. تنص Calendarific على عدم وجود قيود وتشترط الإسناد في Free. وبيانات date-holidays بترخيص CC BY-SA 3.0. وتلتزم Abstract الصمت. تشمل Narwhal الاستخدام التجاري للتطبيقات في كل حساب، فاقرأ صفحة الأسعار والشروط بشأن التخزين قبل أن تخزّن النتائج مؤقتًا.
حين ينفد الرصيد أو الحصة
تعيد Narwhal الرمز 402 insufficient_credits ولا تفرض رسوم تجاوز ولا تحسب الأخطاء، ويُعاد ملء الرصيد المجاني في أول كل شهر. أما Calendarific فتحسب كل طلب بما فيه الأخطاء وتجيب بـ 429 rate_limit_exceeded. وتعيد Abstract Free الرمز 422 عند نفاد الرصيد. وتُعاد ضبط خطط HolidayAPI المدفوعة في الأول من الشهر عند 00:00 UTC. وجلب سنة واحدة لكل دولة مرة واحدة يكلف 37 استدعاء في كل دول Narwhal، أي نحو $0.07.
التكلفة لكل 1,000 استدعاء
سعر الخطة مقسومًا على الاستدعاءات المشمولة ثم مضروبًا في 1,000. تُسعَّر Narwhal Calendars لكل استدعاء بـ $2 لكل 1,000 دون خطة نقسم عليها. تبلغ Calendarific Starter $12 / 10,000 = $1.20 شهريًا، أو نحو $0.83 في الخطة السنوية بـ $100. وتبلغ HolidayAPI Countries $249 / 12 شهرًا / 1,000,000، أي نحو $0.02. وتبلغ Abstract Standard كما هي مطبوعة، $99 شهريًا مقابل 60,000 طلب في السنة، $1,188 / 60,000 = $19.80. تأكد من هذه الوحدة.
أدوات التحقق من العطلة وأيام العمل
تقدم HolidayAPI /workday الذي يعيد التاريخ بعد N يوم عمل من نقطة البداية، و/workdays الذي يحسب أيام العمل بين تاريخين. ولدى Nager.Date استدعاء للعطلة التالية وفحص لعطلة اليوم. ولدى date-holidays الدالة isHoliday(date). ولا تملك Calendarific وAbstract شيئًا من ذلك. أما Narwhal فلديها استعلام بالتاريخ واستدعاء للعطلة التالية، وتُحسب أيام العمل في شيفرتك كما يبين دليل التسوية لديها. وهي أيضًا الوحيدة هنا التي وجدنا فيها MCP: 80 أداة بمفتاح واحد.
العطل الإسلامية والمتحركة
تعتمد تواريخ العيد على رؤية الهلال. يستثني Nager.Date عيد الفطر وعيد الأضحى (Eid al-Fitr وEid al-Adha) من مشروعه ويصف التواريخ المبنية على التقويم الهجري بأنها تقريبية قد تتغير بيوم أو يومين. فللموظفين في تلك الدول استخدم مصدرًا يتبع إعلان الحكومة. تقرأ Narwhal المصادر الحكومية الرسمية، وتتضمن أدوات MCP لديها تحويل التاريخ الهجري. تحقق من كل دولة تدفع فيها قبل أن تعد الموظفين بتاريخ.
تواريخ الدفع وإغلاق البنوك
لا تخبرك قائمة العطل الرسمية متى ينقل البنك ملفك. وفي الإيداع المباشر الأمريكي ينشر الاحتياطي الفيدرالي جدول FedACH بأوقات انتهاء المعالجة واستئنافها. إذا صادفت العطلة يوم السبت تبقى بنوك الاحتياطي مفتوحة يوم الجمعة السابق، وإذا صادفت يوم الأحد تغلق يوم الإثنين التالي. تعامل مع هذا الجدول كمدخل ثانٍ بجانب API العطل ثم احسب رجوعًا من تاريخ الدفع.
كل صفحة مفصلة لمزود الخدمة توضح الوثائق الرسمية المستخدمة، وحدود الأدلة، وتاريخ المراجعة. تمت المراجعة: