hijridate
Accurate Hijri-Gregorian dates converter based on Umm al-Qura calendar
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained, has zero dependencies, supports modern Python versions (3.10–3.14), carries no known vulnerabilities, and is licensed permissively under MIT. Install it if you need reliable Hijri-Gregorian conversion within the supported date range; the main constraint is the 1343–1500 AH window and the explicit non-suitability for religious crescent-sighting contexts.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; dates outside the range 1343 AH to 1500 AH are not supported.
- Low friction: pure Python wheel with zero runtime dependencies and active maintenance.
- Last release 220 days ago, repository actively maintained with recent commits.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution in commercial and private projects with minimal attribution requirements.
last release 2026-01-06 (220 days) · last repo commit 2026-08-06 · 87 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 3,064,675 downloads/mo, #2,769 on PyPI
Alternatives
Verify before relying
pip install hijridate
from hijridate import Hijri, Gregorian
# Convert Hijri to Gregorian
hijri = Hijri(1445, 6, 15)
gregorian = hijri.to_gregorian()
print(gregorian) # 2023-12-28
# Convert Gregorian to Hijri
gregorian = Gregorian(2023, 12, 28)
hijri = gregorian.to_hijri()
print(hijri) # 1445-06-15- Accuracy verification against sources beyond Umm al-Qura; whether religious/crescent-sighting use cases are supported despite the stated limitation.
- Performance characteristics and whether the package is suitable for high-volume batch conversions.
What it is and what it does
HijriDate is a Python library for converting dates between the Hijri Islamic calendar and the Gregorian calendar. It uses the Umm al-Qura calendar standard, which is the official calendar of Saudi Arabia and is based on astronomical calculations rather than lunar crescent sighting. The package supports dates from 1343 AH (1 August 1924 CE) to 1500 AH (16 November 2077 CE), corresponding to the period covered by official calendar sources.
The library provides bidirectional conversion: you can convert a Hijri date to Gregorian and vice versa. It includes comprehensive input validation, error handling, multilingual support for Arabic, English, Bengali, and Turkish, and rich comparison and formatting options. The package has zero runtime dependencies, full type annotations, and 100% test coverage, making it straightforward to integrate into applications that need accurate Islamic calendar handling.
Use it for
- Convert Hijri dates from Islamic documents, contracts, or historical records to Gregorian dates for international use.
- Generate Hijri dates for Islamic event scheduling, prayer time calculations, or Ramadan planning applications.
- Validate and normalize dates in systems serving users in Saudi Arabia or other regions using the Umm al-Qura calendar.
- Build multilingual calendar applications that display both Hijri and Gregorian dates to users in Arabic-speaking regions.
- Integrate date conversion into healthcare, legal, or government systems that must handle both calendar systems.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is actively maintained, has zero dependencies, supports modern Python versions (3.10–3.14), carries no known vulnerabilities, and is licensed permissively under MIT. Install it if you need reliable Hijri-Gregorian conversion within the supported date range; the main constraint is the 1343–1500 AH window and the explicit non-suitability for religious crescent-sighting contexts.
Install
hijridate on PyPI
Before you install
Low friction: pure Python wheel with zero runtime dependencies and active maintenance. Last release 220 days ago, repository actively maintained with recent commits.
Requires Python 3.10 or later; dates outside the range 1343 AH to 1500 AH are not supported.
License in practice
MIT license permits unrestricted use, modification, and distribution in commercial and private projects with minimal attribution requirements.
Quickstart
pip install hijridate
from hijridate import Hijri, Gregorian
# Convert Hijri to Gregorian
hijri = Hijri(1445, 6, 15)
gregorian = hijri.to_gregorian()
print(gregorian) # 2023-12-28
# Convert Gregorian to Hijri
gregorian = Gregorian(2023, 12, 28)
hijri = gregorian.to_hijri()
print(hijri) # 1445-06-15Verify before relying
- Accuracy verification against sources beyond Umm al-Qura; whether religious/crescent-sighting use cases are supported despite the stated limitation.
- Performance characteristics and whether the package is suitable for high-volume batch conversions.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 220 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 3,064,675 / month, #2,769 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: Healthcare IndustryIntended Audience :: Legal IndustryIntended Audience :: Science/ResearchNatural Language :: ArabicNatural Language :: BengaliNatural Language :: EnglishNatural Language :: TurkishOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Scientific/EngineeringTopic :: Software Development :: InternationalizationTopic :: Software Development :: LocalizationTopic :: UtilitiesTyping :: Typed |
Evidence: hijridate-2.6.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “umm al-qura calendar”
- hijridateConverts dates between the Hijri (Islamic) and Gregorian calendars…
- langchain-google-calendar-toolsIntegrates Google Calendar with LangChain to enable calendar…
- icalendarParses, creates, and modifies iCalendar files (RFC 5545 format) for…
Give your agent the search over MCP, or paste the wish link into any chat.
More Scientific/Engineering packages
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
pandas provides fast, flexible data structures (Series and DataFrame) for loading, cleaning, transforming, and analyzing labeled or relational data in Python.
scipy provides numerical algorithms for mathematics, science, and engineering—including optimization, integration, linear algebra, Fourier transforms, signal and image processing, and ODE solvers—built on numpy arrays.
scikit-learn provides a comprehensive Python library for supervised and unsupervised machine learning, including classification, regression, clustering, dimensionality reduction, and model evaluation tools built on NumPy and SciPy.
Install it if you need to train, evaluate, or deploy supervised or unsupervised learning models.
dill extends Python's pickle module to serialize and deserialize a much wider range of Python objects, including functions, lambdas, classes, and interpreter sessions, to byte streams for storage or network transmission.
Multiprocess is an enhanced fork of Python's standard multiprocessing library that uses dill for better serialization, allowing you to spawn processes with a threading-like API and share complex objects between them.
Install it if you use multiprocessing and encounter pickle serialization limits with lambdas or complex objects.
See also hijri-converter · ummalqura · convertdate · pyCalverter · bangla · pyluach · jdcal · jdatetime · korean-lunar-calendar · hdate