Dear Frappe Team,
I am writing to request the addition of Persian (Shamsi) Calendar support to the core system of Frappe Framework / ERPNext. This feature would significantly enhance the usability of the platform for users in Iran and other regions that follow the solar Hijri calendar (e.g., Iran,Afghanistan, Tajikistan).
Why is this important?
- Many countries and organizations use the Persian (Shamsi) calendar for administrative, financial, and daily operations.
- Currently, users who rely on the Persian calendar have to either use workarounds or custom modules to handle dates, which can lead to inconsistencies and increased development effort.
- Adding native support for the Persian calendar in the core system would eliminate the need for separate customizations and provide a standardized solution for all users.
Proposed Solution
To implement Persian calendar support, I suggest integrating a robust and widely-used library for date handling. One excellent candidate is the Persian Datepicker Library provided by PersianWebToolkit . This library is:
- Compatible with modern web standards (supports HTML5, CSS3, and JavaScript).
- Easily customizable and provides both datepicker and date formatting functionalities.
- Well-maintained and has a large community of users.
Benefits
- Improved User Experience: Users in Persian-speaking regions can work with dates in their native calendar system.
- Reduced Customization Effort: Developers won’t need to create separate modules for Persian date handling.
- Alignment with Global Standards: Supporting multiple calendars aligns Frappe with international best practices for software localization.
Additional Resources
- Persian Datepicker Library: Getting Start - Persian Web Toolkit
- Persian Date Library (Jalali Date): GitHub - jalaali/jalaali-js: JavaScript functions for converting Jalaali and Gregorian calendar systems to each other
Next Steps
- If this feature is considered viable, I’m happy to collaborate with the community to help test or refine the implementation.
- I’d also be willing to contribute to documenting the process for future users.
Thank you for considering this request!
This addition would make Frappe an even more powerful and inclusive platform for global users.
How to Submit This Request:
- Go to the GitHub repository for Frappe Framework or ERPNext:
- Click on the “Issues” tab and then “New Issue” .
- Paste the above text (with your name/email if needed) and submit.