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., 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.
Key Components to Implement
Date Input Fields:
Add a toggle option in the settings to switch between Gregorian and Persian calendars for date fields.
Use the Persian Datepicker Library to render Persian datepickers when the user selects this option.
Date Formatting:
Update date formatting functions in the core to support Persian calendar dates (e.g., converting Gregorian dates to Persian format and vice versa).
Date Calculations:
Ensure that date calculations (e.g., date differences, deadlines) work correctly in both Gregorian and Persian calendar systems.
Localization:
Add Persian month names and localization strings to the core system for reports, notifications, and user interfaces.
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: https://babakhani.github.io/PersianWebToolkit/doc/datepicker/
Persian Date Library (Jalali Date): https://github.com/jalaali/jalaali-js
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.
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., 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.
Key Components to Implement
Date Input Fields:
Add a toggle option in the settings to switch between Gregorian and Persian calendars for date fields.
Use the Persian Datepicker Library to render Persian datepickers when the user selects this option.
Date Formatting:
Update date formatting functions in the core to support Persian calendar dates (e.g., converting Gregorian dates to Persian format and vice versa).
Date Calculations:
Ensure that date calculations (e.g., date differences, deadlines) work correctly in both Gregorian and Persian calendar systems.
Localization:
Add Persian month names and localization strings to the core system for reports, notifications, and user interfaces.
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: https://babakhani.github.io/PersianWebToolkit/doc/datepicker/
Persian Date Library (Jalali Date): https://github.com/jalaali/jalaali-js
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.