Hijri Calendar API

Convert between Gregorian and Hijri calendars, get important Islamic dates, and access Arabic month and day names. Supports bidirectional conversion and important dates lookup.

Convert Date

Convert a Gregorian date to Hijri or get important dates for a Hijri year.

GET/v1/hijri

Query Parameters

NameTypeRequiredDescription
datestringOptionalGregorian date in YYYY-MM-DD format (default: today)
yearintegerOptionalHijri year for important dates lookup
latfloatOptionalLatitude for timezone detection
lngfloatOptionalLongitude for timezone detection
tzstringOptionalIANA timezone

Example Request

curl "https://api.falakapi.com/v1/hijri?date=2025-01-15" \
  -H "X-API-Key: fak_your_api_key_here"

Example Response

{
  "gregorian": {
    "date": "2025-01-15",
    "day": 15,
    "month": 1,
    "year": 2025,
    "weekday": "Wednesday"
  },
  "hijri": {
    "date": "1446-07-14",
    "day": 14,
    "month": 7,
    "year": 1446,
    "month_name": "Rajab",
    "month_name_ar": "رجب",
    "weekday": "Wednesday",
    "weekday_ar": "الأربعاء"
  }
}

Notes

  • Bidirectional conversion: Gregorian ↔ Hijri
  • Includes Arabic month and day names
  • Supports important Islamic dates lookup by year
  • Uses algorithmic calendar (not observational)

Hijri Months

NumberEnglish NameArabic NameNotes
1MuharramمحرمSacred month
2Safarصفر-
3Rabi' al-Awwalربيع الأول-
4Rabi' al-Thaniربيع الثاني-
5Jumada al-Ulaجمادى الأولى-
6Jumada al-Thaniجمادى الثانية-
7RajabرجبSacred month
8Sha'banشعبان-
9RamadanرمضانFasting month
10ShawwalشوالEid al-Fitr
11Dhul Qi'dahذو القعدةSacred month
12Dhul Hijjahذو الحجةSacred month, Hajj, Eid al-Adha