convertdate

What it is and what it does

Convertdate is a calendar-conversion library that translates dates between the Gregorian calendar and 15+ alternative systems: Armenian, Bahai, Coptic, French Republican, Hebrew, Indian Civil, Islamic, Julian, Mayan, Persian, Positivist, ISO, Ordinal, Dublin day count, and Julian day count. It also includes a holidays module for calculating dates of North American, Mexican, and Jewish holidays, plus Easter across Western, Orthodox, and Eastern Christian traditions.

The package handles edge cases like dates before the Common Era (using astronomical year notation where 1 BC = year 0), proleptic calendars for dates before their historical adoption, and calendar-specific leap-year rules. Each calendar module provides conversion functions and a monthcalendar() method to generate calendar grids. It is a pure-Python library with low install friction and no system dependencies.

Use it for:

• Convert user-submitted dates in Hebrew or Islamic calendars to Gregorian for storage or display in international applications.
• Calculate the date of Easter or other moveable holidays for scheduling or liturgical purposes across different Christian traditions.
• Generate calendar grids for historical or religious date pickers that need to display multiple calendar systems side-by-side.
• Compute Julian day numbers for astronomical calculations or long-term date arithmetic across calendar boundaries.
• Determine the nth occurrence of a weekday in a month (e.g., third Thursday) for scheduling recurring events.

Worth the install?

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

Converts dates between the Gregorian calendar and 15+ alternative calendar systems including Hebrew, Islamic, Julian, French Republican, Mayan, and others, plus calculates holidays across North American, Jewish, and other traditions.

Yes, if you need reliable calendar conversion or holiday calculation. The library is mature, permissively licensed, has no security vulnerabilities, and supports modern Python versions. The 'aging' maintenance status and 187 days since last release indicate stability rather than abandonment—suitable for stable calendar logic. Install only if you actually need multi-calendar support; the single pymeeus dependency is manageable.

Install

convertdate on PyPI

pip install convertdate

uv add convertdate

poetry add convertdate

Installing convertdate

Before you install

Low install friction; pure Python wheel with a single runtime dependency (pymeeus). Last commit 2026-02-08 and maintenance status 'aging' suggest the package is stable but not actively developed—suitable for stable calendar logic but not for rapid feature additions.

License in practice

MIT License (permissive) permits commercial and private use, modification, and redistribution with minimal restrictions—standard terms for a utility library.

Quickstart

pip install convertdate

from convertdate import hebrew, french_republican
print(hebrew.from_gregorian(2014, 10, 31))  # (5775, 8, 7)
print(french_republican.from_gregorian(2014, 10, 31))  # (223, 2, 9)

Verify before relying

• Accuracy and completeness of astronomical calculations for historical dates before the Common Era.
• Whether the single runtime dependency (pymeeus) is actively maintained and whether its updates could affect convertdate behavior.

Package facts

Evidence: convertdate-2.4.1-py3-none-any.whl

Keywords: calendar, date, time

Tags

More Astronomy packages