hijri-converter

[DEPRECATED] Use 'hijridate' package instead

hijri-converter v2.3.2.post1 2.7M downloads/30d#2,924 on PyPI

Permissive license MIT AGING released 2025-07-27

What it is and what it does

hijri-converter performs bidirectional conversion between Hijri and Gregorian calendar dates. It depends on hijridate, which is its own actively maintained successor package. The library provides Hijri and Gregorian classes for date manipulation and comparison.

The package is explicitly deprecated and will receive no further updates. Its documentation directs all new users to install hijridate instead, which offers identical API and functionality. Existing code using hijri-converter can migrate by changing only the import statement—the classes and methods remain the same.

Use it for:

Convert Gregorian dates to Hijri for Islamic calendar applications or localization.
Build date pickers or scheduling systems that support both Gregorian and Hijri calendars.
Parse or validate Hijri dates in data processing pipelines.
Display Islamic calendar dates in web or desktop applications serving Muslim users.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Converts between Hijri (Islamic) and Gregorian calendar dates. This package is deprecated; the actively maintained successor is hijridate.

No. Do not install hijri-converter. The package is deprecated (Development Status :: 7 - Inactive) and explicitly directs users to hijridate instead. If you need Hijri-Gregorian conversion, install hijridate directly—it has identical API and active maintenance. If you maintain legacy code using hijri-converter, plan a migration.

Install

hijri-converter on PyPI

pip

pip install hijri-converter

uv

uv add hijri-converter

poetry

poetry add hijri-converter

Installing hijri-converter

Before you install

Low install friction, but the package is marked inactive (Development Status :: 7 - Inactive) and explicitly deprecated. No updates are planned.

License in practice

MIT license permits commercial and private use with minimal restrictions, but this is moot given the package's deprecated status.

Quickstart

pip install hijri-converter==2.3.2.post1
from hijri_converter import Hijri, Gregorian
# Package is deprecated; migrate to hijridate instead

Package is deprecated and will not receive updates; hijridate is the recommended replacement with identical API.

Verify before relying

Whether existing deployments will continue to work or if migration to hijridate is urgent for your use case.
Security implications of using a package marked Development Status :: 7 - Inactive in production.

Package facts

License	MIT (permissive)
Python support	supports the current Python release (>=3.7)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — hijridate
Maintenance	aging — 383 days since the last release
First released	2019-06-05
Downloads	2,715,397/month — #2,924 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-14)