Public holidays
import { getPakistanHolidays, getHolidaysOn, isPakistanHoliday } from 'pakdatakit/holidays'
Lists Pakistan’s federal public holidays for a year and tells whether a date is one. Fixed-date holidays follow the years they applied in: Iqbal Day was dropped from 2015 to 2021 and restored in 2022, and Youm-e-Takbeer was a one-off holiday in 2024 and has been on the annual list since 2025.
isPakistanHoliday() Public holiday
- Holiday
- Independence Day
- Type
- national
- Date
- Fixed date
Optional holidays (for example Shab-e-Barat, Easter and Youm-e-Ali) are not included.
Examples
Section titled “Examples”import { isPakistanHoliday, getHolidaysOn } from 'pakdatakit';
isPakistanHoliday('2026-08-14');// → true
getHolidaysOn('2026-03-20');// → [// {// "id": "eid-ul-fitr",// "name": "Eid ul Fitr",// "date": "2026-03-20",// "type": "religious",// "estimated": false,// "source": "https://cabinet.gov.pk/SiteImage/Misc/files/Holidays/EidulFitr%202026.pdf"// }// ]
getHolidaysOn('2026-12-26', { includeChristianHolidays: true });// → [// {// "id": "day-after-christmas",// "name": "Day after Christmas",// "date": "2026-12-26",// "type": "religious",// "estimated": false,// "christiansOnly": true// }// ]from pakdatakit import is_pakistan_holiday, get_holidays_on
is_pakistan_holiday('2026-08-14')# → True
get_holidays_on('2026-03-20')# → [# {# "id": "eid-ul-fitr",# "name": "Eid ul Fitr",# "date": "2026-03-20",# "type": "religious",# "estimated": False,# "source": "https://cabinet.gov.pk/SiteImage/Misc/files/Holidays/EidulFitr%202026.pdf"# }# ]
get_holidays_on('2026-12-26', include_christian_holidays=True)# → [# {# "id": "day-after-christmas",# "name": "Day after Christmas",# "date": "2026-12-26",# "type": "religious",# "estimated": False,# "christians_only": True# }# ]import 'package:pakdatakit/pakdatakit.dart';
isPakistanHoliday('2026-08-14');// → true
getHolidaysOn('2026-03-20');// → [// {// "id": "eid-ul-fitr",// "name": "Eid ul Fitr",// "date": "2026-03-20",// "type": "religious",// "estimated": false,// "source": "https://cabinet.gov.pk/SiteImage/Misc/files/Holidays/EidulFitr%202026.pdf"// }// ]
getHolidaysOn('2026-12-26', includeChristianHolidays: true);// → [// {// "id": "day-after-christmas",// "name": "Day after Christmas",// "date": "2026-12-26",// "type": "religious",// "estimated": false,// "christiansOnly": true// }// ]using PakDataKit;
Holidays.IsHoliday("2026-08-14");// → true
Holidays.GetHolidaysOn("2026-03-20");// → [// {// "id": "eid-ul-fitr",// "name": "Eid ul Fitr",// "date": "2026-03-20",// "type": "religious",// "estimated": false,// "source": "https://cabinet.gov.pk/SiteImage/Misc/files/Holidays/EidulFitr%202026.pdf"// }// ]
Holidays.GetHolidaysOn("2026-12-26", new HolidayOptions { IncludeChristianHolidays = true });// → [// {// "id": "day-after-christmas",// "name": "Day after Christmas",// "date": "2026-12-26",// "type": "religious",// "estimated": false,// "christiansOnly": true// }// ]use PakDataKit\Holidays;
Holidays::isHoliday('2026-08-14');// → true
Holidays::getHolidaysOn('2026-03-20');// → [// {// "id": "eid-ul-fitr",// "name": "Eid ul Fitr",// "date": "2026-03-20",// "type": "religious",// "estimated": false,// "source": "https://cabinet.gov.pk/SiteImage/Misc/files/Holidays/EidulFitr%202026.pdf"// }// ]
Holidays::getHolidaysOn('2026-12-26', ['includeChristianHolidays' => true]);// → [// {// "id": "day-after-christmas",// "name": "Day after Christmas",// "date": "2026-12-26",// "type": "religious",// "estimated": false,// "christiansOnly": true// }// ]Reference
Section titled “Reference”getPakistanHolidays()
Section titled “getPakistanHolidays()”function getPakistanHolidays(year: number, options?: HolidayOptions): Holiday[];
interface HolidayOptions { includeChristianHolidays?: boolean; // default false announced?: Partial<Record<IslamicHolidayId, string[]>>; hijriOffset?: number; // default 0}
interface Holiday { id: HolidayId; name: string; date: string; // YYYY-MM-DD type: 'national' | 'religious'; estimated: boolean; christiansOnly?: boolean; source?: string; // for an observed Islamic holiday date}
type IslamicHolidayId = 'eid-ul-fitr' | 'eid-ul-adha' | 'ashura' | 'eid-milad-un-nabi';Parameters. year: a Gregorian year from 1948 to 9999. options.includeChristianHolidays: include 26 December, a holiday for Christian employees only. options.announced: observed or announced dates (YYYY-MM-DD) for Islamic holidays, used instead of the dataset or the estimate; use it to apply a new moon-sighting announcement before the library is updated. An empty list removes that holiday for the year. options.hijriOffset: a day offset applied to estimated Islamic dates.
Returns the holidays in date order. A holiday that lasts several days has one entry per day.
Caveats. Throws a RangeError if year is not an integer from 1948 to 9999, or if an announced date is not YYYY-MM-DD. Estimated Islamic holidays use the usual number of days off (three for each Eid, two for Ashura, one for Eid Milad un Nabi).
Related: getHolidaysOn(), Hijri dates.
getHolidaysOn()
Section titled “getHolidaysOn()”function getHolidaysOn( date: Date | string, options?: HolidayOptions,): Holiday[];Parameters. date: a Date (its local calendar date is used) or a YYYY-MM-DD string. options: as for getPakistanHolidays().
Returns the holidays on that date, or an empty list if it is not a public holiday.
Caveats. Throws a RangeError for an invalid Date or a string that is not YYYY-MM-DD.
isPakistanHoliday()
Section titled “isPakistanHoliday()”function isPakistanHoliday( date: Date | string, options?: HolidayOptions,): boolean;Returns true when the date is a Pakistani federal public holiday.
Related: getHolidaysOn() to see which one.
Related
Section titled “Related”- TypeScript API reference for
pakdatakit/holidays - Data sources: where the observed dates come from (each holiday’s
sourcefield links to its notification) - Hijri dates