Skip to main content

Python package with Czech public holidays

Project description

Python package with Czech public holidays.


From PyPI:

pip install czech-holidays

In case you have an adventurous mind, give a try to the source:

pip install git+


Czech Holidays provides the following interface:

>>> from czech_holidays import czech_holidays
>>> holidays = czech_holidays(2022)
>>> holidays[:3]
[Holiday(, 1, 1), name='Nový rok', name_en="New Year's Day"),
 Holiday(, 1, 1), name='Den obnovy samostatného českého státu', name_en='Restoration Day of the Independent Czech State'),
 Holiday(, 4, 18), name='Velikonoční pondělí', name_en='Easter Monday')]

The function accepts year as a single argument and returns a list of named tuples:

>>> holidays[0].date, 1, 1)
>>> holidays[0].name
'Nový rok'
>>> holidays[0].name_en
"New Year's Day"

Albeit named, it’s still just a tuple:

>>> holidays[0][0], 1, 1)
>>> holidays[0][1]
'Nový rok'
>>> holidays[0][2]
"New Year's Day"
>>> tuple(holidays[0])
(, 1, 1), 'Nový rok', "New Year's Day")
>>> holidays[0] < holidays[5]

Two shortcuts are available:

>>> from czech_holidays import czech_easter, czech_christmas
>>> czech_easter(2022)
Holiday(, 4, 18), name='Velikonoční pondělí', name_en='Easter Monday')
>>> czech_christmas(2022)
Holiday(, 12, 24), name='Štědrý den', name_en='Christmas Eve')

The aim of this library is to simplify work with Czech public holidays in current applications, thus it does not provide any historical data:

>>> czech_holidays(2013)
Traceback (most recent call last):
NotImplementedError: ...


Install using poetry:

git clone
cd czech-holidays
poetry install

Then run tests:


License: MIT

© 2022 Honza Javorek <>

This work is licensed under MIT license.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

czech-holidays-1.0.0.tar.gz (3.9 kB view hashes)

Uploaded source

Built Distribution

czech_holidays-1.0.0-py3-none-any.whl (3.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page