/* Support for the Persian solar Hijri calendar (used in Iran). Copyright (C) 2025-2026 Free Software Foundation, Inc. This file is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This file is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this program. If not, see . */ /* Written by Bruno Haible , 2025. */ /* Reference: https://en.wikipedia.org/wiki/Solar_Hijri_calendar More info regarding the leap years: Some online date converters and also Emacs (cal-persia.el) get the leap years wrong: they pretend that year 1403 is a non-leap year and that 1404 is a leap year. The correct info, based on https://fa.wikipedia.org/wiki/%DA%AF%D8%A7%D9%87%E2%80%8C%D8%B4%D9%85%D8%A7%D8%B1%DB%8C_%D8%B1%D8%B3%D9%85%DB%8C_%D8%A7%DB%8C%D8%B1%D8%A7%D9%86 and https://github.com/movahhedi/persian-leap , is that the following years are leap years: 1276, 1280, 1284, 1288, 1292, 1296, 1300, 1304, 1309, 1313, 1317, 1321, 1325, 1329, 1333, 1337, 1342, 1346, 1350, 1354, 1358, 1362, 1366, 1370, 1375, 1379, 1383, 1387, 1391, 1395, 1399, 1403, 1408, 1412, 1416, 1420, 1424, 1428, 1432, 1436, 1441, 1445, 1449, 1453, 1457, 1461, 1465, 1469, 1474, 1478, 1482, 1486, 1490, 1494, 1498. This is consistent with the table in https://en.wikipedia.org/wiki/Solar_Hijri_calendar#Comparison_with_Gregorian_calendar */ static const struct calendar_month_name persian_month_names[12] = { /* Farvardin */ { "فروردین", "فروردین" }, /* Ordibehesht */ { "اردیبهشت", "اردیبهشت" }, /* Khordad */ { "خرداد", "خرداد" }, /* Tir */ { "تیر", "تیر" }, /* Mordad */ { "مرداد", "مرداد" }, /* Shahrivar */ { "شهریور", "شهریور" }, /* Mehr */ { "مهر", "مهر" }, /* Aban */ { "آبان", "آبان" }, /* Azar */ { "آذر", "آذر" }, /* Dey */ { "دی", "دی" }, /* Bahman */ { "بهمن", "بهمن" }, /* Esfand */ { "اسفند", "اسفند" }, }; static int gregorian_to_persian (struct calendar_date *result, int greg_year, int greg_month, int greg_day) { if ((greg_year > 1925 && greg_year < 1975) || (greg_year > 1978 && greg_year < 2100)) { /* Simplify leap year calculations by considering year start March 1. */ greg_month -= 2; if (greg_month < 0) { greg_month += 12; greg_year -= 1; } int greg_days_since_march_1 = /* greg_month 0 1 2 3 4 5 6 7 8 9 10 11 days 0 31 61 92 122 153 184 214 245 275 306 337 */ ((greg_month * 153 + 2) / 5) + (greg_day - 1); int greg_days_since_1900_march_1 = (greg_year - 1900) * 365 + ((greg_year - 1900) / 4) - ((greg_year - 1900) / 100) + ((greg_year - 1600) / 400) + greg_days_since_march_1; /* The Hijri calendar currently uses 33-year cycles of 12053 days each (8 leap years and 25 non-leap years). For our purposes, let's define the start of such a cycle as the beginning of the year that follows the leap year that follows the 4 non-leap years: 1931-03-22, 1964-03-21, 1997-03-21, 2030-03-21, 2063-03-21, 2096-03-20, ... */ int cycle33_number = (greg_days_since_1900_march_1 + 710) / 12053; int days_since_cycle33_start = (greg_days_since_1900_march_1 + 710) % 12053; /* In such a 33-year cycle, the days after a leap year end are at days 0, 1461, 2922, 4383, 5844, 7305, 8766, 10227; these are the multiples of 1461. We call the period that starts with 3 or 4 non-leap years and ends with a leap year a "leap cycle". Thus these 8 days are the beginning of the 8 leap cycles in the 33-year cycle. */ int leap_years_since_cycle33_start = days_since_cycle33_start / 1461; if (leap_years_since_cycle33_start > 7) leap_years_since_cycle33_start = 7; int is_last_day_of_leap_year = (((days_since_cycle33_start + 1) % 1461) == 0 && days_since_cycle33_start <= 10227) || (days_since_cycle33_start == 12053 - 1); int days_since_leapcycle_start = days_since_cycle33_start - leap_years_since_cycle33_start * 1461; int full_years_since_leapcycle_start = days_since_leapcycle_start / 365 - is_last_day_of_leap_year; int full_years_since_cycle33_start = leap_years_since_cycle33_start * 4 + full_years_since_leapcycle_start; int year = 1277 + cycle33_number * 33 + full_years_since_cycle33_start; int days_since_year_start = days_since_leapcycle_start - full_years_since_leapcycle_start * 365; int month; int days_since_month_start; if (days_since_year_start < 186) { month = days_since_year_start / 31; days_since_month_start = days_since_year_start % 31; } else { month = (days_since_year_start - 6) / 30; days_since_month_start = (days_since_year_start - 6) % 30; } result->year = year; result->month = month; result->day = days_since_month_start + 1; result->month_names = persian_month_names; return 0; } return -1; } static const struct calendar persian_calendar = { gregorian_to_persian, "%OY/%Om/%Od", 0xDBB0 /* The alternate digits are U+06F0..U+06F9. */ }; #ifdef TEST #include #include int main (int argc, char *argv[]) { int greg_year = atoi (argv[1]); int greg_month = atoi (argv[2]) - 1; int greg_day = atoi (argv[3]); struct calendar_date cday; if (gregorian_to_persian (&cday, greg_year, greg_month, greg_day) == 0) { printf ("%d-%d-%d -> %d-%d(%s)-%02d\n", greg_year, 1+greg_month, greg_day, cday.year, 1+cday.month, cday.month_names[cday.month].full, cday.day); } } /* * Local Variables: * compile-command: "gcc -ggdb -DTEST -Wall -x c calendars.h" * End: */ #endif