Holidata
holidata is a utility for algorithmically producing holiday data.
It is used e.g. by Taskwarrior and Timewarrior, as well as for holidata.net.
Holiday data can be produced for a given year in a supported locale and output format.
Installation
holidata is published on PyPI and can be installed as a command-line tool with:
uv tool install holidata
Alternatively, run it once without installing via uvx:
uvx holidata --year=<value> --locale=<value> [--output=<value>]
uvx holidata --year=<value> --country=<value> [--lang=<value>] [--output=<value>]
For development setup, see CONTRIBUTING.md.
Call holidata --help for more detailed information.
Examples
-
Create holiday data of year
2026for localede-DE:$ holidata --year=2026 --locale=de-DE -
Create holiday data of year
2026for countryBEand languagefr:$ holidata --year=2026 --country=BE --lang=fr -
Create holiday data of year
2026for countryUS(default languageen):$ holidata --year=2026 --country=US
Data
For each holiday the following data is provided:
locale- language and country the holiday is defined forregion- region code of the given subdivision the holiday is defined fordate- actual date the holiday takes placedescription- name of the holiday in the given languagetype- holiday type flagsnotes- additional information
Locales
Holidata provides holiday data in different locales, i.e. for a given country and in a given language. See holidata.net for a complete overview of the currently provided locales.
If you think a locale is missing, open a feature request on GitHub.
Output Formats
Holidata supports different output formats, currently csv, jsonline, yaml, and xml.
Limitations
Holidata focuses on holidays which are defined by law on which business or work are suspended or reduced (there may be some exceptions to that rule).
Holidata only provides data for countries and their principal subdivisions (both as they are defined in ISO 3166). Holidays for other subdivisions are either merged or ignored. There is also no explicit representation of partial holidays.
Contributing
Take a look at CONTRIBUTING.md on how you can contribute. ❤️
License
holidata is released under the MIT license.
For details check the LICENSE file.
1 maintainer
Release files for holidata 2026.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| holidata-2026.9.0.tar.gz | 44.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| holidata-2026.9.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 122.4 kB
Release files / holidata-2026.9.0.tar.gz
| Download URL | holidata-2026.9.0.tar.gz |
|---|---|
| Size | 44.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
48541e79d3dd07d8f617b325a45b422bd2d26ff2554fa905e6cf3953cf16f834
|
|
BLAKE2b-256 checksum How to use checksums |
c8f4ccd93607121ff1d890ccd15245ab419aac1dded472d0cbca8ba27b47f236
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / holidata-2026.9.0-py3-none-any.whl
| Download URL | holidata-2026.9.0-py3-none-any.whl |
|---|---|
| Size | 77.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fe9ea6ac640352263ce5ab794124be8dd12a0c5bbc5f621a5fe419f09872e38b
|
|
BLAKE2b-256 checksum How to use checksums |
7b0456befed2405fae694adc3485907b7027bc845c3eb1005b05dad6e8da3546
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
