Skip to main content

Accurate Hijri-Gregorian dates converter based on the Umm al-Qura calendar

Project description


A Python package to convert accurately between Hijri and Gregorian dates using the Umm al-Qura calendar.

⚠️ Deprecation Notice

This package has been deprecated and will not receive future updates. Please use the hijridate package instead.

For migration to hijridate, install the package:

pip install hijridate~=2.3.0

Then change the import statement as:

from hijridate import Hijri, Gregorian


  • Accurate and verified date conversion.
  • Optimized code performance compared to similar packages.
  • Intuitive, clean, and easy-to-use interface.
  • Most of the methods and formats are similar to those of standard library.
  • Multilingual representation of weekday names, months, and calendar era notations.
  • Easily extendable to support other natural languages.
  • Rich comparison between dates.
  • Validation of input dates.
  • Works on Python 3.7+ with zero dependencies.
  • Thoroughly tested with 100% test coverage.


  • The date range supported by converter is limited to the period from the beginning of 1343 AH (1 August 1924 CE) to the end of 1500 AH (16 November 2077 CE).
  • The conversion is not intended for religious purposes where sighting of the lunar crescent at the beginning of Hijri month is still preferred.


To install using pip, run:

pip install hijri-converter

To install using conda, run:

conda install -c conda-forge hijri-converter

Basic Usage

from hijri_converter import Hijri, Gregorian

# Convert a Hijri date to Gregorian
g = Hijri(1403, 2, 17).to_gregorian()

# Convert a Gregorian date to Hijri
h = Gregorian(1982, 12, 2).to_hijri()


Please see for full documentation of this package, including background, benchmarking, usage examples and API reference.


This project is licensed under the terms of the MIT license.


  • R.H. van Gent — inspiration, scientific guidance and resources.
  • @AZalshehri7 — support in dates review and conversion accuracy verification.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hijri-converter-2.3.1.tar.gz (34.5 kB view hashes)

Uploaded source

Built Distribution

hijri_converter-2.3.1-py3-none-any.whl (14.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page