---
id: ummalqura
version: "2.0.1"
license: Waqef
license_treatment: unclear
maintenance: abandoned
---

# ummalqura — Python Hijri Ummalqura

License: unclear · Maintenance: abandoned · Downloads: 476.5K/mo

## What it is and what it does

ummalqura is a Python library for bidirectional conversion between Gregorian and Hijri (Islamic) calendar dates. It provides localized month and day names in both Arabic and English, along with utility methods to query Hijri dates for specific calendar boundaries and current dates.

The package wraps date conversion logic into a HijriDate class that accepts either Gregorian or Hijri dates as input and exposes properties for retrieving the equivalent date in the other calendar system. It has no runtime dependencies, making installation straightforward, but the project has been unmaintained since its final release on 2017-12-26.

Use it for:

- Convert user-submitted Gregorian dates to Hijri equivalents for Islamic calendar applications or localized interfaces.
- Display Hijri month and day names in Arabic for applications serving Arabic-speaking users.
- Query the start and end dates of a given Hijri month for scheduling or calendar planning features.
- Retrieve current Hijri date and month for real-time Islamic calendar displays or event tracking.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts between Gregorian and Hijri calendar dates, returning day and month names in Arabic and English.

No. The package is abandoned (last update 2017-12-26), has an unclear license ('Waqef' with no SPDX mapping), and carries high install friction. While it has no known vulnerabilities and no dependencies, the lack of maintenance and legal clarity make it unsuitable for production use. Consider a maintained alternative for Hijri calendar conversion.

## Install

pip install ummalqura
uv add ummalqura
poetry add ummalqura

## Installing ummalqura

Before you install: High install friction and abandoned maintenance status since 2017-12-26. The package has not been updated since its final release, with no active development or support.

License in practice: License is listed as 'Waqef' with no SPDX mapping, making its legal treatment unclear. Users should verify compatibility with their project's licensing requirements before use.

Quickstart:

from ummalqura.hijri_date import HijriDate
from datetime import date

# Convert Gregorian to Hijri
um = HijriDate(2017, 12, 26, gr=True)
print(um.month, um.year)  # 4 1439
print(um.day_name, um.month_name)  # الثلاثاء ربيع الثاني

# Convert Hijri to Gregorian
gregorian = HijriDate.get_georing_date('1439-04-08')
print(gregorian)  # 2017-12-26

Verify before relying:

- Whether 'Waqef' is a recognized open-source license and what restrictions it imposes
- Python version compatibility (requires_python is unspecified in metadata)
- Accuracy of Hijri conversion algorithm relative to current Islamic calendar standards

## Package facts

- License: Waqef (unclear)
- Python support: unspecified
- Install friction: high
- Maintenance: abandoned
- Downloads: 476.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

gregorian to hijri conversion, hijri calendar converter, islamic calendar date, hijri date python, gregorian hijri calendar, arabic calendar converter, ummalqura calendar, calendar-conversion, hijri-calendar, localization

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