Afghanistan — Shamsi (Jalali) Calendar

Full Shamsi calendar support for Farsi (fa_IR) and Pashto (ps_AF) users

Developed by MCIT — Ministry of Communication and Information Technology  |  www.mcit.gov.af

✓ Odoo Community ✓ Odoo Enterprise

Overview

This module brings a fully language-aware Shamsi (Solar Hijri / Jalali) calendar to Odoo 17. It activates automatically when the user's language is set to Farsi (fa_IR) or Pashto (ps_AF), and leaves all other languages completely unchanged on the standard Gregorian calendar. No configuration needed — install and switch language.

📅 Date Picker — Jalali Month & Year Navigation

The date picker fully converts to Shamsi. Month names, year display, and year-range navigation all use Jalali values. Dari and Pashto month names switch automatically with the active language.

Dari — Month view (حمل ۱۴۰۵)

Pashto — Month view (کب ۱۴۰۴)

Year range view (Jalali decade)

🗂️ Kanban & List Views — Shamsi Dates Everywhere

All date fields in list and kanban views display in Shamsi. Invoice dates, due dates, and activity timestamps all convert automatically.

🔍 Custom Filters — Shamsi Date Input

Users enter dates in Shamsi format in custom filters. The filter chip in the search bar also displays the Shamsi date.

Custom filter dialog — Shamsi date input (۱۴۰۵/۰۱/۱۱)

Filter result with Shamsi date chip

📊 Group By — Jalali Year, Quarter, Month, Week, Day

Group By labels fully convert to Shamsi for both Dari and Pashto. Nested grouping (year → quarter → month → week → day) shows the correct Jalali label at every level in both languages.

Group By — Dari (ربع چهارم ۱۴۰۴، حوت، هفته)

Group By — Pashto (څلورمه ربع ۱۴۰۴، کب، اونۍ)

💬 Chatter & Log Notes — Shamsi Timestamps

All chatter messages, log notes, and activity entries display their timestamps in Shamsi — including the grouped date headers (e.g. حمل ۱۰ ۱۴۰۵). Works in both Dari and Pashto.

Chatter — Dari (حمل ۱۰ ۱۴۰۵)

Chatter — Pashto (کب ۱۸ ۱۴۰۴)

📄 PDF Reports — Shamsi Dates in Printed Documents

Built-in Odoo PDF reports (invoices, receipts, etc.) and custom QWeb reports automatically print dates in Shamsi format. The printed date always matches exactly what the user sees on screen.

📊 Excel Export — Shamsi Dates in Spreadsheets

Excel exports convert all date columns to Shamsi format automatically. Both the date column and separate Jalali date columns are supported.

📈 Charts & Pivot Tables — Shamsi Labels

Bar charts, pie charts, and pivot tables all display Shamsi date labels in their legends, axes, and row/column headers.

Bar chart — Shamsi date in legend (حمل ۱۰ ۱۴۰۵)

Pie chart — Shamsi labels

Pivot table — Jalali year & quarter rows

Afghan Month Names

Technical Notes

• No third-party Python libraries required. All Jalali date arithmetic is implemented in pure Python and JavaScript using the same algorithm — UI, PDF, and Excel always show identical dates.
• Compatible with Odoo 17.0.
• Activates only for fa_IR and ps_AF. All other languages remain on the Gregorian calendar, fully unaffected.
• Patches babel.dates.format_date for server-side formatting (PDF reports, group-by labels, pivot tables).
• Patches Luxon's DateTime.prototype.toFormat for all client-side date rendering.
• Invoice sequence numbering resets at Jalali New Year (Nowruz).

Installation

1. Download and extract the module to your Odoo custom_addons directory.
2. Restart the Odoo server.
3. Go to Apps, search for Afghanistan - Shamsi Calendar, and click Install.
4. Go to Settings → Users → Preferences and set your language to Persian (Afghanistan) or Pashto.
5. Refresh your browser — all dates now display in the Shamsi calendar.

License

This module is published under the OPL-1 (Odoo Proprietary License). A valid license is required for each production instance. Purchase your license on the Odoo App Store.

Support & Contact

Developed and maintained by the Ministry of Communication and Information Technology (MCIT), Afghanistan.