{"id":13511869,"url":"https://github.com/commenthol/date-holidays","last_synced_at":"2025-05-14T13:08:43.745Z","repository":{"id":37829549,"uuid":"48881101","full_name":"commenthol/date-holidays","owner":"commenthol","description":"worldwide holidays","archived":false,"fork":false,"pushed_at":"2025-05-12T11:42:53.000Z","size":10711,"stargazers_count":972,"open_issues_count":34,"forks_count":264,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-05-12T11:49:45.158Z","etag":null,"topics":["countries","holiday-api","holidays","holidays-ical","javascript","region","world"],"latest_commit_sha":null,"homepage":"https://commenthol.github.io/date-holidays/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/commenthol.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-01-01T15:11:53.000Z","updated_at":"2025-05-12T11:42:57.000Z","dependencies_parsed_at":"2023-10-13T05:37:39.824Z","dependency_job_id":"5fcc6359-1924-4822-9477-d52ab8c723a6","html_url":"https://github.com/commenthol/date-holidays","commit_stats":{"total_commits":1090,"total_committers":112,"mean_commits":9.732142857142858,"dds":0.2761467889908257,"last_synced_commit":"0fa561f01ed127f749107ac6bbc6fa94cf971e05"},"previous_names":[],"tags_count":176,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fdate-holidays","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fdate-holidays/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fdate-holidays/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fdate-holidays/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/commenthol","download_url":"https://codeload.github.com/commenthol/date-holidays/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254149974,"owners_count":22022852,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["countries","holiday-api","holidays","holidays-ical","javascript","region","world"],"created_at":"2024-08-01T03:01:14.726Z","updated_at":"2025-05-14T13:08:38.703Z","avatar_url":"https://github.com/commenthol.png","language":"JavaScript","readme":"# date-holidays\n\n\u003e world-wide holidays in gregorian calender\n\n[![NPM version](https://badge.fury.io/js/date-holidays.svg)](https://www.npmjs.com/package/date-holidays/)\n[![Build Status](https://github.com/commenthol/date-holidays/actions/workflows/ci.yml/badge.svg)](https://github.com/commenthol/date-holidays/actions/workflows/ci.yml)\n\nThis module provides dates of holidays for various countries, states and regions\nby type while considering the applicable timezone.\n\nThe features are:\n\n- calculation of public, bank and observance holidays for different countries,\n  state, region, following ISO 3166-2\n- consideration of timezones for holiday checks\n- consideration of start and end time dependent on timezone\n- substitute days\n- multi-language support for all holiday names\n- setting of custom holidays\n- uses own grammar for calculation of days\n- support for islamic calendar from 1970 to 2080 (*islamic dates might not be\n  correct as they are subject to the sighting of the moon*)\n- support for hebrew calendar from 1970 to 2100\n- support for chinese calendar\n- for generation of iCal calendar check out [date-holidays-ical][]\n\nHappy holidays!\n\n## Table of Contents\n\n\u003c!-- !toc (minlevel=2 omit=\"Table of Contents\") --\u003e\n\n* [Supported Countries, States, Regions](#supported-countries-states-regions)\n* [Usage](#usage)\n* [Holiday object](#holiday-object)\n  * [Dates](#dates)\n  * [Name](#name)\n  * [Types of holidays](#types-of-holidays)\n* [API](#api)\n* [Data](#data)\n* [Custom builds of `holidays.json`](#custom)\n* [Bundling with webpack](#bundling-with-webpack)\n* [Browser](#browser)\n* [CDN](#cdn)\n* [Contribution and License Agreement](#contribution)\n* [License](#license)\n* [References](#references)\n\n\u003c!-- toc! --\u003e\n\n## Supported Countries, States, Regions\n\nIf you are missing holidays from your country, state, region please consider\n[contributing](#contribution).\n\n\u003c!-- !tree --\u003e\n\n```\nCountries: 198\n├── AD: Andorra\n│   └── 07: Andorra la Vella\n├── AE: دولة الإمارات العربية المتحدة\n├── AG: Antigua \u0026 Barbuda\n│   └── 10: Barbuda\n├── AI: Anguilla\n├── AL: Shqipëri\n├── AM: Հայաստան\n├── AO: Angola\n├── AR: Argentina\n├── AS: American Samoa\n├── AT: Österreich\n│   ├── 1: Burgenland\n│   ├── 2: Kärnten\n│   ├── 3: Niederösterreich\n│   ├── 4: Oberösterreich\n│   ├── 5: Land Salzburg\n│   ├── 6: Steiermark\n│   ├── 7: Tirol\n│   ├── 8: Vorarlberg\n│   └── 9: Wien\n├── AU: Australia\n│   ├── ACT: Australian Capital Territory\n│   ├── NSW: New South Wales\n│   ├── NT: Northern Territory\n│   ├── QLD: Queensland\n│   ├── SA: South Australia\n│   ├── TAS: Tasmania\n│   ├── VIC: Victoria\n│   └── WA: Western Australia\n├── AW: Aruba\n├── AX: Landskapet Åland\n├── AZ: Azərbaycan Respublikası\n├── BA: Bosna i Hercegovina\n│   ├── BIH: Federation of Bosnia and Herzegovina\n│   │   └── W: Western Herzegovina\n│   ├── BRC: Brčko District\n│   └── SRP: Republika Srpska\n├── BB: Barbados\n├── BD: গণপ্রজাতন্ত্রী বাংলাদেশ\n├── BE: Belgique\n│   ├── BRU: Bruxelles\n│   ├── DE: Deutschsprachige Gemeinschaft\n│   ├── VLG: Vlaamse Gemeenschap\n│   └── WAL: Communauté française\n├── BF: Burkina Faso\n├── BG: България\n├── BH: مملكة البحرين\n├── BI: République du Burundi\n├── BJ: République du Bénin\n├── BL: St. Barthélemy\n├── BM: Bermuda\n├── BN: Negara Brunei Darussalam\n├── BO: Bolivia\n│   ├── B: Beni\n│   ├── C: Cochabamba\n│   ├── H: Chuquisaca\n│   ├── L: La Paz\n│   ├── N: Pando\n│   ├── O: Oruro\n│   ├── P: Potosí\n│   ├── S: Santa Cruz\n│   └── T: Tarija\n├── BQ: Caribisch Nederland\n│   ├── BO: Bonaire\n│   ├── SA: Saba\n│   └── SE: Sint Eustatius\n├── BR: Brasil\n│   ├── AC: Acre\n│   ├── AL: Alagoas\n│   ├── AM: Amazonas\n│   ├── AP: Amapá\n│   ├── BA: Bahia\n│   ├── CE: Ceará\n│   ├── DF: Distrito Federal\n│   ├── MA: Maranhão\n│   ├── MG: Minas Gerais\n│   │   └── BH: Belo Horizonte\n│   ├── MS: Mato Grosso do Sul\n│   ├── MT: Mato Grosso\n│   ├── PA: Pará\n│   ├── PB: Paraíba\n│   ├── PE: Pernambuco\n│   │   └── RE: Recife\n│   ├── PI: Piauí\n│   ├── PR: Paraná\n│   │   └── CU: Curitiba\n│   ├── RJ: Rio de Janeiro\n│   │   └── RJ: Rio de Janeiro\n│   ├── RN: Rio Grande do Norte\n│   ├── RO: Rondônia\n│   ├── RR: Roraima\n│   ├── RS: Rio Grande do Sul\n│   ├── SC: Santa Catarina\n│   ├── SE: Sergipe\n│   ├── SP: São Paulo\n│   │   └── SP: São Paulo\n│   └── TO: Tocantins\n├── BS: Bahamas\n├── BW: Botswana\n├── BY: Рэспубліка Беларусь\n├── BZ: Belize\n├── CA: Canada\n│   ├── AB: Alberta\n│   ├── BC: British Columbia\n│   ├── MB: Manitoba\n│   ├── NB: New Brunswick\n│   ├── NL: Newfoundland and Labrador\n│   ├── NS: Nova Scotia\n│   ├── NT: Northwest Territories\n│   ├── NU: Nunavut\n│   ├── ON: Ontario\n│   ├── PE: Prince Edward Island\n│   ├── QC: Quebec\n│   ├── SK: Saskatchewan\n│   └── YT: Yukon\n├── CC: Cocos (Keeling) Islands\n├── CD: République démocratique du Congo\n├── CF: République centrafricaine\n├── CG: République du Congo\n├── CH: Schweiz\n│   ├── ZH: Kanton Zürich\n│   ├── BE: Kanton Bern\n│   ├── LU: Kanton Luzern\n│   ├── UR: Kanton Uri\n│   ├── SZ: Kanton Schwyz\n│   ├── OW: Kanton Obwalden\n│   ├── NW: Kanton Nidwalden\n│   ├── GL: Kanton Glarus\n│   ├── ZG: Kanton Zug\n│   ├── FR: Canton de Fribourg\n│   ├── SO: Kanton Solothurn\n│   ├── BS: Kanton Basel-Stadt\n│   ├── BL: Kanton Basel-Landschaft\n│   ├── SH: Kanton Schaffhausen\n│   ├── AR: Kanton Appenzell Ausserrhoden\n│   ├── AI: Kanton Appenzell Innerrhoden\n│   ├── SG: Kanton St. Gallen\n│   ├── GR: Kanton Graubünden\n│   ├── AG: Kanton Aargau\n│   ├── TG: Kanton Thurgau\n│   ├── TI: Canton Ticino\n│   ├── VD: Canton de Vaud\n│   ├── VS: Canton du Valais\n│   ├── NE: Canton de Neuchâtel\n│   ├── GE: Canton de Genève\n│   └── JU: Canton du Jura\n├── CI: République de Côte d'Ivoire\n├── CK: Cook Islands\n│   ├── Aitutaki: Aitutaki\n│   ├── Atiu: Atiu\n│   ├── Mangaia: Mangaia\n│   ├── Manihiki: Manihiki\n│   ├── Mitiaro: Mitiaro\n│   ├── Palmerston: Palmerston\n│   ├── Penrhyn: Penrhyn\n│   ├── Pukapuka: Pukapuka\n│   ├── Rakahanga: Rakahanga\n│   └── Rarotonga: Rarotonga\n├── CL: Chile\n│   ├── AP: Arica y Parinacota\n│   ├── BI: Biobío\n│   │   └── CH: Chillán y Chillán Viejo\n│   ├── NU: Ñuble\n│   │   └── CH: Chillán y Chillán Viejo\n│   └── TA: Tarapacá\n├── CM: Cameroun\n├── CN: 中华人民共和国\n├── CO: Colombia\n├── CR: Costa Rica\n├── CU: Cuba\n├── CV: República de Cabo Verde\n│   └── S: Sotavento Islands\n│       └── PR: Praia\n├── CW: Curaçao\n├── CX: Christmas Island\n├── CY: Κύπρος\n├── CZ: Česká republika\n├── DE: Deutschland\n│   ├── BB: Brandenburg\n│   ├── BE: Berlin\n│   ├── BW: Baden-Württemberg\n│   ├── BY: Bayern\n│   │   ├── A: Stadt Augsburg\n│   │   └── EVANG: Überwiegend evangelische Gemeinden\n│   ├── HB: Hansestadt Bremen\n│   ├── HE: Hessen\n│   ├── HH: Hansestadt Hamburg\n│   ├── MV: Mecklenburg Vorpommern\n│   ├── NI: Niedersachsen\n│   ├── NW: Nordrhein-Westfalen\n│   ├── RP: Rheinland-Pfalz\n│   ├── SH: Schleswig-Holstein\n│   ├── SL: Saarland\n│   ├── SN: Sachsen\n│   │   └── BZ: Landkreis Bautzen\n│   ├── ST: Sachsen-Anhalt\n│   └── TH: Thüringen\n│       ├── EIC: Landkreis Eichfeld\n│       ├── UH: Unstrut-Hainich-Kreis\n│       └── WAK: Wartburgkreis\n├── DJ: République de Djibouti\n├── DK: Danmark\n├── DM: Dominica\n├── DO: República Dominicana\n├── DZ: الجمهورية الجزائرية الديمقراطية الشعبية\n├── EC: Ecuador\n│   └── P: Pichincha\n│       └── QU: Quito\n├── EE: Eesti\n├── EG: جمهورية مصر العربية\n├── EH: الجمهورية العربية الصحراوية الديمقراطية\n├── ER: Eritrea\n├── ES: España\n│   ├── AN: Andalucía\n│   ├── AR: Aragón\n│   ├── AS: Asturias\n│   ├── CB: Cantabria\n│   ├── CE: Ciudad de Ceuta\n│   ├── CL: Castilla y León\n│   ├── CM: Castile-La Mancha\n│   ├── CN: Islas Canarias\n│   │   ├── EH: El Hierro\n│   │   ├── FU: Fuerteventura\n│   │   ├── GC: Gran Canaria\n│   │   ├── LG: La Gomera\n│   │   ├── LP: La Palma\n│   │   ├── LA: Lanzarote\n│   │   └── TE: Tenerife\n│   ├── CT: Cataluña\n│   ├── EX: Extremadura\n│   ├── GA: Galicia\n│   ├── IB: Illes Balears\n│   ├── MC: Murcia Region\n│   ├── MD: Comunidad de Madrid\n│   ├── ML: Ciudad de Melilla\n│   ├── NC: Comunidad Foral de Navarra\n│   ├── PV: País Vasco\n│   ├── RI: La Rioja\n│   └── VC: Comunitat Valenciana\n├── ET: ኢትዮጵያ\n├── FI: Suomi\n├── FJ: Matanitu Tugalala o Viti\n├── FO: Føroyar\n├── FR: France\n│   ├── 57: Département Moselle\n│   ├── 67: Département Bas-Rhin\n│   ├── 68: Département Haut-Rhin\n│   ├── YT: Département et région d'outre-mer Mayotte\n│   ├── MQ: Département et région d'outre-mer Martinique\n│   ├── GP: Département et région d'outre-mer Guadeloupe\n│   ├── GF: Département et région d'outre-mer Guyane\n│   ├── RE: Département et région d'outre-mer La Réunion\n│   ├── MF: Département et région d'outre-mer Saint Martin\n│   └── BL: Département et région d'outre-mer Saint Barthélemy\n├── GA: Gabon\n├── GB: United Kingdom\n│   ├── ALD: Alderney\n│   ├── ENG: England\n│   ├── NIR: Northern Ireland\n│   ├── SCT: Scotland\n│   └── WLS: Wales\n├── GD: Grenada\n├── GE: საქართველო\n├── GF: Guyane\n├── GG: Guernsey\n├── GH: Ghana\n├── GI: Gibraltar\n├── GL: Kalaallit Nunaat\n├── GM: The Gambia\n├── GN: Guinée\n├── GP: Guadeloupe\n├── GQ: República de Guinea Ecuatorial\n├── GR: Ελλάδα\n├── GT: Guatemala\n├── GU: Guam\n├── GW: Guiné-Bissau\n├── GY: Guyana\n├── HK: 香港\n├── HN: Honduras\n├── HR: Hrvatska\n│   ├── 17: Split-Dalmatia\n│   └── 19: Dubrovnik-Neretva\n├── HT: Haïti\n├── HU: Magyarország\n├── IC: Islas Canarias\n│   ├── EH: El Hierro\n│   ├── FU: Fuerteventura\n│   ├── GC: Gran Canaria\n│   ├── LG: La Gomera\n│   ├── LP: La Palma\n│   ├── LA: Lanzarote\n│   └── TE: Tenerife\n├── ID: Indonesia\n├── IE: Ireland\n├── IL: מְדִינַת יִשְׂרָאֵל\n├── IM: Isle of Man\n├── IR: جمهوری اسلامی ایران\n├── IS: Ísland\n├── IT: Italia\n│   ├── 25: Lombardy\n│   │   └── MI: Milan\n│   ├── 32: Alto Adige\n│   ├── 52: Toscana\n│   │   └── FI: Firenze\n│   └── 62: Lazio\n│       └── RM: Roma\n├── JE: Jersey\n├── JM: Jamaica\n├── JP: 日本\n├── KE: Kenya\n├── KM: Union des Comores\n├── KN: St. Kitts \u0026 Nevis\n├── KR: 대한민국\n├── KY: Cayman Islands\n├── LC: St. Lucia\n├── LI: Liechtenstein\n├── LR: Liberia\n├── LS: \\'Muso oa Lesotho\n├── LT: Lietuva\n├── LU: Luxembourg\n├── LV: Latvija\n├── LY: دولة ليبيا\n├── MA: المملكة المغربية\n├── MC: Monaco\n├── MD: Republica Moldova\n│   ├── CA: Cahul\n│   └── CU: Chișinău\n├── ME: Crna Gora\n├── MF: Saint Martin\n├── MG: Repoblikan'i Madagasikara\n├── MK: Република Македонија\n├── ML: République du Mali\n├── MQ: Martinique\n├── MR: الجمهورية الإسلامية الموريتانية\n├── MS: Montserrat\n├── MT: Malta\n├── MW: Malawi\n├── MX: México\n├── MY: Malaysia\n│   ├── 10: Selangor\n│   ├── 11: Terengganu\n│   ├── 12: Sabah\n│   ├── 13: Sarawak\n│   ├── 14: Kuala Lumpur\n│   ├── 15: Labuan\n│   ├── 16: Putrajaya\n│   ├── 01: Johor\n│   ├── 02: Kedah\n│   ├── 03: Kelantan\n│   ├── 04: Malacca\n│   ├── 05: Negeri Sembilan\n│   ├── 06: Pahang\n│   ├── 07: Penang\n│   ├── 08: Perak\n│   └── 09: Perlis\n├── MZ: Moçambique\n├── NA: Namibia\n├── NC: Nouvelle-Calédonie\n├── NE: République du Niger\n├── NG: Nigeria\n├── NI: Nicaragua\n├── NL: Nederland\n│   ├── GR: Groningen\n│   │   └── GRN: Groningen\n│   ├── NH: Noord-Holland\n│   │   └── ALK: Alkmaar\n│   └── ZH: Zuid-Holland\n│       ├── BRL: Brielle\n│       └── LDN: Leiden\n├── NO: Norge\n├── NZ: New Zealand\n│   ├── AUK: Auckland Province\n│   ├── BOP: Bay of Plenty\n│   ├── CAN: Canterbury\n│   │   └── Timaru: Timaru District\n│   ├── CIT: Chatham Islands\n│   ├── GIS: Gisborne\n│   ├── HKB: Hawke's Bay\n│   ├── MBH: Marlborough\n│   ├── MWT: Manawatu-Wanganui\n│   ├── NSN: Nelson\n│   ├── NTL: Northland\n│   ├── OTA: Otago Province\n│   ├── STL: Southland\n│   ├── TAS: Tasman\n│   ├── TKI: Taranaki\n│   ├── WKO: Waikato\n│   ├── WGN: Wellington Province\n│   └── WTC: Westland\n│       └── Buller: Buller district\n├── PA: Panamá\n├── PE: Perú\n│   └── CUS: Cuzco\n├── PH: Philippines\n├── PL: Polska\n├── PM: St. Pierre \u0026 Miquelon\n├── PR: Puerto Rico\n├── PT: Portugal\n├── PY: Paraguay\n├── RE: Réunion\n├── RO: Romania\n├── RS: Република Србија\n├── RU: Россия\n├── RW: Rwanda\n├── SA: المملكة العربية السعودية\n├── SC: Seychelles\n├── SD: جمهورية السودان\n├── SE: Sverige\n├── SG: Singapore\n├── SH: St. Helena\n│   ├── AC: Ascension Island\n│   ├── HL: Saint Helena\n│   └── TA: Tristan da Cunha\n├── SI: Republika Slovenija\n├── SJ: Svalbard \u0026 Jan Mayen\n├── SK: Slovenská republika\n├── SL: Sierra Leone\n├── SM: San Marino\n├── SN: République du Sénégal\n├── SO: Jamhuuriyadda Federaalka Soomaaliya\n│   ├── AW: Awdal\n│   ├── SA: Sanaag\n│   ├── SO: Sool\n│   ├── TO: Togdheer\n│   └── WO: Woqooyi Galbeed\n├── SR: Suriname\n├── SS: South Sudan\n├── ST: São Tomé \u0026 Príncipe\n├── SV: El Salvador\n│   └── SS: San Salvador\n├── SX: Sint Maarten\n├── SZ: Eswatini\n├── TC: Turks \u0026 Caicos Islands\n├── TD: جمهورية تشاد\n├── TG: République togolaise\n├── TH: Thailand\n├── TN: الجمهورية التونسية\n├── TO: Puleʻanga Fakatuʻi ʻo Tonga\n├── TR: Türkiye\n├── TT: Trinidad \u0026 Tobago\n├── TW: 中華民國\n├── TZ: Tanzania\n├── UA: Україна\n├── UG: Uganda\n├── US: United States of America\n│   ├── AL: Alabama\n│   ├── AK: Alaska\n│   ├── AZ: Arizona\n│   ├── AR: Arkansas\n│   ├── CA: California\n│   │   └── LA: Los Angeles\n│   ├── CO: Colorado\n│   ├── CT: Connecticut\n│   ├── DE: Delaware\n│   ├── DC: District of Columbia\n│   ├── FL: Florida\n│   ├── GA: Georgia\n│   ├── HI: Hawaii\n│   ├── ID: Idaho\n│   ├── IL: Illinois\n│   ├── IN: Indiana\n│   ├── IA: Iowa\n│   ├── KS: Kansas\n│   ├── KY: Kentucky\n│   ├── LA: Louisiana\n│   │   └── NO: New Orleans\n│   ├── ME: Maine\n│   ├── MD: Maryland\n│   ├── MA: Massachusetts\n│   ├── MI: Michigan\n│   ├── MN: Minnesota\n│   ├── MS: Mississippi\n│   ├── MO: Missouri\n│   ├── MT: Montana\n│   ├── NE: Nebraska\n│   ├── NV: Nevada\n│   ├── NH: New Hampshire\n│   ├── NJ: New Jersey\n│   ├── NM: New Mexico\n│   ├── NY: New York\n│   ├── NC: North Carolina\n│   ├── ND: North Dakota\n│   ├── OH: Ohio\n│   ├── OK: Oklahoma\n│   ├── OR: Oregon\n│   ├── PA: Pennsylvania\n│   ├── RI: Rhode Island\n│   ├── SC: South Carolina\n│   ├── SD: South Dakota\n│   ├── TN: Tennessee\n│   ├── TX: Texas\n│   ├── UT: Utah\n│   ├── VT: Vermont\n│   ├── VA: Virginia\n│   ├── WA: Washington\n│   ├── WV: West Virginia\n│   ├── WI: Wisconsin\n│   └── WY: Wyoming\n├── UY: Uruguay\n├── VA: Stato della Città del Vaticano\n├── VC: St. Vincent \u0026 Grenadines\n├── VE: Venezuela\n│   ├── B: Anzoátegui\n│   ├── G: Carabobo\n│   ├── K: Lara\n│   │   └── BA: Barquisimeto\n│   ├── M: Miranda\n│   ├── N: Monagas\n│   ├── S: Táchira\n│   └── V: Zulia\n├── VG: British Virgin Islands\n├── VI: U.S. Virgin Islands\n├── VN: Cộng hòa Xã hội chủ nghĩa Việt Nam\n├── VU: République de Vanuatu\n├── XK: Republika e Kosovës\n├── YT: Mayotte\n├── ZA: South Africa\n├── ZM: Zambia\n└── ZW: Zimbabwe\n```\n\u003c!-- tree! --\u003e\n\n## Usage\n\n```js\nvar Holidays = require('date-holidays')\nvar hd = new Holidays()\n\n// get supported countries\nhd.getCountries()\n/*\u003e\n{ AD: 'Andorra',\n  ...\n  US: 'United States' }\n*/\n\n// get supported states e.g. for US\nhd.getStates('US')\n/*\u003e\n{ al: 'Alabama',\n  ...\n  wy: 'Wyoming' }\n*/\n\n// get supported regions e.g. for US, Lousiana\nhd.getRegions('US', 'la')\n/*\u003e\n{ no: 'New Orleans' }\n*/\n\n// initialize holidays for US, Lousiana, New Orleans\nhd.init('US', 'la', 'no')\n// or using a new instance\nhd = new Holidays('US', 'la', 'no')\n\n// get all holidays for the year 2016\nhd.getHolidays(2016)\n/*\u003e\n[ { date: '2016-01-01 00:00:00',\n    start: Fri Jan 01 2016 00:00:00 GMT-0600 (CST),\n    end: Sat Jan 02 2016 00:00:00 GMT-0600 (CST),\n    name: 'New Year\\'s Day',\n    rule: '01-01 and if sunday then next monday if saturday then previous friday',\n    type: 'public' },\n  ...\n  { date: '2016-11-24 00:00:00',\n    start: Thu Nov 24 2016 00:00:00 GMT-0600 (CST),\n    end: Fri Nov 25 2016 00:00:00 GMT-0600 (CST),\n    name: 'Thanksgiving Day',\n    rule: '4th thursday in November',\n    type: 'public' },\n  ...\n  { date: '2016-12-26 00:00:00',\n    start: Mon Dec 26 2016 00:00:00 GMT-0600 (CST),\n    end: Tue Dec 27 2016 00:00:00 GMT-0600 (CST),\n    substitute: true,\n    name: 'Christmas Day (substitute day)',\n    rule: '12-25 and if sunday then next monday if saturday then previous friday',\n    type: 'public' } ]\n*/\n\n// check if date is a holiday while respecting timezones\nhd.isHoliday(new Date('2016-02-09 00:00:00 GMT+0000'))\n//\u003e false\nhd.isHoliday(new Date('2016-02-09 10:00:00 GMT-0600'))\n/*\u003e\n[{ date: '2016-02-09 00:00:00',\n  start: Tue Feb 09 2016 00:00:00 GMT-0600 (CST),\n  end: Wed Feb 10 2016 00:00:00 GMT-0600 (CST),\n  name: 'Mardi Gras',\n  rule: 'easter -47',\n  type: 'public' }\n]\n*/\n```\n\n## Holiday object\n\n`getHolidays()` as well as a matching `isHoliday()` call return either a list or\na single holiday object which consists of:\n\n* {String} date - ISO Date String of (start)-date in local format\n* {Date} start - start date of holiday\n* {Date} end - end date of holiday\n* {String} name - name of holiday using `language` (if available)\n* {String} type - type of holiday `public|bank|school|optional|observance`\n* {Boolean} substitute - (optional) if true holiday substitutes another holiday`\n* {String} note - (optional) note`\n\n### Dates\n\nThe `date` String represents the start date of the holiday in ISO format without\ntimezone. This string it intended for information only.\n\n`start` and `end` are the start/end date of the holiday within the selected\ntimezone of the country, state, region.\n\n### Name\n\nThe `name` names the holiday in the local language of the selected country,\nstate, region. The applied language(s) can be requested using `getLanguages()`.\n\nThe language can be changed using the `setLanguages()` method. In case that not\ntranslation is available a fall-back to the next given language will be made.\nE.g. local language is \"fr\", `setLanguages('nl')` was called. For all holidays\nwhere no dutch translation is available the French version will be used instead.\n\nAll holiday names should support an English translation.\n\n### Types of holidays\n\nCurrently the following type with their meaning are supported\n\n| type        | meaning                                    |\n| ----------- | ------------------------------------------ |\n| public      | public holiday                             |\n| bank        | bank holiday, banks and offices are closed |\n| school      | school holiday, schools are closed         |\n| optional    | majority of people take a day off          |\n| observance  | optional festivity, no paid day off        |\n\nAdditionally a `note` field is sometimes available for further clarification.\n\n## API\n\nSee [Holidays API][] for further information.\n\n## Data\n\nAll data for the holidays of the different countries is contained in\n[`./data/holidays.json`](./data/holidays.json). For changing holiday data edit the appropriate country in `./data/countries`.\nAny details on structure and\navailable grammar for holiday attribution is described in\n[holidays.yaml specification][].\n\n\u003ca name=\"custom\"\u003e\u003c/a\u003e\n\n## Custom builds of `holidays.json`\n\nIf only selected countries are required in `data/holidays.json` you can add the\nfollowing script to your npm scripts section. E.g. for picking just US, Canada,\nMexico do the following:\n\n```js\n\"scripts\": {\n  \"build\": \"holidays2json --pick US,CA,MX --min\"\n},\n```\n\nThe `--min` switch removes dependencies which are not required for the countries selected. You may not be able to use the full set of rules in case you want to add custom rules.\n\nAlternatively you may use the `--omit` option.\n\nManually use\n\n```bash\n./scripts/holidays2json --pick US,CA,MX\n```\n\n\u003e **NOTE:** There are some countries which depend on data of others which\n\u003e might render the file useless. e.g. \"GU\" requires \"US\", so try\n\u003e to pick or omit both.\n\n## Bundling with webpack\n\nTo minimize bundle sizes consider adding the following lines in your webpack config.\nPlease take a look at `./webpack.config.js`. To further reduce size consider custom builds by only selecting required countries.\n\n```js\n...\n  plugins: [\n    new webpack.IgnorePlugin({\n      checkResource (resource, context) {\n        // ---- do not bundle astronomia vsop planet data\n        if (/\\/astronomia\\/data$/.test(context)) {\n          return !['./deltat.js', './vsop87Bearth.js'].includes(resource)\n        }\n        // ---- do not bundle moment locales\n        if (/\\/moment\\/locale$/.test(context)) {\n          return true\n        }\n        return false\n      }\n    })\n```\n\n## Browser\n\nThis project also runs in all modern browsers. See `./examples/browser`\n\n| Browser | Version | Notes                        |\n| ------- | :-----: | ---------------------------- |\n| Chrome  | \u003e=45    |                              |\n| Firefox | \u003e=45    |                              |\n| Safari  | \u003e=10    |                              |\n| Edge    | \u003e=13    |                              |\n| IE      | \u003e=11    | needs polyfill `core-js/es6` |\n\nPlease do not forget to set the correct charset!\n\n```html\n\u003chtml\u003e\n\u003chead\u003e\n  \u003c!-- set page-wide --\u003e\n  \u003cmeta charset=\"UTF-8\"\u003e\n  ...\n\u003c/head\u003e\n\u003cbody\u003e\n  ...\n  \u003c!-- or per script --\u003e\n  \u003cscript src=\"your-bundle.js\" charset=\"UTF-8\"\u003e\u003c/script\u003e\n```\n\n## CDN\n\nMinified distribution bundles are available via https://unpkg.com\n\n\u003e **NOTE:** dist-bundles are quite huge in size ~1.5MByte so use [custom](#custom) builds instead.\n\nSee https://unpkg.com/date-holidays/dist/\n\n- `index.min.js`: commonjs2 bundle\n- `umd.min.js`: umd bundle\n\n\u003ca name=\"contribution\"\u003e\u003c/a\u003e\n\n## Contribution and License Agreement\n\nYou like to contribute please read [CONTRIBUTING.md][].\n\nIf you contribute code to this project, you are implicitly allowing your\ncode to be distributed under the ISC license. You are also implicitly\nverifying that all code is your original work or correctly attributed\nwith the source of its origin and license.\n\n## License\n\nCopyright (c) 2016- commenthol ([ISC License](http://opensource.org/licenses/ISC))\n\nThe data contained in `holidays.json` and `./data/countries/*.yaml` is available under [CC BY-SA 3.0](http://creativecommons.org/licenses/by-sa/3.0/)\nas the majority of data obtained relies on wikipedia articles. The required\nattribution can be found inside the files `./data/countries/*.yaml`.\n\nSee [LICENSE][] for more information.\n\n## References\n\n\u003c!-- !ref --\u003e\n\n* [CONTRIBUTING.md][CONTRIBUTING.md]\n* [date-holidays-ical][date-holidays-ical]\n* [date-holidays-parser][date-holidays-parser]\n* [Holidays API][Holidays API]\n* [holidays.yaml specification][holidays.yaml specification]\n* [LICENSE][LICENSE]\n\n\u003c!-- ref! --\u003e\n\n[LICENSE]: ./LICENSE\n[CONTRIBUTING.md]: ./CONTRIBUTING.md\n[holidays.yaml specification]: https://github.com/commenthol/date-holidays/blob/master/docs/specification.md\n[Holidays API]: https://github.com/commenthol/date-holidays-parser/blob/master/docs/Holidays.md\n[date-holidays-parser]: https://github.com/commenthol/date-holidays-parser\n[date-holidays-ical]: https://github.com/commenthol/date-holidays-ical\n","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommenthol%2Fdate-holidays","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcommenthol%2Fdate-holidays","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommenthol%2Fdate-holidays/lists"}