jdatetime
Jalali datetime binding for python
Decision gist · record as of 2026-08-14
Yes. jdatetime is actively maintained, has no known vulnerabilities, installs with minimal friction, and fills a clear need for Persian calendar support. The permissive PSF-2.0 license and support for modern Python versions make it a safe choice for production use in applications serving Iranian users or handling Jalali dates.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later.
- Low friction installation with a single runtime dependency (jalali-core).
- The project is actively maintained with a recent release and steady commit activity.
License · maintenance · safety
PSF-2.0 (permissive) — Licensed under PSF-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.
last release 2026-08-10 (4 days) · last repo commit 2026-08-10 · 391 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 357,907 downloads/mo, #7,266 on PyPI
Alternatives
Verify before relying
pip install jdatetime
import jdatetime
# Get current Jalali date and time
print(jdatetime.datetime.now())
print(jdatetime.date.today())
# Convert from Gregorian
gregorian_date = jdatetime.date.fromgregorian(day=1, month=1, year=1)
print(gregorian_date)- Whether locale support works reliably across all supported Python versions.
- Performance characteristics when handling large volumes of date conversions or arithmetic operations.
- Thread-safety guarantees for the per-thread locale setting mechanism mentioned in the documentation.
What it is and what it does
jdatetime is a drop-in Jalali calendar replacement for Python's datetime module, designed for applications that need to work with the Iranian calendar system. It provides date and datetime objects that behave identically to their standard library counterparts, but represent dates in the Jalali calendar instead of the Gregorian calendar. The package includes bidirectional conversion between Gregorian and Jalali dates, leap-year detection, and locale support for displaying dates in Farsi.
The library is built on top of jalali-core and follows Python's datetime API closely, so developers familiar with the standard library can use it with minimal learning curve. It supports per-instance and process-wide locale configuration, making it suitable for applications that need to display dates in both English and Farsi, or that serve users in different locales within the same process.
Use it for
- Build applications for Iranian users that display dates in the Jalali calendar and Farsi language.
- Convert between Gregorian and Jalali dates when integrating with systems that use both calendar systems.
- Schedule events and store timestamps using the Iranian calendar in databases or APIs.
- Generate reports or invoices with dates formatted in the Jalali calendar for Persian-speaking markets.
- Handle date arithmetic while staying within the Jalali calendar system.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
jdatetime is actively maintained, has no known vulnerabilities, installs with minimal friction, and fills a clear need for Persian calendar support. The permissive PSF-2.0 license and support for modern Python versions make it a safe choice for production use in applications serving Iranian users or handling Jalali dates.
Install
jdatetime on PyPI
Before you install
Low friction installation with a single runtime dependency (jalali-core). The project is actively maintained with a recent release and steady commit activity.
Requires Python 3.9 or later.
License in practice
Licensed under PSF-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.
Quickstart
pip install jdatetime
import jdatetime
# Get current Jalali date and time
print(jdatetime.datetime.now())
print(jdatetime.date.today())
# Convert from Gregorian
gregorian_date = jdatetime.date.fromgregorian(day=1, month=1, year=1)
print(gregorian_date)Verify before relying
- Whether locale support works reliably across all supported Python versions.
- Performance characteristics when handling large volumes of date conversions or arithmetic operations.
- Thread-safety guarantees for the per-thread locale setting mechanism mentioned in the documentation.
Package facts
| License | PSF-2.0 permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagejalali-core |
| Maintenance | Actively maintained 4 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 357,907 / month, #7,266 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersIntended Audience :: System AdministratorsOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9Topic :: Software Development |
Evidence: jdatetime-6.1.0-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 › “jalali calendar datetime”
- jdatetimejdatetime provides a Jalali (Persian) calendar implementation that…
- fiscalyearProvides fiscal year, quarter, month, and day abstractions that…
- zhdateConverts between Chinese lunar calendar dates and Gregorian datetime…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also pyCalverter · ummalqura · convertdate · jdcal · hijridate · zhdate · hijri-converter · lunardate · pendulum · datedelta