ENH: Persian date

[ShimaBeiranvand]

Feature Type

• Adding new functionality to pandas

• Changing existing functionality in pandas

• Removing existing functionality in pandas

Problem Description

Hello,
My name is Shima Beiranvand, and I am an AI engineer.

In our projects, we frequently work with databases that use the Jalali (Persian) calendar. However, the Pandas library cannot currently handle these dates because the earliest supported timestamp corresponds to the year 1677 in the Gregorian calendar, while the current Jalali year is 1404.

This limitation makes it difficult to work with datasets that include Jalali dates. I would be very grateful if Pandas could expand timestamp support or consider adding functionality to handle Jalali calendar dates.

Thank you for your time and consideration.

Best regards,
Shima Beiranvand

Feature Description

---

Alternative Solutions

---

Additional Context

No response

[jbrockmendel]

Do you have an example? Since 2.0 pandas supports non-nanosecond datetimes.

[jyup-escape]

Hi, I'd like to work on this enhancement.
Before starting an implementation, I would like to confirm the expected scope.
Should the Persian calendar support be:

• implemented inside pandas (e.g., as a new calendar in the Timestamp/DatetimeIndex API),
• or integrated via an optional dependency (e.g., using convertdate or similar libraries)?
  Also, should the goal be full round-trip support (parsing → conversion → formatting),
  or only parsing as a first step?
  I'll prepare a proposal once I get confirmation.
  Thanks!