---
id: hijri-converter
version: "2.3.2.post1"
license: MIT
license_treatment: permissive
maintenance: aging
---

# hijri-converter — [DEPRECATED] Use 'hijridate' package instead

License: permissive · Maintenance: aging · Downloads: 2.7M/mo

## 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 above — 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

pip install hijri-converter
uv add hijri-converter
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_current
- Install friction: low
- Maintenance: aging
- Downloads: 2.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

hijri gregorian date conversion, islamic calendar converter, hijri date library, gregorian to hijri, hijri calendar python, deprecated, calendar-conversion

[View on SkillFed](https://skillfed.io/packages/hijri-converter) · [View on PyPI](https://pypi.org/project/hijri-converter/)