Holidays

@jalali-js/holidays ships offline Iran (IR) public holidays. AF and TJ are reserved and throw until those packs ship. Dates use Jalali { year, month, day } fields.

Regions

import { isHoliday, SHIPPED_HOLIDAY_REGIONS } from '@jalali-js/holidays';

isHoliday({ year: 1403, month: 1, day: 1 }); // Iran (default)
isHoliday({ year: 1403, month: 1, day: 1 }, { region: 'IR' });
SHIPPED_HOLIDAY_REGIONS; // ['IR']

Iran pack layout:

regions/ir/
  ids.ts fixed.ts lunar-table.ts holiday.ts
  names/{en,fa,ps}.ts
  index.ts

Names are one file per language, like @jalali-js/i18n. Runtime still returns names: { en, fa, ps }.

Fixed and lunar

Iran combines two calendars in one pack:

• kind: 'fixed': solar Jalali days (Nowruz, and so on) in fixed.ts
• kind: 'lunar': Islamic days that shift each year in data/ir/lunar/

Lunar coverage is HOLIDAY_YEAR_RANGE (1402-1426 today). Outside that range, fixed days still resolve.

API

import {
  isHoliday,
  holidaysOn,
  holidaysInMonth,
  holidayName,
  holidayDayTip,
  holidayDayChrome,
  HOLIDAY_YEAR_RANGE,
} from '@jalali-js/holidays';

isHoliday({ year: 1403, month: 1, day: 1 });
holidaysOn({ year: 1403, month: 1, day: 13 });
holidayName('ashura', 'fa');
holidaysInMonth(1403, 1);
HOLIDAY_YEAR_RANGE; // { min: 1402, max: 1426 }

Pickers

showHolidays marks days with data-holiday. blockHolidays also blocks selection. Default region is Iran (holidayRegion / holiday-region).

With showHolidays, hover or focus on a holiday day shows a tip overlay under the grid (data-jalali-calendar-tip). Several holidays on one day join with ·. When the day is also blocked, the tip adds the locale's LocalePack.ui.closedDay label (for example Closed / بسته). The day button's accessible name includes the tip text.

Blocked holiday days use data-disabled and aria-disabled instead of the native disabled attribute, so hover and focus still work for the tip.

<DatePicker system="jalali" locale="fa" showHolidays />
<DatePicker system="jalali" locale="fa" showHolidays blockHolidays />

<DatePicker system="jalali" locale="fa" show-holidays />

<jalali-date-picker system="jalali" locale="fa" show-holidays></jalali-date-picker>

Day tips (headless)

For a custom grid, build the tip and aria label with the same helpers the pickers use:

import { holidayDayTip, holidayDayChrome } from '@jalali-js/holidays';

holidayDayTip({ year: 1403, month: 1, day: 1 }, { locale: 'en' });
// 'Nowruz'

holidayDayTip(
  { year: 1403, month: 1, day: 1 },
  { locale: 'en', closed: true, closedLabel: 'Closed' },
);
// 'Nowruz · Closed'

holidayDayChrome('15 Mordad 1403', cell, {
  locale: 'en',
  closedLabel: 'Closed',
});
// { tip?, ariaLabel, blocked? }

Update lunar data

make update-holidays YEARS=next
make update-holidays YEARS=1426
make update-holidays

YEARS=next fetches the year after the highest JSON year from emrooz.app. No years means rebuild from JSON on disk only. Yearly CI opens a PR when files change.