تخطي إلى المحتوى
🗓️⚙️

واجهة برمجية مجانية للتاريخ الهجري (API)

حوّل بين الهجري والميلادي بتقويم أم القرى الرسمي — JSON بسيط، بدون مفتاح، CORS مفتوح.

⚡ جرّبه الآن

تاريخ اليوم مباشرة من الواجهة:

جارٍ التحميل…
GET /api/date ↗

📡 نقاط النهاية

الطلب الوصف
GET /api/date تاريخ اليوم (هجري + ميلادي) بتوقيت الرياض
GET /api/date?date=2026-06-11 تحويل ميلادي ← هجري
GET /api/date?date=1447-12-26&calendar=hijri تحويل هجري ← ميلادي

المعاملات

  • date — بصيغة YYYY-MM-DD (اختياري؛ الافتراضي اليوم)
  • calendar — "gregorian" (افتراضي) أو "hijri" — تقويم التاريخ المُدخل

💻 أمثلة برمجية

JavaScript (fetch)

fetch('https://hijri-calendars.com/api/date')
  .then(r => r.json())
  .then(d => console.log(d.hijri.formatted)); // "26 Dhul-Hijjah 1447 AH"

cURL

curl "https://hijri-calendars.com/api/date?date=1447-12-26&calendar=hijri"

PHP

$d = json_decode(file_get_contents('https://hijri-calendars.com/api/date?date=2026-06-11'), true);
echo $d['hijri']['formatted_ar']; // "٢٦ ذو الحجة ١٤٤٧ هـ"

🤝 الاستخدام العادل والإسناد

الواجهة مجانية للاستخدام الشخصي والتجاري. نرجو ذكر المصدر برابط إلى hijri-calendars.com عند العرض العلني، وتخزين النتائج مؤقتاً لديك بدلاً من الاستدعاء المتكرر لنفس التاريخ.

❓ أسئلة شائعة

هل الواجهة مجانية؟

نعم، بدون مفتاح أو تسجيل — فقط اذكر المصدر برابط.

ما التقويم المستخدم؟

أم القرى الرسمي (islamic-umalqura) عبر مكتبة ICU.

ما النطاقات المدعومة؟

ميلادي 1900–2200، هجري 1300–1600هـ.

🔗 أدوات ذات صلة

🔄 محول التاريخ 📅 تاريخ اليوم 🧩 ودجات للتضمين