تخطٍّ إلى المحتوى
عاصم التويجري
اكتب للبحث
نشط

ummulqura-calendar — تقويم أم القرى

مكتبة PHP للتحويل الدقيق بين التاريخين الهجري والميلادي وفق جداول تقويم أم القرى الرسمية، بلا أي اعتماديات. مجانية ومفتوحة المصدر.

ummulqura-calendar — تقويم أم القرى

التقنيات

  • 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.

أمثلة على استخدام المكتبة في الطرفية، من التحويل إلى الهجري حتى صياغة التاريخ بالعربية
أمثلة على استخدام المكتبة في الطرفية، من التحويل إلى الهجري حتى صياغة التاريخ بالعربية
المشاريع