https://github.com/dr-prodigy/python-holidays
Open World Holidays Framework
https://github.com/dr-prodigy/python-holidays
calendar gsoc holiday holiday-api holiday-calculation python
Last synced: 9 days ago
JSON representation
Open World Holidays Framework
- Host: GitHub
- URL: https://github.com/dr-prodigy/python-holidays
- Owner: vacanza
- License: mit
- Created: 2014-08-24T15:17:18.000Z (about 11 years ago)
- Default Branch: dev
- Last Pushed: 2025-04-01T03:15:00.000Z (7 months ago)
- Last Synced: 2025-04-01T04:24:03.569Z (7 months ago)
- Topics: calendar, gsoc, holiday, holiday-api, holiday-calculation, python
- Language: Python
- Homepage: https://pypi.org/project/holidays
- Size: 14.9 MB
- Stars: 1,590
- Watchers: 20
- Forks: 511
- Open Issues: 112
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Authors: AUTHORS.md
Awesome Lists containing this project
- best-of-python - GitHub
README
# Holidays
A fast, efficient Python library for generating country- and subdivision- (e.g. state or province)
specific sets of government-designated holidays on the fly. It aims to make determining whether a
specific date is a holiday as fast and flexible as possible.
PyPI
CI/CD
Code
GitHub
Citation
## Install
The latest stable version can always be installed or updated via pip:
``` shell
pip install --upgrade holidays
```
The latest development (dev) version can be installed directly from GitHub:
``` shell
pip install --upgrade https://github.com/vacanza/holidays/tarball/dev
```
All new features are always first pushed to dev branch, then released on main branch upon official
version upgrades.
## Documentation
The documentation is hosted on [Read the Docs](https://holidays.readthedocs.io).
## Quick Start
``` python
from datetime import date
import holidays
us_holidays = holidays.US() # this is a dict-like object
# the below is the same, but takes a string:
us_holidays = holidays.country_holidays('US') # this is a dict-like object
nyse_holidays = holidays.NYSE() # this is a dict-like object
# the below is the same, but takes a string:
nyse_holidays = holidays.financial_holidays('NYSE') # this is a dict-like object
date(2015, 1, 1) in us_holidays # True
date(2015, 1, 2) in us_holidays # False
us_holidays.get('2014-01-01') # "New Year's Day"
```
The HolidayBase dict-like class will also recognize date strings and Unix timestamps:
``` python
'2014-01-01' in us_holidays # True
'1/1/2014' in us_holidays # True
1388597445 in us_holidays # True
```
Some holidays may be only present in parts of a country:
``` python
us_pr_holidays = holidays.country_holidays('US', subdiv='PR')
'2018-01-06' in us_holidays # False
'2018-01-06' in us_pr_holidays # True
```
Please see the [holidays documentation](https://holidays.readthedocs.io/) for additional examples
and detailed information.
## Available Countries
We currently support 249 country codes and are fully compatible with [ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html).
The standard way to refer to a country is by using its [ISO 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes),
the same used for domain names, and for a subdivision its [ISO 3166-2
code](https://en.wikipedia.org/wiki/ISO_3166-2). Some countries have common or foreign names or
abbreviations as aliases for their subdivisions. These are defined in the (optional)
`subdivisions_aliases` attribute. Some of the countries support more than one language for holiday
names output. A default language is defined by `default_language` (optional) attribute for each
entity and is used as a fallback when neither user specified language nor user locale language
available. The default language code is a [ISO 639-1
code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes). A list of all languages supported by
country is defined by `supported_languages` (optional) attribute. If there is no designated [ISO
639-1 code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) then [ISO 639-2
code](https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes) can be used.
Many countries have other categories of holidays in addition to common (national-wide) holidays:
bank holidays, school holidays, additional (paid or non-paid) holidays, holidays of state or public
employees, religious holidays (valid only for these religions followers). A list of all categories
supported by country is defined by `supported_categories` (optional) attribute.
The following is a list of supported countries, their subdivisions followed by their aliases (if
any) in brackets, available languages and additional holiday categories. All countries support
**PUBLIC** holidays category by default. All other default values are highlighted with bold:
Country
Code
Subdivisions
Supported Languages
Supported Categories
Afghanistan
AF
en_US, fa_AF, ps_AF
Aland Islands
AX
Can also be loaded as country FI, subdivision 01
en_US, fi, sv_FI, th, uk
UNOFFICIAL, WORKDAY
Albania
AL
en_US, sq, uk
Algeria
DZ
ar, en_US, fr
CHRISTIAN, HEBREW
American Samoa
AS
Can also be loaded as country US, subdivision AS
en_US, th
GOVERNMENT, UNOFFICIAL
Andorra
AD
Parishes: 02 (Canillo), 03 (Encamp), 04 (La Massana), 05 (Ordino), 06 (Sant Julià de Lòria), 07 (Andorra la Vella), 08 (Escaldes-Engordany)
ca, en_US, uk
GOVERNMENT
Angola
AO
en_US, pt_AO, uk
Anguilla
AI
en_AI, en_US
Antarctica
AQ
Antigua and Barbuda
AG
Argentina
AR
Provinces: A (Salta), B (Buenos Aires), C (Ciudad Autónoma de Buenos Aires), D (San Luis), E (Entre Ríos), F (La Rioja), G (Santiago del Estero), H (Chaco), J (San Juan), K (Catamarca), L (La Pampa), M (Mendoza), N (Misiones), P (Formosa), Q (Neuquén), R (Río Negro), S (Santa Fe), T (Tucumán), U (Chubut), V (Tierra del Fuego), W (Corrientes), X (Córdoba), Y (Jujuy), Z (Santa Cruz)
en_US, es, uk
ARMENIAN, BANK, GOVERNMENT, HEBREW, ISLAMIC
Armenia
AM
en_US, hy
Aruba
AW
en_US, nl, pap_AW, uk
Australia
AU
States and territories: ACT (Australian Capital Territory), NSW (New South Wales), NT (Northern Territory), QLD (Queensland), SA (South Australia), TAS (Tasmania), VIC (Victoria), WA (Western Australia)
en_AU, en_US, th
BANK, HALF_DAY
Austria
AT
States: 1 (Burgenland, Bgld, B), 2 (Kärnten, Ktn, K), 3 (Niederösterreich, NÖ, N), 4 (Oberösterreich, OÖ, O), 5 (Salzburg, Sbg, S), 6 (Steiermark, Stmk, St), 7 (Tirol, T), 8 (Vorarlberg, Vbg, V), 9 (Wien, W)
de, en_US, uk
BANK
Azerbaijan
AZ
az, en_US, uk
WORKDAY
Bahamas
BS
Bahrain
BH
ar, en_US
Bangladesh
BD
Barbados
BB
Belarus
BY
be, en_US, ru, th
WORKDAY
Belgium
BE
de, en_US, fr, nl, uk
BANK
Belize
BZ
Benin
BJ
en_US, fr_BJ
WORKDAY
Bermuda
BM
en_BM, en_US
Bhutan
BT
Administrative Subdivisions: 11 (Paro), 12 (Chhukha), 13 (Haa), 14 (Samtse), 15 (Thimphu), 21 (Tsirang), 22 (Dagana), 23 (Punakha), 24 (Wangdue Phodrang), 31 (Sarpang), 32 (Trongsa), 33 (Bumthang), 34 (Zhemgang), 41 (Trashigang), 42 (Monggar), 43 (Pema Gatshel), 44 (Lhuentse), 45 (Samdrup Jongkhar), GA (Gasa), TY (Trashi Yangtse)
Bolivia
BO
Departments: B (El Beni), C (Cochabamba), H (Chuquisaca), L (La Paz), N (Pando), O (Oruro), P (Potosí), S (Santa Cruz), T (Tarija)
en_US, es, uk
Bonaire, Sint Eustatius and Saba
BQ
Subdivisions: BON (Bonaire), SAB (Saba), STA (Sint Eustatius)
en_BQ, en_US, nl, pap_BQ
Bosnia and Herzegovina
BA
Entities and district: BIH (Federacija Bosne i Hercegovine, FBiH), BRC (Brčko distrikt, BD), SRP (Republika Srpska, RS)
bs, en_US, sr, uk
Botswana
BW
Bouvet Island
BV
Brazil
BR
States: AC (Acre), AL (Alagoas), AM (Amazonas), AP (Amapá), BA (Bahia), CE (Ceará), DF (Distrito Federal), ES (Espírito Santo), GO (Goiás), MA (Maranhão), MG (Minas Gerais), MS (Mato Grosso do Sul), MT (Mato Grosso), PA (Pará), PB (Paraíba), PE (Pernambuco), PI (Piauí), PR (Paraná), RJ (Rio de Janeiro), RN (Rio Grande do Norte), RO (Rondônia), RR (Roraima), RS (Rio Grande do Sul), SC (Santa Catarina), SE (Sergipe), SP (São Paulo), TO (Tocantins)
en_US, pt_BR, uk
OPTIONAL
British Indian Ocean Territory
IO
British Virgin Islands
VG
en_US, en_VG
Brunei
BN
en_US, ms, th
Bulgaria
BG
bg, en_US, uk
SCHOOL
Burkina Faso
BF
Burundi
BI
en_US, fr_BI
Cabo Verde
CV
Municipalities: BR (Brava), BV (Boa Vista), CA (Santa Catarina), CF (Santa Catarina do Fogo), CR (Santa Cruz), MA (Maio), MO (Mosteiros), PA (Paul), PN (Porto Novo), PR (Praia), RB (Ribeira Brava), RG (Ribeira Grande), RS (Ribeira Grande de Santiago), SD (São Domingos), SF (São Filipe), SL (Sal), SM (São Miguel), SO (São Lourenço dos Órgãos), SS (São Salvador do Mundo), SV (São Vicente), TA (Tarrafal), TS (Tarrafal de São Nicolau)
de, en_US, es, fr, pt_CV
OPTIONAL
Cambodia
KH
en_US, km, th
Cameroon
CM
Canada
CA
Provinces and territories: AB (Alberta), BC (British Columbia, Colombie-Britannique), MB (Manitoba), NB (New Brunswick, Nouveau-Brunswick), NL (Newfoundland and Labrador, Terre-Neuve-et-Labrador), NS (Nova Scotia, Nouvelle-Écosse), NT (Northwest Territories, Territoires du Nord-Ouest), NU (Nunavut), ON (Ontario), PE (Prince Edward Island, Île-du-Prince-Édouard), QC (Quebec, Québec), SK (Saskatchewan), YT (Yukon)
ar, en_CA, en_US, fr, th
GOVERNMENT, OPTIONAL
Cayman Islands
KY
en_GB, en_US
Central African Republic
CF
en_US, fr
Chad
TD
Chile
CL
Regions: AI (Aisén del General Carlos Ibañez del Campo), AN (Antofagasta), AP (Arica y Parinacota), AR (La Araucanía), AT (Atacama), BI (Biobío), CO (Coquimbo), LI (Libertador General Bernardo O'Higgins), LL (Los Lagos), LR (Los Ríos), MA (Magallanes), ML (Maule), NB (Ñuble), RM (Región Metropolitana de Santiago), TA (Tarapacá), VS (Valparaíso)
en_US, es, uk
BANK
China
CN
en_US, th, zh_CN, zh_TW
HALF_DAY
Christmas Island
CX
en_CX, en_US
Cocos Islands
CC
coa_CC, en_CC, en_US
Colombia
CO
en_US, es, uk
Comoros
KM
Congo
CG
en_US, fr
Cook Islands
CK
en_CK, en_US
Costa Rica
CR
en_US, es, uk
OPTIONAL
Croatia
HR
en_US, hr, uk
Cuba
CU
en_US, es, uk
Curacao
CW
en_US, nl, pap_CW, uk
HALF_DAY
Cyprus
CY
el, en_CY, en_US, uk
BANK, OPTIONAL
Czechia
CZ
cs, en_US, sk, uk
Denmark
DK
da, en_US, th, uk
OPTIONAL
Djibouti
DJ
ar, en_US, fr
Dominica
DM
Dominican Republic
DO
en_US, es, uk
DR Congo
CD
en_US, fr
Ecuador
EC
en_US, es, uk
Egypt
EG
ar_EG, en_US, fr
GOVERNMENT, SCHOOL
El Salvador
SV
Departments: AH (Ahuachapán), CA (Cabañas), CH (Chalatenango), CU (Cuscatlán), LI (La Libertad), MO (Morazán), PA (La Paz), SA (Santa Ana), SM (San Miguel), SO (Sonsonate), SS (San Salvador), SV (San Vicente), UN (La Unión), US (Usulután)
en_US, es, uk
Equatorial Guinea
GQ
Provinces: AN (Annobón, Annobon), BN (Bioko Norte, North Bioko), BS (Bioko Sur, South Bioko), CS (Centro Sur, South Center), DJ (Djibloho), KN (Kié-Ntem, Kie-Ntem), LI (Litoral, Coast), WN (Wele-Nzas)
en_US, es
Eritrea
ER
GOVERNMENT
Estonia
EE
en_US, et, uk
Eswatini
SZ
Ethiopia
ET
am, ar, en_ET, en_US
WORKDAY
Falkland Islands
FK
en_GB, en_US
GOVERNMENT, WORKDAY
Faroe Islands
FO
da, en_US, fo, is, no, sv
HALF_DAY
Fiji
FJ
WORKDAY
Finland
FI
Regions: 01 (Ahvenanmaan maakunta, Landskapet Åland), 02 (Etelä-Karjala, Södra Karelen), 03 (Etelä-Pohjanmaa, Södra Österbotten), 04 (Etelä-Savo, Södra Savolax), 05 (Kainuu, Kajanaland), 06 (Kanta-Häme, Egentliga Tavastland), 07 (Keski-Pohjanmaa, Mellersta Österbotten), 08 (Keski-Suomi, Mellersta Finland), 09 (Kymenlaakso, Kymmenedalen), 10 (Lappi, Lappland), 11 (Pirkanmaa, Birkaland), 12 (Pohjanmaa, Österbotten), 13 (Pohjois-Karjala, Norra Karelen), 14 (Pohjois-Pohjanmaa, Norra Österbotten), 15 (Pohjois-Savo, Norra Savolax), 16 (Päijät-Häme, Päijänne-Tavastland), 17 (Satakunta), 18 (Uusimaa, Nyland), 19 (Varsinais-Suomi, Egentliga Finland)
en_US, fi, sv_FI, th, uk
UNOFFICIAL, WORKDAY
France
FR
Departments/European Collectivity/DOM/ROM/TOM: 57 (Moselle), 6AE (Alsace), 971 (GP, GUA, Guadeloupe), 972 (MQ, Martinique), 973 (GY, Guyane), 974 (RE, LRE, La Réunion), 976 (YT, MAY, Mayotte), BL (Saint-Barthélemy), MF (Saint-Martin), NC (Nouvelle-Calédonie), PF (Polynésie Française), PM (Saint-Pierre-et-Miquelon), TF (Terres australes françaises), WF (Wallis-et-Futuna)
en_US, fr, th, uk
French Guiana
GF
Can also be loaded as country FR, subdivision 973
en_US, fr, th, uk
French Polynesia
PF
Can also be loaded as country FR, subdivision PF
en_US, fr, th, uk
French Southern Territories
TF
Can also be loaded as country FR, subdivision TF
en_US, fr, th, uk
Gabon
GA
Gambia
GM
en_GM, en_US
Georgia
GE
en_US, ka, uk
Germany
DE
States: BB (Brandenburg), BE (Berlin), BW (Baden-Württemberg), BY (Bayern), HB (Bremen), HE (Hessen), HH (Hamburg), MV (Mecklenburg-Vorpommern), NI (Niedersachsen), NW (Nordrhein-Westfalen), RP (Rheinland-Pfalz), SH (Schleswig-Holstein), SL (Saarland), SN (Sachsen), ST (Sachsen-Anhalt), TH (Thüringen); cities: Augsburg
de, en_US, th, uk
CATHOLIC
Ghana
GH
Gibraltar
GI
en_GB, en_US
Greece
GR
el, en_US, uk
HALF_DAY
Greenland
GL
da, en_US, fi, is, kl, no, sv, uk
OPTIONAL
Grenada
GD
en_GD, en_US
Guadeloupe
GP
Can also be loaded as country FR, subdivision 971
en_US, fr, th, uk
Guam
GU
Can also be loaded as country US, subdivision GU
en_US, th
GOVERNMENT, UNOFFICIAL
Guatemala
GT
en_US, es
Guernsey
GG
Guinea
GN
en_US, fr
Guinea-Bissau
GW
en_US, pt_GW
Guyana
GY
en_GY, en_US
Haiti
HT
en_US, es, fr_HT, ht
OPTIONAL
Heard Island and McDonald Islands
HM
Honduras
HN
en_US, es, uk
Hong Kong
HK
en_HK, en_US, th, zh_CN, zh_HK
OPTIONAL
Hungary
HU
en_US, hu, uk
Iceland
IS
en_US, is, uk
HALF_DAY
India
IN
States: AN (Andaman and Nicobar Islands), AP (Andhra Pradesh), AR (Arunachal Pradesh, Arunāchal Pradesh), AS (Assam), BR (Bihar, Bihār), CG (Chhattisgarh, Chhattīsgarh), CH (Chandigarh, Chandīgarh), DH (Dadra and Nagar Haveli and Daman and Diu, Dādra and Nagar Haveli and Damān and Diu), DL (Delhi), GA (Goa), GJ (Gujarat, Gujarāt), HP (Himachal Pradesh, Himāchal Pradesh), HR (Haryana, Haryāna), JH (Jharkhand, Jhārkhand), JK (Jammu and Kashmir, Jammu and Kashmīr), KA (Karnataka, Karnātaka), KL (Kerala), LA (Ladakh, Ladākh), LD (Lakshadweep), MH (Maharashtra, Mahārāshtra), ML (Meghalaya, Meghālaya), MN (Manipur), MP (Madhya Pradesh), MZ (Mizoram), NL (Nagaland, Nāgāland), OD (Odisha), PB (Punjab), PY (Puducherry), RJ (Rajasthan, Rājasthān), SK (Sikkim), TN (Tamil Nadu, Tamil Nādu), TR (Tripura), TS (Telangana, Telangāna), UK (Uttarakhand, Uttarākhand), UP (Uttar Pradesh), WB (West Bengal)
en_IN, en_US, hi
OPTIONAL
Indonesia
ID
en_US, id, th, uk
GOVERNMENT
Iran
IR
en_US, fa_IR
Iraq
IQ
ar, en_US
CHRISTIAN, HEBREW, SABIAN, YAZIDI
Ireland
IE
Isle of Man
IM
en_GB, en_US, th
Israel
IL
en_US, he, th, uk
OPTIONAL, SCHOOL
Italy
IT
Provinces: AG (Agrigento), AL (Alessandria), AN (Ancona), AO (Aosta), AP (Ascoli Piceno), AQ (L'Aquila), AR (Arezzo), AT (Asti), AV (Avellino), BA (Bari), BG (Bergamo), BI (Biella), BL (Belluno), BN (Benevento), BO (Bologna), BR (Brindisi), BS (Brescia), BT (Barletta-Andria-Trani), BZ (Bolzano), CA (Cagliari), CB (Campobasso), CE (Caserta), CH (Chieti), CL (Caltanissetta), CN (Cuneo), CO (Como), CR (Cremona), CS (Cosenza), CT (Catania), CZ (Catanzaro), EN (Enna), FC (Forli-Cesena, Forlì-Cesena), FE (Ferrara), FG (Foggia), FI (Firenze), FM (Fermo), FR (Frosinone), GE (Genova), GO (Gorizia), GR (Grosseto), IM (Imperia), IS (Isernia), KR (Crotone), LC (Lecco), LE (Lecce), LI (Livorno), LO (Lodi), LT (Latina), LU (Lucca), MB (Monza e Brianza), MC (Macerata), ME (Messina), MI (Milano), MN (Mantova), MO (Modena), MS (Massa-Carrara), MT (Matera), NA (Napoli), NO (Novara), NU (Nuoro), OR (Oristano), PA (Palermo), PC (Piacenza), PD (Padova), PE (Pescara), PG (Perugia), PI (Pisa), PN (Pordenone), PO (Prato), PR (Parma), PT (Pistoia), PU (Pesaro e Urbino), PV (Pavia), PZ (Potenza), RA (Ravenna), RC (Reggio Calabria), RE (Reggio Emilia), RG (Ragusa), RI (Rieti), RM (Roma), RN (Rimini), RO (Rovigo), SA (Salerno), SI (Siena), SO (Sondrio), SP (La Spezia), SR (Siracusa), SS (Sassari), SU (Sud Sardegna), SV (Savona), TA (Taranto), TE (Teramo), TN (Trento), TO (Torino), TP (Trapani), TR (Terni), TS (Trieste), TV (Treviso), UD (Udine), VA (Varese), VB (Verbano-Cusio-Ossola), VC (Vercelli), VE (Venezia), VI (Vicenza), VR (Verona), VT (Viterbo), VV (Vibo Valentia); cities: Andria, Barletta, Cesena, Forli (Forlì), Pesaro, Trani, Urbino
Ivory Coast
CI
en_CI, en_US, fr
Jamaica
JM
Japan
JP
en_US, ja, th
BANK
Jersey
JE
Jordan
JO
ar, en_US
Kazakhstan
KZ
en_US, kk, uk
Kenya
KE
en_KE, en_US, sw
HINDU, ISLAMIC
Kiribati
KI
Kuwait
KW
ar, en_US
Kyrgyzstan
KG
Laos
LA
en_US, lo, th
BANK, SCHOOL, WORKDAY
Latvia
LV
en_US, lv, uk
Lebanon
LB
ar, en_US
BANK, GOVERNMENT
Lesotho
LS
Liberia
LR
Libya
LY
ar, en_US
WORKDAY
Liechtenstein
LI
de, en_US, uk
BANK
Lithuania
LT
en_US, lt, uk
Luxembourg
LU
de, en_US, fr, lb, uk
BANK
Macau
MO
Historical municipalities: I (Concelho das Ilhas, 海島市, 海岛市), M (Concelho de Macau, 澳門市, 澳门市)
en_MO, en_US, pt_MO, th, zh_CN, zh_MO
GOVERNMENT, OPTIONAL
Madagascar
MG
en_US, mg, uk
Malawi
MW
Malaysia
MY
States and federal territories: 01 (Johor, JHR), 02 (Kedah, KDH), 03 (Kelantan, KTN), 04 (Melaka, MLK), 05 (Negeri Sembilan, NSN), 06 (Pahang, PHG), 07 (Pulau Pinang, PNG), 08 (Perak, PRK), 09 (Perlis, PLS), 10 (Selangor, SGR), 11 (Terengganu, TRG), 12 (Sabah, SBH), 13 (Sarawak, SWK), 14 (Wilayah Persekutuan Kuala Lumpur, KUL), 15 (Wilayah Persekutuan Labuan, LBN), 16 (Wilayah Persekutuan Putrajaya, PJY)
en_US, ms_MY, th
Maldives
MV
Mali
ML
en_US, fr
Malta
MT
en_US, mt
Marshall Islands (the)
MH
Martinique
MQ
Can also be loaded as country FR, subdivision 972
en_US, fr, th, uk
Mauritania
MR
Mauritius
MU
en_MU, en_US
Mayotte
YT
Can also be loaded as country FR, subdivision 976
en_US, fr, th, uk
Mexico
MX
en_US, es, uk
Micronesia
FM
States: KSA (Kosrae, Kusaie), PNI (Pohnpei, Ponape), TRK (Chuuk, Truk), YAP (Yap)
en_FM, en_US
Moldova
MD
en_US, ro, uk
Monaco
MC
en_US, fr, uk
Mongolia
MN
en_US, mn
WORKDAY
Montenegro
ME
cnr, en_US, uk
CATHOLIC, HEBREW, ISLAMIC, ORTHODOX, WORKDAY
Montserrat
MS
en_MS, en_US
Morocco
MA
ar, en_US, fr
Mozambique
MZ
en_US, pt_MZ, uk
Myanmar
MM
en_US, my, th
Namibia
NA
en_NA, en_US, uk
Nauru
NR
en_NR, en_US
Nepal
NP
WORKDAY
Netherlands
NL
en_US, fy, nl, th, uk
OPTIONAL
New Caledonia
NC
Can also be loaded as country FR, subdivision NC
en_US, fr, th, uk
New Zealand
NZ
Regions and Special Island Authorities: AUK (Auckland, Tāmaki-Makaurau, AU), BOP (Bay of Plenty, Toi Moana, BP), CAN (Canterbury, Waitaha, CA), CIT (Chatham Islands Territory, Chatham Islands, Wharekauri, CI), GIS (Gisborne, Te Tairāwhiti, GI), HKB (Hawke's Bay, Te Matau-a-Māui, HB), MBH (Marlborough, MA), MWT (Manawatū Whanganui, Manawatū-Whanganui, MW), NSN (Nelson, Whakatū, NE), NTL (Northland, Te Taitokerau, NO), OTA (Otago, Ō Tākou, OT), STL (Southland, Te Taiao Tonga, SO), TAS (Tasman, Te tai o Aorere, TS), TKI (Taranaki, TK), WGN (Greater Wellington, Te Pane Matua Taiao, Wellington, Te Whanganui-a-Tara, WG), WKO (Waikato, WK), WTC (West Coast, Te Tai o Poutini, WC); subregions: South Canterbury
Nicaragua
NI
Subdivisions: AN (Costa Caribe Norte), AS (Costa Caribe Sur), BO (Boaco), CA (Carazo), CI (Chinandega), CO (Chontales), ES (Estelí), GR (Granada), JI (Jinotega), LE (León), MD (Madriz), MN (Managua), MS (Masaya), MT (Matagalpa), NS (Nueva Segovia), RI (Rivas), SJ (Río San Juan)
en_US, es, uk
Niger
NE
en_US, fr_NE
OPTIONAL
Nigeria
NG
en_NG, en_US
Niue
NU
en_NU, en_US
Norfolk Island
NF
en_NF, en_US
Northern Mariana Islands (the)
MP
Can also be loaded as country US, subdivision MP
en_US, th
GOVERNMENT, UNOFFICIAL
North Korea
KP
en_US, ko_KP
North Macedonia
MK
en_US, mk, uk
ALBANIAN, BOSNIAN, CATHOLIC, HEBREW, ISLAMIC, ORTHODOX, ROMA, SERBIAN, TURKISH, VLACH
Norway
NO
Counties and Arctic Regions: 03 (Oslo), 11 (Rogaland), 15 (Møre og Romsdal), 18 (Nordland), 21 (Svalbard), 22 (Jan Mayen), 31 (Østfold), 32 (Akershus), 33 (Buskerud), 34 (Innlandet), 39 (Vestfold), 40 (Telemark), 42 (Agder), 46 (Vestland), 50 (Trööndelage, Trøndelag), 55 (Romssa, Troms, Tromssan), 56 (Finmarkun, Finnmark, Finnmárkku)
en_US, no, th, uk
Oman
OM
ar, en_US
Pakistan
PK
en_PK, en_US, ur_PK
Palau
PW
ARMED_FORCES, HALF_DAY
Palestine
PS
ar, en_US
CATHOLIC, ORTHODOX
Panama
PA
en_US, es, uk
BANK
Papua New Guinea
PG
Paraguay
PY
en_US, es, uk
GOVERNMENT
Peru
PE
en_US, es, uk
Philippines
PH
en_PH, en_US, fil, th
WORKDAY
Pitcairn Islands
PN
GOVERNMENT, WORKDAY
Poland
PL
de, en_US, pl, uk
Portugal
PT
Districts: 01 (Aveiro), 02 (Beja), 03 (Braga), 04 (Bragança), 05 (Castelo Branco), 06 (Coimbra), 07 (Évora), 08 (Faro), 09 (Guarda), 10 (Leiria), 11 (Lisboa), 12 (Portalegre), 13 (Porto), 14 (Santarém), 15 (Setúbal), 16 (Viana do Castelo), 17 (Vila Real), 18 (Viseu), 20 (Região Autónoma dos Açores), 30 (Região Autónoma da Madeira)
en_US, pt_PT, uk
OPTIONAL
Puerto Rico
PR
Can also be loaded as country US, subdivision PR
en_US, th
GOVERNMENT, UNOFFICIAL
Qatar
QA
ar_QA, en_US
BANK
Reunion
RE
Can also be loaded as country FR, subdivision 974
en_US, fr, th, uk
Romania
RO
en_US, ro, uk
Russia
RU
en_US, ru, th
Rwanda
RW
en_US, fr, rw
Saint Barthélemy
BL
Can also be loaded as country FR, subdivision BL
en_US, fr, th, uk
Saint Helena, Ascension and Tristan da Cunha
SH
Subdivisions: AC (Ascension), HL (Saint Helena), TA (Tristan da Cunha)
en_GB, en_US
GOVERNMENT
Saint Kitts and Nevis
KN
HALF_DAY, WORKDAY
Saint Lucia
LC
en_LC, en_US
Saint Martin
MF
Can also be loaded as country FR, subdivision MF
en_US, fr, th, uk
Saint Pierre and Miquelon
PM
Can also be loaded as country FR, subdivision PM
en_US, fr, th, uk
Saint Vincent and the Grenadines
VC
en_US, en_VC
Samoa
WS
San Marino
SM
en_US, it, uk
BANK
Sao Tome and Principe
ST
Districts and Autonomous Region: 01 (Água Grande), 02 (Cantagalo), 03 (Caué), 04 (Lembá), 05 (Lobata), 06 (Mé-Zóchi), P (Príncipe)
en_US, pt_ST
Saudi Arabia
SA
ar, en_US
Senegal
SN
en_US, fr_SN
Serbia
RS
en_US, sr
Seychelles
SC
en_SC, en_US
Sierra Leone
SL
en_SL, en_US
Singapore
SG
en_SG, en_US, th
Sint Maarten
SX
en_US, nl
Slovakia
SK
en_US, sk, uk
WORKDAY
Slovenia
SI
en_US, sl, uk
WORKDAY
Solomon Islands
SB
Subdivisions: CE (Central), CH (Choiseul), CT (Capital Territory, Honiara), GU (Guadalcanal), IS (Isabel), MK (Makira-Ulawa), ML (Malaita), RB (Rennell and Bellona), TE (Temotu), WE (Western)
Somalia
SO
South Africa
ZA
South Georgia and the South Sandwich Islands
GS
en_GS, en_US
South Korea
KR
en_US, ko, th
BANK
South Sudan
SS
ISLAMIC
Spain
ES
Autonomous communities: AN (Andalucía), AR (Aragón), AS (Asturias), CB (Cantabria), CE (Ceuta), CL (Castilla y León), CM (Castilla-La Mancha), CN (Canarias), CT (Cataluña, Catalunya), EX (Extremadura), GA (Galicia), IB (Islas Baleares, Illes Balears), MC (Murcia), MD (Madrid), ML (Melilla), NC (Navarra), PV (País Vasco), RI (La Rioja), VC (Valenciana)
ca, en_US, es, uk
Sri Lanka
LK
en_US, si_LK, ta_LK
BANK, GOVERNMENT, WORKDAY
Sudan
SD
ar_SD, en_US
Suriname
SR
en_US, nl
Svalbard and Jan Mayen
SJ
Can also be loaded as country NO, subdivision 21 and 22
en_US, no, th, uk
Sweden
SE
en_US, sv, th, uk
Switzerland
CH
Cantons: AG (Aargau), AI (Appenzell Innerrhoden), AR (Appenzell Ausserrhoden), BE (Bern, Berne), BL (Basel-Landschaft), BS (Basel-Stadt), FR (Freiburg, Fribourg), GE (Genève), GL (Glarus), GR (Graubünden, Grigioni, Grischun), JU (Jura), LU (Luzern), NE (Neuchâtel), NW (Nidwalden), OW (Obwalden), SG (Sankt Gallen), SH (Schaffhausen), SO (Solothurn), SZ (Schwyz), TG (Thurgau), TI (Ticino), UR (Uri), VD (Vaud), VS (Valais, Wallis), ZG (Zug), ZH (Zürich)
de, en_US, fr, it, th, uk
HALF_DAY, OPTIONAL
Syrian Arab Republic
SY
ar, en_US
Taiwan
TW
en_US, th, zh_CN, zh_TW
GOVERNMENT, OPTIONAL, SCHOOL, WORKDAY
Tajikistan
TJ
en_US, ru, tg
Tanzania
TZ
en_US, sw
BANK
Thailand
TH
en_US, th, uk
ARMED_FORCES, BANK, GOVERNMENT, SCHOOL, WORKDAY
Timor Leste
TL
en_TL, en_US, pt_TL, tet, th
GOVERNMENT, WORKDAY
Togo
TG
en_US, fr
WORKDAY
Tokelau
TK
en_TK, en_US, tkl
Tonga
TO
en_US, to
Trinidad and Tobago
TT
en_TT, en_US
OPTIONAL
Tunisia
TN
ar, en_US
Turkey
TR
en_US, tr, uk
HALF_DAY
Turkmenistan
TM
en_US, ru, tk
Turks and Caicos Islands
TC
en_TC, en_US
Tuvalu
TV
Town/Island Councils: FUN (Funafuti), NIT (Niutao), NKF (Nukufetau), NKL (Nukulaelae), NMA (Nanumea), NMG (Nanumaga, Nanumanga), NUI (Nui), VAI (Vaitupu)
en_GB, en_US, tvl
Uganda
UG
Ukraine
UA
ar, en_US, th, uk
WORKDAY
United Arab Emirates
AE
ar, en_US, th
GOVERNMENT, OPTIONAL
United Kingdom
GB
Subdivisions: ENG (England), NIR (Northern Ireland), SCT (Scotland), WLS (Wales)
en_GB, en_US, th
United States Minor Outlying Islands
UM
Can also be loaded as country US, subdivision UM
en_US, th
GOVERNMENT, UNOFFICIAL
United States of America (the)
US
States and territories: AK (Alaska), AL (Alabama), AR (Arkansas), AS (American Samoa), AZ (Arizona), CA (California), CO (Colorado), CT (Connecticut), DC (District of Columbia), DE (Delaware), FL (Florida), GA (Georgia), GU (Guam), HI (Hawaii), IA (Iowa), ID (Idaho), IL (Illinois), IN (Indiana), KS (Kansas), KY (Kentucky), LA (Louisiana), MA (Massachusetts), MD (Maryland), ME (Maine), MI (Michigan), MN (Minnesota), MO (Missouri), MP (Northern Mariana Islands), MS (Mississippi), MT (Montana), NC (North Carolina), ND (North Dakota), NE (Nebraska), NH (New Hampshire), NJ (New Jersey), NM (New Mexico), NV (Nevada), NY (New York), OH (Ohio), OK (Oklahoma), OR (Oregon), PA (Pennsylvania), PR (Puerto Rico), RI (Rhode Island), SC (South Carolina), SD (South Dakota), TN (Tennessee), TX (Texas), UM (United States Minor Outlying Islands), UT (Utah), VA (Virginia), VI (Virgin Islands, U.S.), VT (Vermont), WA (Washington), WI (Wisconsin), WV (West Virginia), WY (Wyoming)
en_US, th
GOVERNMENT, UNOFFICIAL
United States Virgin Islands (the)
See Virgin Islands (U.S.)
GOVERNMENT, UNOFFICIAL
Uruguay
UY
en_US, es, uk
BANK
Uzbekistan
UZ
en_US, uk, uz
Vanuatu
VU
Vatican City
VA
en_US, it, th
Venezuela
VE
en_US, es, uk
Vietnam
VN
en_US, th, vi
Virgin Islands (U.S.)
VI
Can also be loaded as country US, subdivision VI
en_US, th
GOVERNMENT, UNOFFICIAL
Wallis and Futuna
WF
Can also be loaded as country FR, subdivision WF
en_US, fr, th, uk
Western Sahara
EH
ar, en_US, es, fr
Yemen
YE
ar, en_US
SCHOOL, WORKDAY
Zambia
ZM
Zimbabwe
ZW
## Available Financial Markets
The standard way to refer to a financial market is to use its [ISO 10383
MIC](https://www.iso20022.org/market-identifier-codes) (Market Identifier Code) as a "market"
code when available. The following financial markets are available:
Entity
Code
Info
Supported Languages
Brasil, Bolsa, Balcão
BVMF
Brazil Stock Exchange and Over-the-Counter Market holidays (same as ANBIMA holidays)
en_US, pt_BR, uk
European Central Bank
XECB
Trans-European Automated Real-time Gross Settlement (TARGET2)
ICE Futures Europe
IFEU
A London-based Investment Exchange holidays
National Stock Exchange of India
XNSE
National Stock Exchange of India market holidays
en_IN, en_US, hi
New York Stock Exchange
XNYS
NYSE market holidays (used by all other US-exchanges, including NASDAQ, etc.)
## Contributions
[Issues](https://github.com/vacanza/holidays/issues) and [pull
requests](https://github.com/vacanza/holidays/pulls) are always welcome. Please see
[here](https://github.com/vacanza/holidays/blob/dev/CONTRIBUTING.md) for more information.
## License
Code and documentation are available according to the MIT License (see
[LICENSE](https://github.com/vacanza/holidays/blob/dev/LICENSE)).