hijri-convert

Convert dates between the Islamic (Hijri) and Gregorian calendars, in both directions, with month names in English and Arabic. Pure Python, zero dependencies.

🌐 Live demo: https://khalidt.github.io/hijri-convert/

Install

pip install hijri-convert

Use it in Python

from hijri_convert import hijri_to_gregorian, gregorian_to_hijri

hijri_to_gregorian(1413, 4, 17)
# (1992, 10, 15, 'Thursday')   ->  year, month, day, weekday

gregorian_to_hijri(1992, 10, 15)
# (1413, 4, 17, 'Thursday')

Arguments are always in the order year, month, day.

Use it from the command line

After installing, a hijri-convert command is available:

# Hijri -> Gregorian
hijri-convert --to-gregorian 17/04/1413

# Gregorian -> Hijri
hijri-convert --to-hijri 15/10/1992

# Or run with no arguments for an interactive prompt
hijri-convert

Example output:

17/04/1413 AH  (17 Rabi al-Thani 1413 / ربيع الآخر)
  =  Thursday, 15/10/1992  (15 October 1992, Gregorian)

How it works

Conversion goes through the Julian Day Number (JDN), a calendar-neutral day count, so every conversion is just:

Hijri  <->  JDN  <->  Gregorian

This uses the tabular (arithmetic) Islamic calendar.

API

Hijri month names

Accuracy note

This library uses the tabular (arithmetic) Islamic calendar, which is consistent and reversible. Some countries determine month starts by moon sighting or by official almanacs such as Saudi Arabia's Umm al-Qura calendar, so a converted date may differ by ±1 day. For legal, religious, or official use, always check the relevant official calendar.

Development

git clone https://github.com/khalidt/hijri-convert
cd hijri-convert
pip install -e ".[test]"
pytest -v

License

© 2026 Khalid Alkhaldi

This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).

You are free to share and adapt the material for non-commercial purposes, as long as you give appropriate credit to Khalid Alkhaldi, link to the license, and distribute any derivative work under the same license. See the LICENSE file for the full terms.