نشط
ummulqura-calendar — تقويم أم القرى
مكتبة PHP للتحويل الدقيق بين التاريخين الهجري والميلادي وفق جداول تقويم أم القرى الرسمية، بلا أي اعتماديات. مجانية ومفتوحة المصدر.
التقنيات
- PHP
مكتبة PHP للتحويل بين التاريخ الهجري والميلادي وفق تقويم أم القرى الرسمي. بداية كل شهر مأخوذة من الجداول المنشورة، فالتحويل بحث في جدول لا تقدير حسابي.
أبرز المزايا
- ٢١٩٦ شهرًا رسميًا مضمّنة في المكتبة، جُمعت من خدمة أم القرى الرسمية.
- النطاق المدعوم من ١٣١٨هـ إلى ١٥٠٠هـ (١٩٠٠–٢٠٧٧م).
- صياغة التواريخ بأسماء الأشهر والأيام بالعربية والإنجليزية، بأسلوب دالة
date()في PHP. - كما نُشر في وقته: للتواريخ قبل ١٤٢٠هـ، تعيد المكتبة ما طُبع في تقويم ذلك الوقت، وهو ما سُجّل في الهويات الوطنية، إلى جانب قراءة الخدمة الرسمية الحالية.
- بلا أي اعتماديات وبلا إطار عمل، وتحتاج PHP 8.1 أو أحدث.
مثال
use AsimNet\UmmulquraCalendar\UmmAlQura;
$eid = UmmAlQura::toHijri(new DateTimeImmutable('2026-03-20'));
$eid->toIsoString(); // "1447-10-01"
$eid->toArabicString(); // "1 شوال 1447هـ"
UmmAlQura::monthLength(1447, 9); // 30 — أيام رمضان 1447
التثبيت
composer config repositories.ummulqura-calendar vcs https://github.com/AsimNet/ummulqura-calendar
composer require asimnet/ummulqura-calendar
بنيتُها لتكون أساس منتقي التاريخ الهجري لإطار FilamentPHP.