---
id: convertdate
version: "2.4.1"
license: The MIT License (MIT) Copyright (c) 2014-2022 Neil Freeman Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the… (full text in the JSON record)
license_treatment: permissive
maintenance: aging
---

# convertdate — Converts between Gregorian dates and other calendar systems

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

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

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

- License: The MIT License (MIT) Copyright (c) 2014-2022 Neil Freeman Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 4.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

calendar conversion, date conversion between calendars, hebrew gregorian date, islamic calendar converter, holiday calculation, julian calendar, alternative calendar systems, calendar-conversion, date-arithmetic, holiday-calculation

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