hijri-converter 2.2.0

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

Hijri Converter

A Python package to convert accurately between Hijri and Gregorian dates based on astronomical calculation of the Umm al-Qura calendar.

Features

• Accurate and tested 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 notations.
• Easily extendable to support other natural languages.
• Rich comparison between dates.
• Validation of input dates.
• Works on Python 3.6+ with zero dependencies.
• Thoroughly tested on all supported python versions.

Limitations

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

Installation

pip install -U 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()

Documentation

Please see https://hijri-converter.readthedocs.io for full documentation of this package, including background, benchmarking, usage examples and API reference.

Changelog

All notable changes to this package are documented in CHANGELOG.md.

Contributing

Contributions are always welcome! See CONTRIBUTING.md for ways to get started.

Acknowledgements

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

License

This package is distributed under an MIT license. See LICENSE.