Holidata

holidata is a utility for algorithmically producing holiday data. Its purpose is mainly for holidata.net.

Holiday data can be produced for a given year in a supported locale and output format.

Usage

holidata --year=<value> --locale=<value> [--output=<value>]
holidata --year=<value> --country=<value> [--lang=<value>] [--output=<value>]

Call holidata with the --help option to more detailed information.

Examples

Create holiday data of year 2022 for locale de-DE:
```
$ holidata --year=2022 --locale=de-DE
```
Create holiday data of year 2022 for country BE and language fr:
```
$ holidata --year=2022 --country=BE --lang=fr
```
Create holiday data of year 2022 for country US (default language en):
```
$ holidata --year=2022 --country=US
```

Data

For each holiday the following data is provided:

locale - language and country the holiday is defined for
region - region code of the given subdivision the holiday is defined for
date - actual date the holiday takes place
description - name of the holiday in the given language
type - holiday type flags
notes - 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, json, yaml, and xml.

If you think an output format is missing, open a feature request on GitHub.

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.

License

holidata is released under the MIT license. For details check the LICENSE file.

Release files for holidata 2023.11.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for holidata 2023.11.1
File	Size	Uploaded
holidata-2023.11.1.tar.gz	31.9 kB	Nov 22, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for holidata 2023.11.1
File	Interpreter	ABI	Platform	Reset
holidata-2023.11.1-py3-none-any.whl 52.4 kB Nov 22, 2023	Python 3	none	any	Details

Total release size: 84.3 kB

Release files / holidata-2023.11.1.tar.gz

Download URL	holidata-2023.11.1.tar.gz
Size	31.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`18d05c27f51a03ff5dd1fc2a6504c7de73d0e5dde37df664e426118734d7d831`
BLAKE2b-256 checksum How to use checksums	`51224f8b32added12347f83ef2c62fdf1381288e23b0cebf9b68f623da5ce946`
Upload date	Nov 22, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.10.8`

Release files / holidata-2023.11.1-py3-none-any.whl

Download URL	holidata-2023.11.1-py3-none-any.whl
Size	52.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3a27b4a983f080a7a2ad3c17aad00d1507e480a4ac5bae5341603cdcac117a80`
BLAKE2b-256 checksum How to use checksums	`c34352f73bdaa4455c426f0c2793a1427df4aca0cbf023a8de0b3e68cec1fab1`
Upload date	Nov 22, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.10.8`