convertdate
Converts between Gregorian dates and other calendar systems
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
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 · maintenance · safety
permissive license (permissive) — MIT License (permissive) permits commercial and private use, modification, and redistribution with minimal restrictions—standard terms for a utility library.
last release 2026-02-08 (187 days) · last repo commit 2026-02-08 · 53 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 4,360,640 downloads/mo, #2,322 on PyPI
Alternatives
Verify before relying
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)- 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.
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 on it.
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
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 | permissive license permissive |
| Python support | Supports the current Python release <4,>=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagepymeeus |
| Maintenance | Aging 187 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 4,360,640 / month, #2,322 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: ReligionTopic :: Scientific/Engineering :: Astronomy |
Evidence: convertdate-2.4.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “date conversion between calendars”
- convertdateConverts dates between the Gregorian calendar and 15+ alternative…
- pyCalverterConverts between different calendar systems, allowing date…
- pyluachConverts between Hebrew and Gregorian calendar dates, calculates date…
Give your agent the search over MCP, or paste the wish link into any chat.
More Astronomy packages
Albumentations applies image transformations to training data, supporting classification, segmentation, object detection, and pose estimation with a unified API for images, masks, bounding boxes, and keypoints.
Install it if you need a unified, production-grade augmentation API for computer vision tasks.
Converts between Julian dates and Gregorian or Julian calendar dates, storing Julian dates as pairs of floating-point numbers for maximum precision.
However, be aware that it will not receive bug fixes or updates—verify that its behavior matches your requirements before committing to it in a production system.
PyERFA wraps the ERFA C library (Essential Routines for Fundamental Astronomy) as NumPy universal functions, exposing key astronomy algorithms for scalar or array inputs.
Install it if you need fundamental astronomy calculations or if another package depends on it.
PyMeeus implements astronomical algorithms from Jean Meeus's classical reference, providing Python classes for computing celestial positions, lunar phases, planetary phenomena, and time conversions with minimal dependencies.
However, verify Python version compatibility first and consider whether other libraries better suit production-grade use cases.
PyEphem computes high-precision positions of planets, moons, stars, comets, and asteroids in the sky for any observer location and date, using C-based numeric routines from the XEphem astronomy application.
Adds a quaternion dtype to NumPy, enabling efficient quaternion arithmetic and array operations with native NumPy integration.
See also pyCalverter · pyluach · yearfrac · bangla · ummalqura · hdate · hijridate · epiweeks · lunardate