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
Snyk

Install

The latest stable version can always be installed or updated via pip:

pip install --upgrade holidays

The latest development (dev) version can be installed directly from GitHub:

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.

Quick Start

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:

'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:

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 for additional examples
and detailed information.

Available Countries

We currently support 208 country codes. The standard way to refer to a country is by using its ISO
3166-1 alpha-2 code, the same used
for domain names, and for a subdivision its ISO 3166-2
code. 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. A list of all languages supported by
country is defined by supported_languages (optional) attribute. If there is no designated ISO
639-1 code then ISO 639-2
code 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
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
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
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
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 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
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
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
Cocos Islands	CC		coa_CC, en_CC, en_US
Colombia	CO		en_US, es, uk
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, uk	OPTIONAL
Djibouti	DJ		ar, en_US, fr
Dominica	DM
Dominican Republic	DO		en_US, es, uk
Ecuador	EC		en_US, es, uk
Egypt	EG		ar, en_US
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
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
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
Georgia	GE		en_US, ka, uk	GOVERNMENT
Germany	DE	Lands: 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)	de, en_US, th, uk	CATHOLIC
Ghana	GH
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
Guyana	GY		en_GY, en_US
Haiti	HT		en_US, es, fr_HT, ht	OPTIONAL
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
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
Kuwait	KW		ar, en_US
Kyrgyzstan	KG
Laos	LA		en_US, lo, th	BANK, SCHOOL, WORKDAY
Latvia	LV		en_US, lv, uk
Lesotho	LS
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
Macau	MO	Historical municipalities: I (Concelho das Ilhas, 海島市, 海岛市), M (Concelho de Macau, 澳門市, 澳门市)	en_MO, en_US, pt_MO, th, zh_CN, zh_MO	GOVERNMENT, MANDATORY
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
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
Morocco	MA		ar, en_US, fr
Mozambique	MZ		en_US, pt_MZ, uk
Namibia	NA		en_NA, en_US, uk
Nauru	NR		en_NR, en_US
Nepal	NP			WORKDAY
Netherlands	NL		en_US, fy, nl, 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
Northern Mariana Islands (the)	MP	Can also be loaded as country US, subdivision MP	en_US, th	GOVERNMENT, UNOFFICIAL
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), 30 (Viken), 34 (Innlandet), 38 (Vestfold og Telemark), 42 (Agder), 46 (Vestland), 50 (Trööndelage, Trøndelag), 54 (Romssa ja Finnmárkku, Troms og Finnmark, Tromssan ja Finmarkun)	en_US, no, th, uk
Oman	OM		ar, en_US
Pakistan	PK		en_PK, en_US, ur_PK
Palau	PW			ARMED_FORCES, HALF_DAY
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
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
Saint Barthélemy	BL	Can also be loaded as country FR, subdivision BL	en_US, fr, th, uk
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
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)
South Africa	ZA
South Korea	KR		en_US, ko, th	BANK
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)	en_US, es, uk
Sri Lanka	LK		en_US, si_LK, ta_LK	BANK, GOVERNMENT, WORKDAY
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, uk	HALF_DAY, OPTIONAL
Taiwan	TW		en_US, th, zh_CN, zh_TW	GOVERNMENT, OPTIONAL, SCHOOL, WORKDAY
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
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
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
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
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 (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
New York Stock Exchange	XNYS	NYSE market holidays (used by all other US-exchanges, including NASDAQ, etc.)

Contributions

Issues and pull
requests are always welcome. Please see
here for more information.

License

Code and documentation are available according to the MIT License (see
LICENSE).

Package profile

holidays

Releases

Release table

PyPI Downloads

Dependencies

Details

Project URLs

Dependencies

Package description