holidays


Nameholidays JSON
Version 0.48 PyPI version JSON
download
home_pageNone
SummaryGenerate and work with holidays in Python
upload_time2024-05-06 16:47:37
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseCopyright (c) Vacanza Team and individual contributors (see AUTHORS file) Copyright (c) dr-prodigy <dr.prodigy.github@gmail.com>, 2017-2023 Copyright (c) ryanss <ryanssdev@icloud.com>, 2014-2017 All rights reserved. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords holidays calendar l10n
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ========
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.

.. |downloads| image:: https://img.shields.io/pypi/dm/holidays?color=41B5BE&style=flat
    :target: https://pypi.org/project/holidays
    :alt: PyPI downloads

.. |version| image:: https://img.shields.io/pypi/v/holidays?color=41B5BE&label=version&style=flat
    :target: https://pypi.org/project/holidays
    :alt: PyPI version

.. |release date| image:: https://img.shields.io/github/release-date/vacanza/python-holidays?color=41B5BE&style=flat
    :target: https://github.com/vacanza/python-holidays/releases
    :alt: PyPI release date

.. |status| image:: https://img.shields.io/github/actions/workflow/status/vacanza/python-holidays/ci-cd.yml?branch=dev&color=41BE4A&style=flat
    :target: https://github.com/vacanza/python-holidays/actions/workflows/ci-cd.yml?query=branch%3Adev
    :alt: CI/CD status

.. |documentation| image:: https://img.shields.io/readthedocs/python-holidays?color=41BE4A&style=flat
    :target: https://python-holidays.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation status

.. |license| image:: https://img.shields.io/github/license/vacanza/python-holidays?color=41B5BE&style=flat
    :target: https://github.com/vacanza/python-holidays/blob/dev/LICENSE
    :alt: License

.. |python versions| image:: https://img.shields.io/pypi/pyversions/holidays?label=python&color=41B5BE&style=flat
    :target: https://pypi.org/project/holidays
    :alt: Python supported versions

.. |style| image:: https://img.shields.io/badge/style-ruff-41B5BE?style=flat
    :target: https://github.com/astral-sh/ruff
    :alt: Code style

.. |coverage| image:: https://img.shields.io/coverallsCoverage/github/vacanza/python-holidays?branch=main&color=41B5BE&style=flat
    :target: https://coveralls.io/r/vacanza/python-holidays
    :alt: Code coverage

.. |stars| image:: https://img.shields.io/github/stars/vacanza/python-holidays?color=41BE4A&style=flat
    :target: https://github.com/vacanza/python-holidays/stargazers
    :alt: GitHub stars

.. |forks| image:: https://img.shields.io/github/forks/vacanza/python-holidays?color=41BE4A&style=flat
    :target: https://github.com/vacanza/python-holidays/forks
    :alt: GitHub forks

.. |contributors| image:: https://img.shields.io/github/contributors/vacanza/python-holidays?color=41BE4A&style=flat
    :target: https://github.com/vacanza/python-holidays/graphs/contributors
    :alt: GitHub contributors

.. |last commit| image:: https://img.shields.io/github/last-commit/vacanza/python-holidays/dev?color=41BE4A&style=flat
    :target: https://github.com/vacanza/python-holidays/commits/dev
    :alt: GitHub last commit

+--------+------------------------------------------------+
| PyPI   | |downloads| |version| |release date|           |
+--------+------------------------------------------------+
| CI/CD  | |status| |documentation|                       |
+--------+------------------------------------------------+
| Code   | |license| |python versions| |style| |coverage| |
+--------+------------------------------------------------+
| GitHub | |stars| |forks| |contributors| |last commit|   |
+--------+------------------------------------------------+

Install
-------

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

.. code-block:: shell

    $ pip install --upgrade holidays

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

.. code-block:: shell

    $ pip install --upgrade https://github.com/vacanza/python-holidays/tarball/dev

All new features are always first pushed to dev branch, then released on
main branch upon official version upgrades.

Documentation
-------------

.. _Read the Docs: https://python-holidays.readthedocs.io/

The documentation is hosted on `Read the Docs`_.


Quick Start
-----------

.. code-block:: python

    from datetime import date
    import holidays

    us_holidays = holidays.US()  # this is a dict
    # the below is the same, but takes a string:
    us_holidays = holidays.country_holidays('US')  # this is a dict

    nyse_holidays = holidays.NYSE()  # this is a dict
    # the below is the same, but takes a string:
    nyse_holidays = holidays.financial_holidays('NYSE')  # this is a dict

    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:

.. code-block:: 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:

.. code-block:: 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

.. _python-holidays documentation: https://python-holidays.readthedocs.io/

Please see the `python-holidays documentation`_ for additional examples and
detailed information.


Available Countries
-------------------

.. _ISO 3166-1 alpha-2 code: https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes
.. _ISO 3166-2 code: https://en.wikipedia.org/wiki/ISO_3166-2
.. _ISO 639-1 code: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
.. _ISO 639-2 code: https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes

We currently support 147 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:


.. list-table::
   :widths: 20 4 46 20 10
   :header-rows: 1
   :class: tight-table

   * - Country
     - Code
     - Subdivisions
     - Supported Languages
     - Supported Categories
   * - Albania
     - AL
     -
     -
     -
   * - Algeria
     - DZ
     -
     - **ar**, en_US, fr
     -
   * - American Samoa
     - AS
     - Can also be loaded as country US, subdivision AS
     -
     - UNOFFICIAL
   * - Andorra
     - AD
     - Parishes: 02, 03, 04, 05, 06, 07, 08
     -
     -
   * - Angola
     - AO
     -
     - en_US, **pt_AO**, uk
     -
   * - Argentina
     - AR
     -
     - en_US, **es**, uk
     -
   * - Armenia
     - AM
     -
     - en_US, **hy**
     -
   * - Aruba
     - AW
     -
     - en_US, nl, **pap**, 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)
     -
     - 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
     -
   * - Belgium
     - BE
     -
     - de, en_US, fr, **nl**, uk
     - BANK
   * - Belize
     - BZ
     -
     -
     -
   * - Bolivia
     - BO
     - Departments: B, C, H, L, N, O, P, S, T
     - en_US, **es**, uk
     -
   * - Bosnia and Herzegovina
     - BA
     - Entities and district: BIH, BRC, SRP
     - **bs**, en_US, sr, uk
     -
   * - Botswana
     - BW
     -
     -
     -
   * - Brazil
     - BR
     - States: AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE, PI, PR, RJ, RN, RO, RR, RS, SC, SE, SP, TO
     -
     - 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, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT
     - ar, **en_CA**, en_US, fr, th
     - GOVERNMENT, OPTIONAL
   * - Chad
     - TD
     -
     -
     -
   * - Chile
     - CL
     - Regions: AI, AN, AP, AR, AT, BI, CO, LI, LL, LR, MA, ML, NB, RM, TA, VS
     - en_US, **es**, uk
     -
   * - China
     - CN
     -
     - en_US, th, **zh_CN**, zh_TW
     - HALF_DAY
   * - Colombia
     - CO
     -
     - en_US, **es**, uk
     -
   * - 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**, uk
     -
   * - 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**
     -
   * - Dominican Republic
     - DO
     -
     - en_US, **es**, uk
     -
   * - Ecuador
     - EC
     -
     - en_US, **es**, uk
     -
   * - Egypt
     - EG
     -
     - **ar**, en_US
     -
   * - El Salvador
     - SV
     - Departments: AH, CA, CH, CU, LI, MO, PA, SA, SM, SO, SS, SV, UN, US
     -
     -
   * - Estonia
     - EE
     -
     - en_US, **et**, uk
     -
   * - Eswatini
     - SZ
     -
     -
     -
   * - Ethiopia
     - ET
     -
     - **am**, ar, en_US
     -
   * - Finland
     - FI
     -
     - en_US, **fi**, sv, uk
     -
   * - France
     - FR
     - Départements: BL, GES, GP, GY, MF, MQ, NC, PF, RE, WF, YT
     - en_US, **fr**, uk
     -
   * - Gabon
     - GA
     -
     -
     -
   * - Georgia
     - GE
     -
     - en_US, **ka**, uk
     -
   * - Germany
     - DE
     - States: BB, BE, BW, BY, BYP, HB, HE, HH, MV, NI, NW, RP, SH, SL, SN, ST, TH
     - **de**, en_US, uk
     -
   * - Ghana
     - GH
     -
     -
     -
   * - Greece
     - GR
     -
     - **el**, en_US, uk
     - HALF_DAY
   * - Guam
     - GU
     - Can also be loaded as country US, subdivision GU
     -
     - UNOFFICIAL
   * - Guatemala
     - GT
     -
     - en_US, **es**
     -
   * - Honduras
     - HN
     -
     - en_US, **es**, uk
     -
   * - Hong Kong
     - HK
     -
     -
     -
   * - Hungary
     - HU
     -
     - en_US, **hu**, uk
     -
   * - Iceland
     - IS
     -
     - en_US, **is**, uk
     -
   * - India
     - IN
     - States: AN, AP, AR, AS, BR, CG, CH, DD, DH, DL, GA, GJ, HP, HR, JH, JK, KA, KL, LA, LD, MH, ML, MN, MP, MZ, NL, OR, PB, PY, RJ, SK, TN, TR, TS, UK, UP, WB
     -
     -
   * - Indonesia
     - ID
     -
     - en_US, **id**, uk
     - GOVERNMENT
   * - Iran
     - IR
     -
     - en_US, **fa**
     -
   * - Ireland
     - IE
     -
     -
     -
   * - Isle of Man
     - IM
     -
     -
     -
   * - Israel
     - IL
     -
     - en_US, **he**, uk
     - OPTIONAL, SCHOOL
   * - Italy
     - IT
     - Provinces: AG, AL, AN, AO, AP, AQ, AR, AT, AV, BA, BG, BI, BL, BN, BO, BR, BS, BT, BZ, CA, CB, CE, CH, CL, CN, CO, CR, CS, CT, CZ, EN, FC, FE, FG, FI, FM, FR, GE, GO, GR, IM, IS, KR, LC, LE, LI, LO, LT, LU, MB, MC, ME, MI, MN, MO, MS, MT, NA, NO, NU, OR, PA, PC, PD, PE, PG, PI, PN, PO, PR, PT, PU, PV, PZ, RA, RC, RE, RG, RI, RM, RN, RO, SA, SI, SO, SP, SR, SS, SU, SV, TA, TE, TN, TO, TP, TR, TS, TV, UD, VA, VB, VC, VE, VI, VR, VT, VV. Cities: Andria, Barletta, Cesena, Forli, Pesaro, Trani, Urbino
     -
     -
   * - Jamaica
     - JM
     -
     -
     -
   * - Japan
     - JP
     -
     - en_US, **ja**, th
     - BANK
   * - Jersey
     - JE
     -
     -
     -
   * - Jordan
     - JO
     -
     - **ar**, en_US
     -
   * - Kazakhstan
     - KZ
     -
     -
     -
   * - Kenya
     - KE
     -
     -
     -
   * - 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
     -
   * - Madagascar
     - MG
     -
     - en_US, **mg**, uk
     -
   * - Malawi
     - MW
     -
     -
     -
   * - Malaysia
     - MY
     - States: JHR, KDH, KTN, KUL, LBN, MLK, NSN, PHG, PJY, PLS, PNG, PRK, SBH, SGR, SWK, TRG
     -
     -
   * - Maldives
     - MV
     -
     -
     -
   * - Malta
     - MT
     -
     - en_US, **mt**
     -
   * - Marshall Islands (the)
     - MH
     -
     -
     -
   * - Mexico
     - MX
     -
     - en_US, **es**, uk
     -
   * - Moldova
     - MD
     -
     - en_US, **ro**, uk
     -
   * - Monaco
     - MC
     -
     - en_US, **fr**, uk
     -
   * - Montenegro
     - ME
     -
     -
     -
   * - Morocco
     - MA
     -
     - **ar**, en_US, fr
     -
   * - Mozambique
     - MZ
     -
     - en_US, **pt_MZ**, uk
     -
   * - Namibia
     - NA
     -
     -
     -
   * - Netherlands
     - NL
     -
     - en_US, **nl**, uk
     - OPTIONAL
   * - New Zealand
     - NZ
     - Regions: AUK, BOP, CAN, CIT, GIS, HKB, MBH, MWT, NSN, NTL, OTA, STL, TAS, TKI, WGN, WKO, WTC
     -
     -
   * - Nicaragua
     - NI
     - Departments: AN, AS, BO, CA, CI, CO, ES, GR, JI, LE, MD, **MN**, MS, MT, NS, RI, SJ
     - en_US, **es**, uk
     -
   * - Nigeria
     - NG
     -
     -
     -
   * - Northern Mariana Islands (the)
     - MP
     - Can also be loaded as country US, subdivision MP
     -
     - UNOFFICIAL
   * - North Macedonia
     - MK
     -
     -
     -
   * - Norway
     - NO
     -
     - en_US, **no**, uk
     -
   * - Pakistan
     - PK
     -
     -
     -
   * - Palau
     - PW
     -
     -
     - ARMED_FORCES, HALF_DAY
   * - Panama
     - PA
     -
     -
     -
   * - Papua New Guinea
     - PG
     -
     -
     -
   * - Paraguay
     - PY
     -
     - en_US, **es**, uk
     - GOVERNMENT
   * - Peru
     - PE
     -
     - en_US, **es**, uk
     -
   * - Philippines
     - PH
     -
     -
     -
   * - Poland
     - PL
     -
     - en_US, **pl**, uk
     -
   * - Portugal
     - PT
     - Districts: 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15, 16, 17, 18, 20, 30
     - en_US, **pt_PT**, uk
     - OPTIONAL
   * - Puerto Rico
     - PR
     - Can also be loaded as country US, subdivision PR
     -
     - UNOFFICIAL
   * - Romania
     - RO
     -
     - en_US, **ro**, uk
     -
   * - Russia
     - RU
     -
     - en_US, **ru**
     -
   * - San Marino
     - SM
     -
     -
     -
   * - Saudi Arabia
     - SA
     -
     - **ar**, en_US
     -
   * - Serbia
     - RS
     -
     - en_US, **sr**
     -
   * - Seychelles
     - SC
     -
     - **en_SC**, en_US
     -
   * - Singapore
     - SG
     -
     -
     -
   * - Slovakia
     - SK
     -
     - en_US, **sk**, uk
     - WORKDAY
   * - Slovenia
     - SI
     -
     - en_US, **sl**, uk
     -
   * - South Africa
     - ZA
     -
     -
     -
   * - South Korea
     - KR
     -
     - en_US, **ko**, th
     - BANK
   * - Spain
     - ES
     - Autonomous communities: AN, AR, AS, CB, CE, CL, CM, CN, CT, EX, GA, IB, MC, MD, ML, NC, PV, RI, VC
     - en_US, **es**, uk
     -
   * - Sweden
     - SE
     -
     - en_US, **sv**, uk
     -
   * - Switzerland
     - CH
     - Cantons: AG, AI, AR, BL, BS, BE, FR, GE, GL, GR, JU, LU, NE, NW, OW, SG, SH, SZ, SO, TG, TI, UR, VD, VS, ZG, ZH
     - **de**, en_US, fr, it, uk
     - HALF_DAY, OPTIONAL
   * - Taiwan
     - TW
     -
     - en_US, th, zh_CN, **zh_TW**
     -
   * - Tanzania
     - TZ
     -
     - en_US, **sw**
     - BANK
   * - Thailand
     - TH
     -
     - en_US, **th**
     - ARMED_FORCES, BANK, GOVERNMENT, SCHOOL, WORKDAY
   * - Timor Leste
     - TL
     -
     - en_US, **pt_TL**, tet
     - GOVERNMENT, WORKDAY
   * - Tonga
     - TO
     -
     - en_US, **to**
     -
   * - Tunisia
     - TN
     -
     - **ar**, en_US
     -
   * - Turkey
     - TR
     -
     - en_US, **tr**, uk
     - HALF_DAY
   * - Ukraine
     - UA
     -
     - ar, en_US, **uk**
     -
   * - United Arab Emirates
     - AE
     -
     - **ar**, en_US
     -
   * - United Kingdom
     - GB
     - Subdivisions: ENG, NIR, SCT, WLS
     -
     -
   * - United States Minor Outlying Islands
     - UM
     - Can also be loaded as country US, subdivision UM
     -
     - UNOFFICIAL
   * - United States of America (the)
     - US
     - States and territories: AK, AL, AR, AS, AZ, CA, CO, CT, DC, DE, FL, GA, GU, HI, IA, ID, IL, IN, KS, KY, LA, MA, MD, ME, MI, MN, MO, MP, MS, MT, NC, ND, NE, NH, NJ, NM, NV, NY, OH, OK, OR, PA, PR, RI, SC, SD, TN, TX, UM, UT, VA, VI, VT, WA, WI, WV, WY
     -
     - UNOFFICIAL
   * - United States Virgin Islands (the)
     -
     - See Virgin Islands (U.S.)
     -
     - UNOFFICIAL
   * - Uruguay
     - UY
     -
     - en_US, **es**, uk
     - BANK
   * - Uzbekistan
     - UZ
     -
     - en_US, uk, **uz**
     -
   * - Vanuatu
     - VU
     -
     -
     -
   * - Vatican City
     - VA
     -
     -
     -
   * - Venezuela
     - VE
     -
     - en_US, **es**, uk
     -
   * - Vietnam
     - VN
     -
     -
     -
   * - Virgin Islands (U.S.)
     - VI
     - Can also be loaded as country US, subdivision VI
     -
     - UNOFFICIAL
   * - Zambia
     - ZM
     -
     -
     -
   * - Zimbabwe
     - ZW
     -
     -
     -


Available Financial Markets
===========================

.. _ISO 10383 MIC: https://www.iso20022.org/market-identifier-codes

The standard way to refer to a financial market is to use its `ISO 10383 MIC`_
(Market Identifier Code) as a "country" code when available. The
following financial markets are available:

.. list-table::
   :widths: 23 4 83
   :header-rows: 1
   :class: tight-table

   * - Entity
     - Code
     - Info
   * - European Central Bank
     - ECB
     - Trans-European Automated Real-time Gross Settlement (TARGET2)
   * - New York Stock Exchange
     - XNYS
     - NYSE market holidays (used by all other US-exchanges, including NASDAQ, etc.)


Contributions
-------------

.. _Issues: https://github.com/vacanza/python-holidays/issues
.. _pull requests: https://github.com/vacanza/python-holidays/pulls
.. _here: https://github.com/vacanza/python-holidays/blob/dev/CONTRIBUTING.rst

Issues_ and `pull requests`_ are always welcome.  Please see
`here`_ for more information.

License
-------

.. __: https://github.com/vacanza/python-holidays/blob/dev/LICENSE

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

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "holidays",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "Arkadii Yakovets <ark@cho.red>, Serhii Murza <jhellico@gmail.com>",
    "keywords": "holidays, calendar, l10n",
    "author": null,
    "author_email": "Maurizio Montel <dr.prodigy.github@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/b6/53/4810684c6520ae0e9b2901098557aa6c804aaedf98a680e97a1c5e977080/holidays-0.48.tar.gz",
    "platform": null,
    "description": "========\nholidays\n========\n\nA fast, efficient Python library for generating country- and subdivision- (e.g.\nstate or province) specific sets of government-designated holidays on the fly.\nIt aims to make determining whether a specific date is a holiday as fast and\nflexible as possible.\n\n.. |downloads| image:: https://img.shields.io/pypi/dm/holidays?color=41B5BE&style=flat\n    :target: https://pypi.org/project/holidays\n    :alt: PyPI downloads\n\n.. |version| image:: https://img.shields.io/pypi/v/holidays?color=41B5BE&label=version&style=flat\n    :target: https://pypi.org/project/holidays\n    :alt: PyPI version\n\n.. |release date| image:: https://img.shields.io/github/release-date/vacanza/python-holidays?color=41B5BE&style=flat\n    :target: https://github.com/vacanza/python-holidays/releases\n    :alt: PyPI release date\n\n.. |status| image:: https://img.shields.io/github/actions/workflow/status/vacanza/python-holidays/ci-cd.yml?branch=dev&color=41BE4A&style=flat\n    :target: https://github.com/vacanza/python-holidays/actions/workflows/ci-cd.yml?query=branch%3Adev\n    :alt: CI/CD status\n\n.. |documentation| image:: https://img.shields.io/readthedocs/python-holidays?color=41BE4A&style=flat\n    :target: https://python-holidays.readthedocs.io/en/latest/?badge=latest\n    :alt: Documentation status\n\n.. |license| image:: https://img.shields.io/github/license/vacanza/python-holidays?color=41B5BE&style=flat\n    :target: https://github.com/vacanza/python-holidays/blob/dev/LICENSE\n    :alt: License\n\n.. |python versions| image:: https://img.shields.io/pypi/pyversions/holidays?label=python&color=41B5BE&style=flat\n    :target: https://pypi.org/project/holidays\n    :alt: Python supported versions\n\n.. |style| image:: https://img.shields.io/badge/style-ruff-41B5BE?style=flat\n    :target: https://github.com/astral-sh/ruff\n    :alt: Code style\n\n.. |coverage| image:: https://img.shields.io/coverallsCoverage/github/vacanza/python-holidays?branch=main&color=41B5BE&style=flat\n    :target: https://coveralls.io/r/vacanza/python-holidays\n    :alt: Code coverage\n\n.. |stars| image:: https://img.shields.io/github/stars/vacanza/python-holidays?color=41BE4A&style=flat\n    :target: https://github.com/vacanza/python-holidays/stargazers\n    :alt: GitHub stars\n\n.. |forks| image:: https://img.shields.io/github/forks/vacanza/python-holidays?color=41BE4A&style=flat\n    :target: https://github.com/vacanza/python-holidays/forks\n    :alt: GitHub forks\n\n.. |contributors| image:: https://img.shields.io/github/contributors/vacanza/python-holidays?color=41BE4A&style=flat\n    :target: https://github.com/vacanza/python-holidays/graphs/contributors\n    :alt: GitHub contributors\n\n.. |last commit| image:: https://img.shields.io/github/last-commit/vacanza/python-holidays/dev?color=41BE4A&style=flat\n    :target: https://github.com/vacanza/python-holidays/commits/dev\n    :alt: GitHub last commit\n\n+--------+------------------------------------------------+\n| PyPI   | |downloads| |version| |release date|           |\n+--------+------------------------------------------------+\n| CI/CD  | |status| |documentation|                       |\n+--------+------------------------------------------------+\n| Code   | |license| |python versions| |style| |coverage| |\n+--------+------------------------------------------------+\n| GitHub | |stars| |forks| |contributors| |last commit|   |\n+--------+------------------------------------------------+\n\nInstall\n-------\n\nThe latest stable version can always be installed or updated via pip:\n\n.. code-block:: shell\n\n    $ pip install --upgrade holidays\n\nThe latest development (dev) version can be installed directly from GitHub:\n\n.. code-block:: shell\n\n    $ pip install --upgrade https://github.com/vacanza/python-holidays/tarball/dev\n\nAll new features are always first pushed to dev branch, then released on\nmain branch upon official version upgrades.\n\nDocumentation\n-------------\n\n.. _Read the Docs: https://python-holidays.readthedocs.io/\n\nThe documentation is hosted on `Read the Docs`_.\n\n\nQuick Start\n-----------\n\n.. code-block:: python\n\n    from datetime import date\n    import holidays\n\n    us_holidays = holidays.US()  # this is a dict\n    # the below is the same, but takes a string:\n    us_holidays = holidays.country_holidays('US')  # this is a dict\n\n    nyse_holidays = holidays.NYSE()  # this is a dict\n    # the below is the same, but takes a string:\n    nyse_holidays = holidays.financial_holidays('NYSE')  # this is a dict\n\n    date(2015, 1, 1) in us_holidays  # True\n    date(2015, 1, 2) in us_holidays  # False\n    us_holidays.get('2014-01-01')  # \"New Year's Day\"\n\nThe HolidayBase dict-like class will also recognize date strings and Unix\ntimestamps:\n\n.. code-block:: python\n\n    '2014-01-01' in us_holidays  # True\n    '1/1/2014' in us_holidays    # True\n    1388597445 in us_holidays    # True\n\nSome holidays may be only present in parts of a country:\n\n.. code-block:: python\n\n    us_pr_holidays = holidays.country_holidays('US', subdiv='PR')\n    '2018-01-06' in us_holidays     # False\n    '2018-01-06' in us_pr_holidays  # True\n\n.. _python-holidays documentation: https://python-holidays.readthedocs.io/\n\nPlease see the `python-holidays documentation`_ for additional examples and\ndetailed information.\n\n\nAvailable Countries\n-------------------\n\n.. _ISO 3166-1 alpha-2 code: https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes\n.. _ISO 3166-2 code: https://en.wikipedia.org/wiki/ISO_3166-2\n.. _ISO 639-1 code: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes\n.. _ISO 639-2 code: https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes\n\nWe currently support 147 country codes. The standard way to refer to a country\nis by using its `ISO 3166-1 alpha-2 code`_, the same used for domain names, and\nfor a subdivision its `ISO 3166-2 code`_. Some countries have common or foreign\nnames or abbreviations as aliases for their subdivisions. These are defined in\nthe (optional) ``subdivisions_aliases`` attribute.\nSome of the countries support more than one language for holiday names output.\nA default language is defined by ``default_language`` (optional) attribute\nfor each entity and is used as a fallback when neither user specified\nlanguage nor user locale language available. The default language code is\na `ISO 639-1 code`_. A list of all languages supported by country is defined by\n``supported_languages`` (optional) attribute. If there is no designated\n`ISO 639-1 code`_ then `ISO 639-2 code`_ can be used.\n\nMany countries have other categories of holidays in addition to common (national-wide) holidays:\nbank holidays, school holidays, additional (paid or non-paid) holidays, holidays of state or\npublic employees, religious holidays (valid only for these religions followers). A list of all\ncategories supported by country is defined by ``supported_categories`` (optional) attribute.\n\nThe following is a list of supported countries, their subdivisions followed by their\naliases (if any) in brackets, available languages and additional holiday categories.\nAll countries support **PUBLIC** holidays category by default.\nAll other default values are highlighted with bold:\n\n\n.. list-table::\n   :widths: 20 4 46 20 10\n   :header-rows: 1\n   :class: tight-table\n\n   * - Country\n     - Code\n     - Subdivisions\n     - Supported Languages\n     - Supported Categories\n   * - Albania\n     - AL\n     -\n     -\n     -\n   * - Algeria\n     - DZ\n     -\n     - **ar**, en_US, fr\n     -\n   * - American Samoa\n     - AS\n     - Can also be loaded as country US, subdivision AS\n     -\n     - UNOFFICIAL\n   * - Andorra\n     - AD\n     - Parishes: 02, 03, 04, 05, 06, 07, 08\n     -\n     -\n   * - Angola\n     - AO\n     -\n     - en_US, **pt_AO**, uk\n     -\n   * - Argentina\n     - AR\n     -\n     - en_US, **es**, uk\n     -\n   * - Armenia\n     - AM\n     -\n     - en_US, **hy**\n     -\n   * - Aruba\n     - AW\n     -\n     - en_US, nl, **pap**, uk\n     -\n   * - Australia\n     - AU\n     - 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)\n     -\n     - BANK, HALF_DAY\n   * - Austria\n     - AT\n     - States: 1 (Burgenland, Bgld, B), 2 (K\u00e4rnten, Ktn, K), 3 (Nieder\u00f6sterreich, N\u00d6, N), 4 (Ober\u00f6sterreich, O\u00d6, O), 5 (Salzburg, Sbg, S), 6 (Steiermark, Stmk, St), 7 (Tirol, T), 8 (Vorarlberg, Vbg, V), 9 (Wien, W)\n     - **de**, en_US, uk\n     - BANK\n   * - Azerbaijan\n     - AZ\n     -\n     - **az**, en_US, uk\n     - WORKDAY\n   * - Bahamas\n     - BS\n     -\n     -\n     -\n   * - Bahrain\n     - BH\n     -\n     - **ar**, en_US\n     -\n   * - Bangladesh\n     - BD\n     -\n     -\n     -\n   * - Barbados\n     - BB\n     -\n     -\n     -\n   * - Belarus\n     - BY\n     -\n     - **be**, en_US\n     -\n   * - Belgium\n     - BE\n     -\n     - de, en_US, fr, **nl**, uk\n     - BANK\n   * - Belize\n     - BZ\n     -\n     -\n     -\n   * - Bolivia\n     - BO\n     - Departments: B, C, H, L, N, O, P, S, T\n     - en_US, **es**, uk\n     -\n   * - Bosnia and Herzegovina\n     - BA\n     - Entities and district: BIH, BRC, SRP\n     - **bs**, en_US, sr, uk\n     -\n   * - Botswana\n     - BW\n     -\n     -\n     -\n   * - Brazil\n     - BR\n     - States: AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE, PI, PR, RJ, RN, RO, RR, RS, SC, SE, SP, TO\n     -\n     - OPTIONAL\n   * - Brunei\n     - BN\n     -\n     - en_US, **ms**, th\n     -\n   * - Bulgaria\n     - BG\n     -\n     - **bg**, en_US, uk\n     - SCHOOL\n   * - Burkina Faso\n     - BF\n     -\n     -\n     -\n   * - Burundi\n     - BI\n     -\n     -\n     -\n   * - Cambodia\n     - KH\n     -\n     - en_US, **km**, th\n     -\n   * - Cameroon\n     - CM\n     -\n     -\n     -\n   * - Canada\n     - CA\n     - Provinces and territories: AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT\n     - ar, **en_CA**, en_US, fr, th\n     - GOVERNMENT, OPTIONAL\n   * - Chad\n     - TD\n     -\n     -\n     -\n   * - Chile\n     - CL\n     - Regions: AI, AN, AP, AR, AT, BI, CO, LI, LL, LR, MA, ML, NB, RM, TA, VS\n     - en_US, **es**, uk\n     -\n   * - China\n     - CN\n     -\n     - en_US, th, **zh_CN**, zh_TW\n     - HALF_DAY\n   * - Colombia\n     - CO\n     -\n     - en_US, **es**, uk\n     -\n   * - Costa Rica\n     - CR\n     -\n     - en_US, **es**, uk\n     - OPTIONAL\n   * - Croatia\n     - HR\n     -\n     - en_US, **hr**, uk\n     -\n   * - Cuba\n     - CU\n     -\n     - en_US, **es**, uk\n     -\n   * - Curacao\n     - CW\n     -\n     - en_US, nl, **pap**, uk\n     -\n   * - Cyprus\n     - CY\n     -\n     - **el**, en_CY, en_US, uk\n     - BANK, OPTIONAL\n   * - Czechia\n     - CZ\n     -\n     - **cs**, en_US, sk, uk\n     -\n   * - Denmark\n     - DK\n     -\n     - **da**, en_US, uk\n     - OPTIONAL\n   * - Djibouti\n     - DJ\n     -\n     - ar, en_US, **fr**\n     -\n   * - Dominican Republic\n     - DO\n     -\n     - en_US, **es**, uk\n     -\n   * - Ecuador\n     - EC\n     -\n     - en_US, **es**, uk\n     -\n   * - Egypt\n     - EG\n     -\n     - **ar**, en_US\n     -\n   * - El Salvador\n     - SV\n     - Departments: AH, CA, CH, CU, LI, MO, PA, SA, SM, SO, SS, SV, UN, US\n     -\n     -\n   * - Estonia\n     - EE\n     -\n     - en_US, **et**, uk\n     -\n   * - Eswatini\n     - SZ\n     -\n     -\n     -\n   * - Ethiopia\n     - ET\n     -\n     - **am**, ar, en_US\n     -\n   * - Finland\n     - FI\n     -\n     - en_US, **fi**, sv, uk\n     -\n   * - France\n     - FR\n     - D\u00e9partements: BL, GES, GP, GY, MF, MQ, NC, PF, RE, WF, YT\n     - en_US, **fr**, uk\n     -\n   * - Gabon\n     - GA\n     -\n     -\n     -\n   * - Georgia\n     - GE\n     -\n     - en_US, **ka**, uk\n     -\n   * - Germany\n     - DE\n     - States: BB, BE, BW, BY, BYP, HB, HE, HH, MV, NI, NW, RP, SH, SL, SN, ST, TH\n     - **de**, en_US, uk\n     -\n   * - Ghana\n     - GH\n     -\n     -\n     -\n   * - Greece\n     - GR\n     -\n     - **el**, en_US, uk\n     - HALF_DAY\n   * - Guam\n     - GU\n     - Can also be loaded as country US, subdivision GU\n     -\n     - UNOFFICIAL\n   * - Guatemala\n     - GT\n     -\n     - en_US, **es**\n     -\n   * - Honduras\n     - HN\n     -\n     - en_US, **es**, uk\n     -\n   * - Hong Kong\n     - HK\n     -\n     -\n     -\n   * - Hungary\n     - HU\n     -\n     - en_US, **hu**, uk\n     -\n   * - Iceland\n     - IS\n     -\n     - en_US, **is**, uk\n     -\n   * - India\n     - IN\n     - States: AN, AP, AR, AS, BR, CG, CH, DD, DH, DL, GA, GJ, HP, HR, JH, JK, KA, KL, LA, LD, MH, ML, MN, MP, MZ, NL, OR, PB, PY, RJ, SK, TN, TR, TS, UK, UP, WB\n     -\n     -\n   * - Indonesia\n     - ID\n     -\n     - en_US, **id**, uk\n     - GOVERNMENT\n   * - Iran\n     - IR\n     -\n     - en_US, **fa**\n     -\n   * - Ireland\n     - IE\n     -\n     -\n     -\n   * - Isle of Man\n     - IM\n     -\n     -\n     -\n   * - Israel\n     - IL\n     -\n     - en_US, **he**, uk\n     - OPTIONAL, SCHOOL\n   * - Italy\n     - IT\n     - Provinces: AG, AL, AN, AO, AP, AQ, AR, AT, AV, BA, BG, BI, BL, BN, BO, BR, BS, BT, BZ, CA, CB, CE, CH, CL, CN, CO, CR, CS, CT, CZ, EN, FC, FE, FG, FI, FM, FR, GE, GO, GR, IM, IS, KR, LC, LE, LI, LO, LT, LU, MB, MC, ME, MI, MN, MO, MS, MT, NA, NO, NU, OR, PA, PC, PD, PE, PG, PI, PN, PO, PR, PT, PU, PV, PZ, RA, RC, RE, RG, RI, RM, RN, RO, SA, SI, SO, SP, SR, SS, SU, SV, TA, TE, TN, TO, TP, TR, TS, TV, UD, VA, VB, VC, VE, VI, VR, VT, VV. Cities: Andria, Barletta, Cesena, Forli, Pesaro, Trani, Urbino\n     -\n     -\n   * - Jamaica\n     - JM\n     -\n     -\n     -\n   * - Japan\n     - JP\n     -\n     - en_US, **ja**, th\n     - BANK\n   * - Jersey\n     - JE\n     -\n     -\n     -\n   * - Jordan\n     - JO\n     -\n     - **ar**, en_US\n     -\n   * - Kazakhstan\n     - KZ\n     -\n     -\n     -\n   * - Kenya\n     - KE\n     -\n     -\n     -\n   * - Kuwait\n     - KW\n     -\n     - **ar**, en_US\n     -\n   * - Kyrgyzstan\n     - KG\n     -\n     -\n     -\n   * - Laos\n     - LA\n     -\n     - en_US, **lo**, th\n     - BANK, SCHOOL, WORKDAY\n   * - Latvia\n     - LV\n     -\n     - en_US, **lv**, uk\n     -\n   * - Lesotho\n     - LS\n     -\n     -\n     -\n   * - Liechtenstein\n     - LI\n     -\n     - **de**, en_US, uk\n     - BANK\n   * - Lithuania\n     - LT\n     -\n     - en_US, **lt**, uk\n     -\n   * - Luxembourg\n     - LU\n     -\n     - de, en_US, fr, **lb**, uk\n     -\n   * - Madagascar\n     - MG\n     -\n     - en_US, **mg**, uk\n     -\n   * - Malawi\n     - MW\n     -\n     -\n     -\n   * - Malaysia\n     - MY\n     - States: JHR, KDH, KTN, KUL, LBN, MLK, NSN, PHG, PJY, PLS, PNG, PRK, SBH, SGR, SWK, TRG\n     -\n     -\n   * - Maldives\n     - MV\n     -\n     -\n     -\n   * - Malta\n     - MT\n     -\n     - en_US, **mt**\n     -\n   * - Marshall Islands (the)\n     - MH\n     -\n     -\n     -\n   * - Mexico\n     - MX\n     -\n     - en_US, **es**, uk\n     -\n   * - Moldova\n     - MD\n     -\n     - en_US, **ro**, uk\n     -\n   * - Monaco\n     - MC\n     -\n     - en_US, **fr**, uk\n     -\n   * - Montenegro\n     - ME\n     -\n     -\n     -\n   * - Morocco\n     - MA\n     -\n     - **ar**, en_US, fr\n     -\n   * - Mozambique\n     - MZ\n     -\n     - en_US, **pt_MZ**, uk\n     -\n   * - Namibia\n     - NA\n     -\n     -\n     -\n   * - Netherlands\n     - NL\n     -\n     - en_US, **nl**, uk\n     - OPTIONAL\n   * - New Zealand\n     - NZ\n     - Regions: AUK, BOP, CAN, CIT, GIS, HKB, MBH, MWT, NSN, NTL, OTA, STL, TAS, TKI, WGN, WKO, WTC\n     -\n     -\n   * - Nicaragua\n     - NI\n     - Departments: AN, AS, BO, CA, CI, CO, ES, GR, JI, LE, MD, **MN**, MS, MT, NS, RI, SJ\n     - en_US, **es**, uk\n     -\n   * - Nigeria\n     - NG\n     -\n     -\n     -\n   * - Northern Mariana Islands (the)\n     - MP\n     - Can also be loaded as country US, subdivision MP\n     -\n     - UNOFFICIAL\n   * - North Macedonia\n     - MK\n     -\n     -\n     -\n   * - Norway\n     - NO\n     -\n     - en_US, **no**, uk\n     -\n   * - Pakistan\n     - PK\n     -\n     -\n     -\n   * - Palau\n     - PW\n     -\n     -\n     - ARMED_FORCES, HALF_DAY\n   * - Panama\n     - PA\n     -\n     -\n     -\n   * - Papua New Guinea\n     - PG\n     -\n     -\n     -\n   * - Paraguay\n     - PY\n     -\n     - en_US, **es**, uk\n     - GOVERNMENT\n   * - Peru\n     - PE\n     -\n     - en_US, **es**, uk\n     -\n   * - Philippines\n     - PH\n     -\n     -\n     -\n   * - Poland\n     - PL\n     -\n     - en_US, **pl**, uk\n     -\n   * - Portugal\n     - PT\n     - Districts: 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15, 16, 17, 18, 20, 30\n     - en_US, **pt_PT**, uk\n     - OPTIONAL\n   * - Puerto Rico\n     - PR\n     - Can also be loaded as country US, subdivision PR\n     -\n     - UNOFFICIAL\n   * - Romania\n     - RO\n     -\n     - en_US, **ro**, uk\n     -\n   * - Russia\n     - RU\n     -\n     - en_US, **ru**\n     -\n   * - San Marino\n     - SM\n     -\n     -\n     -\n   * - Saudi Arabia\n     - SA\n     -\n     - **ar**, en_US\n     -\n   * - Serbia\n     - RS\n     -\n     - en_US, **sr**\n     -\n   * - Seychelles\n     - SC\n     -\n     - **en_SC**, en_US\n     -\n   * - Singapore\n     - SG\n     -\n     -\n     -\n   * - Slovakia\n     - SK\n     -\n     - en_US, **sk**, uk\n     - WORKDAY\n   * - Slovenia\n     - SI\n     -\n     - en_US, **sl**, uk\n     -\n   * - South Africa\n     - ZA\n     -\n     -\n     -\n   * - South Korea\n     - KR\n     -\n     - en_US, **ko**, th\n     - BANK\n   * - Spain\n     - ES\n     - Autonomous communities: AN, AR, AS, CB, CE, CL, CM, CN, CT, EX, GA, IB, MC, MD, ML, NC, PV, RI, VC\n     - en_US, **es**, uk\n     -\n   * - Sweden\n     - SE\n     -\n     - en_US, **sv**, uk\n     -\n   * - Switzerland\n     - CH\n     - Cantons: AG, AI, AR, BL, BS, BE, FR, GE, GL, GR, JU, LU, NE, NW, OW, SG, SH, SZ, SO, TG, TI, UR, VD, VS, ZG, ZH\n     - **de**, en_US, fr, it, uk\n     - HALF_DAY, OPTIONAL\n   * - Taiwan\n     - TW\n     -\n     - en_US, th, zh_CN, **zh_TW**\n     -\n   * - Tanzania\n     - TZ\n     -\n     - en_US, **sw**\n     - BANK\n   * - Thailand\n     - TH\n     -\n     - en_US, **th**\n     - ARMED_FORCES, BANK, GOVERNMENT, SCHOOL, WORKDAY\n   * - Timor Leste\n     - TL\n     -\n     - en_US, **pt_TL**, tet\n     - GOVERNMENT, WORKDAY\n   * - Tonga\n     - TO\n     -\n     - en_US, **to**\n     -\n   * - Tunisia\n     - TN\n     -\n     - **ar**, en_US\n     -\n   * - Turkey\n     - TR\n     -\n     - en_US, **tr**, uk\n     - HALF_DAY\n   * - Ukraine\n     - UA\n     -\n     - ar, en_US, **uk**\n     -\n   * - United Arab Emirates\n     - AE\n     -\n     - **ar**, en_US\n     -\n   * - United Kingdom\n     - GB\n     - Subdivisions: ENG, NIR, SCT, WLS\n     -\n     -\n   * - United States Minor Outlying Islands\n     - UM\n     - Can also be loaded as country US, subdivision UM\n     -\n     - UNOFFICIAL\n   * - United States of America (the)\n     - US\n     - States and territories: AK, AL, AR, AS, AZ, CA, CO, CT, DC, DE, FL, GA, GU, HI, IA, ID, IL, IN, KS, KY, LA, MA, MD, ME, MI, MN, MO, MP, MS, MT, NC, ND, NE, NH, NJ, NM, NV, NY, OH, OK, OR, PA, PR, RI, SC, SD, TN, TX, UM, UT, VA, VI, VT, WA, WI, WV, WY\n     -\n     - UNOFFICIAL\n   * - United States Virgin Islands (the)\n     -\n     - See Virgin Islands (U.S.)\n     -\n     - UNOFFICIAL\n   * - Uruguay\n     - UY\n     -\n     - en_US, **es**, uk\n     - BANK\n   * - Uzbekistan\n     - UZ\n     -\n     - en_US, uk, **uz**\n     -\n   * - Vanuatu\n     - VU\n     -\n     -\n     -\n   * - Vatican City\n     - VA\n     -\n     -\n     -\n   * - Venezuela\n     - VE\n     -\n     - en_US, **es**, uk\n     -\n   * - Vietnam\n     - VN\n     -\n     -\n     -\n   * - Virgin Islands (U.S.)\n     - VI\n     - Can also be loaded as country US, subdivision VI\n     -\n     - UNOFFICIAL\n   * - Zambia\n     - ZM\n     -\n     -\n     -\n   * - Zimbabwe\n     - ZW\n     -\n     -\n     -\n\n\nAvailable Financial Markets\n===========================\n\n.. _ISO 10383 MIC: https://www.iso20022.org/market-identifier-codes\n\nThe standard way to refer to a financial market is to use its `ISO 10383 MIC`_\n(Market Identifier Code) as a \"country\" code when available. The\nfollowing financial markets are available:\n\n.. list-table::\n   :widths: 23 4 83\n   :header-rows: 1\n   :class: tight-table\n\n   * - Entity\n     - Code\n     - Info\n   * - European Central Bank\n     - ECB\n     - Trans-European Automated Real-time Gross Settlement (TARGET2)\n   * - New York Stock Exchange\n     - XNYS\n     - NYSE market holidays (used by all other US-exchanges, including NASDAQ, etc.)\n\n\nContributions\n-------------\n\n.. _Issues: https://github.com/vacanza/python-holidays/issues\n.. _pull requests: https://github.com/vacanza/python-holidays/pulls\n.. _here: https://github.com/vacanza/python-holidays/blob/dev/CONTRIBUTING.rst\n\nIssues_ and `pull requests`_ are always welcome.  Please see\n`here`_ for more information.\n\nLicense\n-------\n\n.. __: https://github.com/vacanza/python-holidays/blob/dev/LICENSE\n\nCode and documentation are available according to the MIT License\n(see LICENSE__).\n",
    "bugtrack_url": null,
    "license": "Copyright (c) Vacanza Team and individual contributors (see AUTHORS file) Copyright (c) dr-prodigy <dr.prodigy.github@gmail.com>, 2017-2023 Copyright (c) ryanss <ryanssdev@icloud.com>, 2014-2017  All rights reserved.  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
    "summary": "Generate and work with holidays in Python",
    "version": "0.48",
    "project_urls": {
        "Changelog": "https://github.com/vacanza/python-holidays/releases",
        "Documentation": "https://python-holidays.readthedocs.io/en/latest/",
        "Downloads": "https://pypi.org/project/holidays/",
        "Repository": "https://github.com/vacanza/python-holidays/"
    },
    "split_keywords": [
        "holidays",
        " calendar",
        " l10n"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "329f605a37e5eaff172742068ae660397fcccaa7e1673a5186d1a0ae6f6e990e",
                "md5": "6489ec65305c0e3500e26e690913019d",
                "sha256": "2ab0fb4a85c12f2ba157e26b190bbc28d0357c4da1959f9d74fc5add66e11b43"
            },
            "downloads": -1,
            "filename": "holidays-0.48-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "6489ec65305c0e3500e26e690913019d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 1020369,
            "upload_time": "2024-05-06T16:47:35",
            "upload_time_iso_8601": "2024-05-06T16:47:35.057331Z",
            "url": "https://files.pythonhosted.org/packages/32/9f/605a37e5eaff172742068ae660397fcccaa7e1673a5186d1a0ae6f6e990e/holidays-0.48-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b6534810684c6520ae0e9b2901098557aa6c804aaedf98a680e97a1c5e977080",
                "md5": "e522f04bf44cb39824c3c9c1a88c59b4",
                "sha256": "8801d45e15600990494988b193cd83ef470f59138bd964bbdf5f023f17cc7966"
            },
            "downloads": -1,
            "filename": "holidays-0.48.tar.gz",
            "has_sig": false,
            "md5_digest": "e522f04bf44cb39824c3c9c1a88c59b4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 506358,
            "upload_time": "2024-05-06T16:47:37",
            "upload_time_iso_8601": "2024-05-06T16:47:37.150918Z",
            "url": "https://files.pythonhosted.org/packages/b6/53/4810684c6520ae0e9b2901098557aa6c804aaedf98a680e97a1c5e977080/holidays-0.48.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-06 16:47:37",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "vacanza",
    "github_project": "python-holidays",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "tox": true,
    "lcname": "holidays"
}
        
Elapsed time: 0.24417s