https://github.com/vacanza/holidays
Open World Holidays Framework
https://github.com/vacanza/holidays
calendar gsoc holiday holiday-api holiday-calculation python
Last synced: 6 months ago
JSON representation
Open World Holidays Framework
- Host: GitHub
- URL: https://github.com/vacanza/holidays
- Owner: vacanza
- License: mit
- Created: 2014-08-24T15:17:18.000Z (about 11 years ago)
- Default Branch: dev
- Last Pushed: 2025-05-05T17:14:53.000Z (6 months ago)
- Last Synced: 2025-05-06T02:19:23.904Z (6 months ago)
- Topics: calendar, gsoc, holiday, holiday-api, holiday-calculation, python
- Language: Python
- Homepage: https://pypi.org/project/holidays
- Size: 15.8 MB
- Stars: 1,618
- Watchers: 20
- Forks: 532
- Open Issues: 127
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- best-of-python - GitHub - 8% open · ⏱️ 20.10.2025): (Date & Time Utilities)
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
Snyk
## 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 171 country codes. 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
Albania
AL
en_US, sq, uk
Algeria
DZ
ar, en_US, fr
American Samoa
AS
Can also be loaded as country US, subdivision AS
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)
Angola
AO
en_US, pt_AO, uk
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
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
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
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
Colombia
CO
en_US, es, uk
Congo
CG
en_US, fr
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
Estonia
EE
en_US, et, uk
Eswatini
SZ
Ethiopia
ET
am, ar, en_ET, en_US
WORKDAY
Fiji
FJ
WORKDAY
Finland
FI
en_US, fi, sv_FI, uk
UNOFFICIAL
France
FR
DOM/TOM: BL (Saint-Barthélemy), GES (Alsace, Champagne-Ardenne, Lorraine), GP (Guadeloupe), GY (Guyane), MF (Saint-Martin), MQ (Martinique), NC (Nouvelle-Calédonie), PF (Polynésie Française), RE (La Réunion), WF (Wallis-et-Futuna), YT (Mayotte)
en_US, fr, uk
French Southern Territories
TF
en_US, fr, 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
Guam
GU
Can also be loaded as country US, subdivision GU
GOVERNMENT, UNOFFICIAL
Guatemala
GT
en_US, es
Guernsey
GG
Guinea
GN
en_US, fr
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
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
Mauritania
MR
Mexico
MX
en_US, es, uk
Moldova
MD
en_US, ro, uk
Monaco
MC
en_US, fr, uk
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
Netherlands
NL
en_US, fy, nl, uk
OPTIONAL
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
Nigeria
NG
Northern Mariana Islands (the)
MP
Can also be loaded as country US, subdivision MP
GOVERNMENT, UNOFFICIAL
North Macedonia
MK
Norway
NO
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
GOVERNMENT, UNOFFICIAL
Qatar
QA
ar_QA, en_US
BANK
Romania
RO
en_US, ro, uk
Russia
RU
en_US, ru, th
Saint Kitts and Nevis
KN
HALF_DAY, WORKDAY
Saint Lucia
LC
en_LC, en_US
Samoa
WS
San Marino
SM
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
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
Slovakia
SK
en_US, sk, uk
WORKDAY
Slovenia
SI
en_US, sl, uk
WORKDAY
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
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
ARMED_FORCES, BANK, GOVERNMENT, SCHOOL, WORKDAY
Timor Leste
TL
en_TL, en_US, pt_TL, tet, th
GOVERNMENT, 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
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
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)
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
GOVERNMENT, UNOFFICIAL
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
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)).