timewarrior/doc/holidays
Thomas Lauf 65ef38658b Increase minimal CMake version
Compatibility with CMake < 2.8.12 will be removed from a future version of CMake.
According to our test images all supported distributions have CMake > 3

Signed-off-by: Thomas Lauf <thomas.lauf@tngtech.com>
2021-02-12 10:50:39 +01:00
..
CMakeLists.txt Increase minimal CMake version 2021-02-12 10:50:39 +01:00
holidays.en-US Merge same holidays from different regions 2019-12-28 15:12:33 +01:00
README Update README 2019-12-28 15:12:33 +01:00
refresh doc: Update copyright to 2021 2021-01-02 02:52:39 -05:00

# Timewarrior Holiday Files

The holiday files were created by the `refresh` script using data from https://holidata.net.
The holiday files can be updated using the command:

    $ ./refresh

This updates all present holiday files with holiday data for the current and the following year (default).

If you need another locale (for example `sv-SE`), do this:

    $ ./refresh --locale sv-SE

This creates a file `holidays.sv-SE` containing holiday data for the current and following year.
The id for the locale is composed from the [ISO 639-1 language code](https://en.wikipedia.org/wiki/ISO_639-1) and the [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

If you need a specific locale region, do this:

    $ ./refresh --locale de-CH --region BE

For regions use the corresponding [ISO 3166-2 code for principal subdivisions](https://en.wikipedia.org/wiki/ISO_3166-2).

To specify a set of years to update, do this:

    $ ./refresh --locale en-US --year 2018 2019 2020

If the locale is not yet supported by holidata.net, or there is no data available for the requested year, you will see an error.