revised_holidays 9.0.0

data/definitions/de.yaml

@@ -0,0 +1,401 @@
+# German holiday definitions for the Ruby Holiday gem.
+#
+# Updated: 2019-02-10
+#
+# Changes 2016-11-27:
+# - Change de_sn_aux, de_th_aux to de_sn_sorbian (because it only is celebrated in Sorbian regions in Sachsen) and de_th_eichsfeld, to reflect region of Eichsfeld
+# - Change de_sn_aux to de_by_augsburg to reflect only City of Augsburg
+#
+# Changes 2017-06-08:
+# - Add Berlin, Bremen, Hamburg, Niedersachsen, Schleswig-Holstein
+# - Change de_th_eichsfeld to de_th_cath because it affects the catholic communities Eichsfeld, Unstrut-Hainich-Kreis and Wartburgkreis
+# - Merge Fronleichnam entry
+# - Add de_by_cath for catholic communities in Bavaria; Maria Himmelfahrt is not a Bavaria-wide holiday
+# - Mariä Himmelfahrt is celebrated in the community of Augsburg (de_by_augsburg)
+# - Enhance tests
+#
+# Changes 2017-09-25:
+# - Correct definition for Reformation Day
+#
+# Changes 2018-09-10:
+#  - Reformation Day has been added as a new holiday in Bremen, Hamburg, Lower Saxony and Schleswig-Holstein, starting in 2018.
+#
+# Change 2019-02-10:
+#  - Changing usage of 'year_ranges.after' to 'year_ranges.from', see https://github.com/holidays/definitions/issues/117
+#
+# Change 2023-04-17:
+#  - Historical data for Tag der Deutschen Einheit
+#
+# Sources:
+# - http://en.wikipedia.org/wiki/Holidays_in_Germany
+# - http://www.timeanddate.com/calendar/index.html?country=8
+# - http://www.germany.info/relaunch/welcome/travel/holidays.html
+# - https://www.statistik.bayern.de/statistik/bevoelkerungsstand/00141.php
+# - http://www.thueringen.de/mam/th3/tim/verwaltungsrecht/fronleichnam_gemeindeschluesselzahlen.pdf
+---
+months:
+  0:
+  - name: Karfreitag
+    regions: [de]
+    function: easter(year)
+    function_modifier: -2
+  - name: Ostersonntag
+    regions: [de]
+    function: easter(year)
+    type: informal
+  - name: Ostermontag
+    regions: [de]
+    function: easter(year)
+    function_modifier: 1
+  - name: Christi Himmelfahrt
+    regions: [de]
+    function: easter(year)
+    function_modifier: 39
+  - name: Pfingstsonntag
+    regions: [de]
+    function: easter(year)
+    function_modifier: 49
+    type: informal
+  - name: Pfingstmontag
+    regions: [de]
+    function: easter(year)
+    function_modifier: 50
+  - name: Fronleichnam
+    regions: [de_bw, de_by, de_he, de_nw, de_rp, de_sl, de_sn_sorbian, de_th_cath]
+    function: easter(year)
+    function_modifier: 60
+  - name: Weiberfastnacht
+    regions: [de_bw, de_by, de_he, de_nw, de_rp, de_sl, de_sn]
+    function: easter(year)
+    function_modifier: -52
+    type: informal
+  - name: Rosenmontag
+    regions: [de_bw, de_by, de_he, de_nw, de_rp, de_sl, de_sn]
+    function: easter(year)
+    function_modifier: -48
+    type: informal
+  - name: Aschermittwoch
+    regions: [de_bw, de_by, de_he, de_nw, de_rp, de_sl, de_sn]
+    function: easter(year)
+    function_modifier: -46
+    type: informal
+  1:
+  - name: Neujahrstag
+    regions: [de]
+    mday: 1
+  - name: Heilige Drei Könige
+    regions: [de_bw, de_by, de_st]
+    mday: 6
+  3:
+  - name: Internationaler Frauentag
+    regions: [de_be]
+    mday: 8
+    year_ranges:
+      from: 2019
+  - name: Internationaler Frauentag
+    regions: [de_mv]
+    mday: 8
+    year_ranges:
+      from: 2023
+  5:
+  - name: Tag der Arbeit
+    regions: [de]
+    mday: 1
+  - name: Tag der Befreiung
+    regions: [de_be]
+    mday: 8
+    year_ranges:
+      limited: [2020]
+  6:
+  - name: Tag der Deutschen Einheit
+    regions: [de]
+    mday: 17
+    year_ranges:
+      between:
+        start: 1954
+        end: 1990
+  8:
+  - name: Mariä Himmelfahrt
+    regions: [de_by_cath, de_by_augsburg, de_sl]
+    mday: 15
+  - name: Friedensfest
+    regions: [de_by_augsburg]
+    mday: 8
+  9:
+  - name: Weltkindertag
+    regions: [de_th]
+    mday: 20
+    year_ranges:
+      from: 2019
+  10:
+  - name: Tag der Deutschen Einheit
+    regions: [de]
+    mday: 3
+    year_ranges:
+      from: 1990
+  - name: Reformationstag
+    regions: [de_bb, de_mv, de_sn, de_st, de_th]
+    mday: 31
+  - name: Reformationstag
+    regions: [de_bw]
+    mday: 31
+    type: informal
+  - name: Reformationstag
+    regions: [de]
+    mday: 31
+    year_ranges:
+      limited: [2017]
+  - name: Reformationstag
+    regions: [de_hb, de_hh, de_ni, de_sh]
+    mday: 31
+    year_ranges:
+      from: 2018
+  11:
+  - name: Allerheiligen
+    regions: [de_bw, de_by, de_nw, de_rp, de_sl]
+    mday: 1
+  - name: Buß- und Bettag
+    regions: [de_sn]
+    function: de_buss_und_bettag(year)
+  12:
+  - name: Heilig Abend
+    regions: [de]
+    mday: 24
+    type: informal
+  - name: 1. Weihnachtstag
+    regions: [de]
+    mday: 25
+  - name: 2. Weihnachtstag
+    regions: [de]
+    mday: 26
+  - name: Silvester
+    regions: [de]
+    mday: 31
+    type: informal
+
+methods:
+  de_buss_und_bettag:
+    # Germany: Wednesday before November 23
+    arguments: year
+    ruby: |
+      date = Date.civil(year,11,23)
+      if date.wday > 3
+        date -= (date.wday - 3)
+      else
+        date -= (date.wday + 4)
+      end
+      date
+
+tests:
+  - given:
+      date: '2009-01-01'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "Neujahrstag"
+  - given:
+      date: '2009-04-10'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "Karfreitag"
+  - given:
+      date: '2009-04-12'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "Ostersonntag"
+  - given:
+      date: '2009-04-13'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "Ostermontag"
+  - given:
+      date: '2009-05-01'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "Tag der Arbeit"
+  - given:
+      date: '2009-05-21'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "Christi Himmelfahrt"
+  - given:
+      date: '2009-05-31'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "Pfingstsonntag"
+  - given:
+      date: '2009-06-01'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "Pfingstmontag"
+  - given:
+      date: '2009-10-03'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "Tag der Deutschen Einheit"
+  - given:
+      date: '2009-12-24'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "Heilig Abend"
+  - given:
+      date: '2009-12-25'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "1. Weihnachtstag"
+  - given:
+      date: '2009-12-26'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "2. Weihnachtstag"
+  - given:
+      date: '2009-12-31'
+      regions: ["de"]
+      options: ["informal"]
+    expect:
+      name: "Silvester"
+  - given:
+      date: '2009-01-06'
+      regions: ["de_bw", "de_by", "de_st", "de_"]
+    expect:
+      name: "Heilige Drei Könige"
+  - given:
+      date: '2009-06-11'
+      regions: ["de_bw", "de_by", "de_he", "de_nw", "de_rp", "de_sl", "de_sn_sorbian", "de_th_cath"]
+    expect:
+      name: "Fronleichnam"
+  - given:
+      date: '2009-08-15'
+      regions: ["de_by", "de_sl", "de_"]
+    expect:
+      name: "Mariä Himmelfahrt"
+  - given:
+      date: '2009-10-31'
+      regions: ["de_bb", "de_mv", "de_sn", "de_st", "de_th", "de_"]
+    expect:
+      name: "Reformationstag"
+  - given:
+      date: '2009-10-31'
+      regions: ["de_bw"]
+      options: ["informal"]
+    expect:
+      name: "Reformationstag"
+  - given:
+      date: '2017-10-31'
+      regions: ["de"]
+    expect:
+      name: "Reformationstag"
+  - given:
+      date: '2016-10-31'
+      regions: ["de"]
+    expect:
+      holiday: false
+  - given:
+      date: '2018-10-31'
+      regions: ["de"]
+    expect:
+      holiday: false
+  - given:
+      date: '2018-10-31'
+      regions: ["de_bb", "de_hb", "de_hh", "de_mv", "de_ni", "de_sh", "de_sn", "de_st", "de_th"]
+    expect:
+      name: "Reformationstag"
+  - given:
+      date: '2009-11-01'
+      regions: ["de_bw", "de_by", "de_nw", "de_rp", "de_sl", "de_"]
+    expect:
+      name: "Allerheiligen"
+  - given:
+      date: '2015-08-08'
+      regions: ["de_by_augsburg"]
+    expect:
+      name: "Friedensfest"
+  - given:
+      date: '2015-08-08'
+      regions: ["de", "de_bw", "de_by", "de_bb", "de_he", "de_mv", "de_nw", "de_rp", "de_sl", "de_sn", "de_st", "de_th"]
+    expect:
+      holiday: false
+  - given:
+      date: '2010-05-08'
+      regions: ["de"]
+    expect:
+      holiday: false
+  - given:
+      date: '2010-08-08'
+      regions: ["de"]
+    expect:
+      holiday: false
+  - given:
+      date: '2004-11-17'
+      regions: ["de_sn"]
+    expect:
+      name: "Buß- und Bettag"
+  - given:
+      date: '2005-11-16'
+      regions: ["de_sn"]
+    expect:
+      name: "Buß- und Bettag"
+  - given:
+      date: '2006-11-22'
+      regions: ["de_sn"]
+    expect:
+      name: "Buß- und Bettag"
+  - given:
+      date: '2009-11-18'
+      regions: ["de_sn"]
+    expect:
+      name: "Buß- und Bettag"
+  - given:
+      date: '2016-02-04'
+      regions: ["de_bw", "de_by", "de_he", "de_nw", "de_rp", "de_sl", "de_sn"]
+      options: ["informal"]
+    expect:
+      name: "Weiberfastnacht"
+  - given:
+      date: '2016-02-08'
+      regions: ["de_bw", "de_by", "de_he", "de_nw", "de_rp", "de_sl", "de_sn"]
+      options: ["informal"]
+    expect:
+      name: "Rosenmontag"
+  - given:
+      date: '2016-02-10'
+      regions: ["de_bw", "de_by", "de_he", "de_nw", "de_rp", "de_sl", "de_sn"]
+      options: ["informal"]
+    expect:
+      name: "Aschermittwoch"
+  - given:
+      date: '2018-03-08'
+      regions: ["de_be"]
+    expect:
+      holiday: false
+  - given:
+      date: '2019-03-08'
+      regions: ["de_be"]
+    expect:
+      name: "Internationaler Frauentag"
+  - given:
+      date: '2023-03-08'
+      regions: ["de_mv"]
+    expect:
+      name: "Internationaler Frauentag"
+  - given:
+      date: '2020-05-08'
+      regions: ["de_be"]
+    expect:
+      name: "Tag der Befreiung"
+  - given:
+      date: "2024-09-20"
+      regions: ["de_th"]
+    expect:
+      name: "Weltkindertag"

data/definitions/dk.yaml

@@ -0,0 +1,220 @@
+# Danish holiday definitions for the Ruby Holiday gem.
+#
+# Updated: 2008-11-22.
+# Sources:
+# - http://en.wikipedia.org/wiki/Holidays_in_Denmark
+# - http://www.amblondon.um.dk/en/menu/AboutDenmark/PublicHolidaysInDK/PublicHolidaysinDenmark-until2010.htm
+# - http://borger.dk/forside/kirke-og-tro/folkekirken/officielle-helligdage
+---
+months:
+  0:
+  - name: Fastelavn
+    regions: [dk]
+    function: easter(year)
+    function_modifier: -49
+    type: informal
+  - name: Palmesøndag
+    regions: [dk]
+    function: easter(year)
+    function_modifier: -7
+    type: informal
+  - name: Skærtorsdag
+    regions: [dk]
+    function: easter(year)
+    function_modifier: -3
+  - name: Langfredag
+    regions: [dk]
+    function: easter(year)
+    function_modifier: -2
+  - name: Påskedag
+    regions: [dk]
+    function: easter(year)
+  - name: 2. påskedag
+    regions: [dk]
+    function: easter(year)
+    function_modifier: 1
+  - name: Store Bededag
+    regions: [dk]
+    function: easter(year)
+    function_modifier: 26
+    year_ranges:
+      until: 2023
+  - name: Kristi Himmelfartsdag
+    regions: [dk]
+    function: easter(year)
+    function_modifier: 39
+  - name: Pinsedag
+    regions: [dk]
+    function: easter(year)
+    function_modifier: 49
+  - name: 2. Pinsedag
+    regions: [dk]
+    function: easter(year)
+    function_modifier: 50
+  1:
+  - name: Nytårsdag
+    regions: [dk]
+    mday: 1
+  4:
+  - name: 1. april
+    regions: [dk]
+    mday: 1
+    type: informal
+  - name: Danmarks besættelse
+    regions: [dk]
+    mday: 9
+    type: informal
+  - name: Dronningens fødselsdag
+    regions: [dk]
+    mday: 16
+    type: informal
+  5:
+  - name: Arbejdernes kampdag
+    regions: [dk]
+    mday: 1
+    type: informal
+  - name: Danmarks befrielse
+    regions: [dk]
+    mday: 5
+    type: informal
+  6:
+  - name: Grundlovsdag
+    regions: [dk]
+    mday: 5
+    type: informal
+  - name: Valdemarsdag og Genforeningsdag
+    regions: [dk]
+    mday: 15
+    type: informal
+  - name: Sankt Hans aften
+    regions: [dk]
+    mday: 23
+    type: informal
+  11:
+  - name: Mortensaften
+    regions: [dk]
+    mday: 10
+    type: informal
+  12:
+  - name: Sankt Lucia
+    regions: [dk]
+    mday: 13
+    type: informal
+  - name: Juleaftensdag
+    regions: [dk]
+    mday: 24
+    type: informal
+  - name: 1. juledag
+    regions: [dk]
+    mday: 25
+  - name: 2. juledag
+    regions: [dk]
+    mday: 26
+
+tests:
+  - given:
+      date: '2023-05-05'
+      regions: ["dk"]
+    expect:
+      name: "Store Bededag"
+  - given:
+      date: '2024-04-26'
+      regions: ["dk"]
+    expect:
+      holiday: false
+  - given:
+      date: '2007-01-01'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "Nytårsdag"
+  - given:
+      date: '2007-02-18'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "Fastelavn"
+  - given:
+      date: '2007-04-09'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "2. påskedag"
+  - given:
+      date: '2007-04-16'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "Dronningens fødselsdag"
+  - given:
+      date: '2007-04-05'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "Skærtorsdag"
+  - given:
+      date: '2007-04-06'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "Langfredag"
+  - given:
+      date: '2007-04-08'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "Påskedag"
+  - given:
+      date: '2007-05-01'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "Arbejdernes kampdag"
+  - given:
+      date: '2007-05-04'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "Store Bededag"
+  - given:
+      date: '2007-05-17'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "Kristi Himmelfartsdag"
+  - given:
+      date: '2007-05-27'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "Pinsedag"
+  - given:
+      date: '2007-05-28'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "2. Pinsedag"
+  - given:
+      date: '2007-06-05'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "Grundlovsdag"
+  - given:
+      date: '2007-12-24'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "Juleaftensdag"
+  - given:
+      date: '2007-12-25'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "1. juledag"
+  - given:
+      date: '2007-12-26'
+      regions: ["dk"]
+      options: ["informal"]
+    expect:
+      name: "2. juledag"

data/definitions/doc/CONTRIBUTING.md

@@ -0,0 +1,44 @@
+# How to contribute
+
+In this repository we have all of the definitions that are used in holiday calculations. We rely on users around the world to help keep our definitions accurate and up to date.
+
+## Code of Conduct
+
+Please read our [Code of Conduct](https://github.com/holidays/holidays/blob/master/CODE_OF_CONDUCT.md) before contributing. Everyone interacting with this project (or associated projects) is expected to abide by its terms.
+
+## Definition Updates
+
+Our definitions are written in YAML. You can find a complete guide to our format in the [syntax docs](SYNTAX.md). We take the YAML definitions and generate final definition files in the various projects that are loaded at runtime for fast calculations.
+
+Here are the steps to take once you have a good idea on what you want to change:
+
+* Fork this repository
+* Edit desired definition YAML file(s). If you are adding a new region be sure to update `index.yaml` as well
+* Run `make validate` to ensure that all updates match our definition format
+* Ensure that the tests in holidays pass:
+```
+git clone git@github.com:holidays/holidays.git
+cd holidays
+bundle install
+make clean-defs
+BRANCH=<YOUR_BRANCH_NAME> USER=<YOUR_GITHUB_USERNAME> make point-to-defs-branch
+bundle exec rake generate:definitions
+bundle exec rake test # Alternatively: bundle exec rake test_region <your_region>
+```
+* Open a PR with your changes
+
+Including documentation with your updates is very much appreciated. A simple Wikipedia entry or government link in the comments alongside your changes would be perfect.
+
+Lastly, note that there are many 'meta' regions. For example, there are regions for Europe, Scandinavia, and North America. If your new region(s) falls into these areas consider adding them. You can find these 'meta' regions in `definitions/index.yaml`.
+
+Don't worry about versioning, we'll handle it on our end.
+
+*Tests are required for new definitions*.
+
+## Definition Validation
+
+We maintain a `make validate` command to ensure that all YAML definitions match our internal specifications. This is to make working with this repository as independent as possible from the other repositories (like the existing ruby repository). If `make validate` passes then we ensure that anything consuming these files will receive 'correct' formats.
+
+If you run into any weird `make validate` errors please open an issue or PR and highlight to what you are seeing. The validation code is brand-new and might have issues. Maintainers will respond quickly to any open problems.
+
+If you would like to add to, update, or otherwise fix any of our specs then please fork and submit a PR like you would any other change. Please note that we require 100% test coverage. Your builds will not pass if you fall below 100%.

data/definitions/doc/MAINTAINERS.md

@@ -0,0 +1,39 @@
+# Maintainers guide
+
+This document outlines the process of releasing an update of the definitions in this repository. Please note
+that this document does NOT try to explain how to create packages for various languages. It is *just*
+for creating version snapshots of definition files.
+
+To be as clear as possible: this repository is *just* for definition updates. We 'release' updates as tags in Github
+but do not push any code updates. Downstream projects (like ruby) will consume this and make their own appropriate releases.
+The 'releases' in this project are mainly for organizational purposes.
+
+### Who this document is for
+
+This document is for maintainers that have merge access to this repository. Generally these people will also have access to any
+language-specific libraries and so this will be a part of the entire release process. Usually other libraries (like the ruby library)
+will reference this document as part of its own release process.
+
+Please note that a core contributor must provide the relevant Github access so that you can perform merges. If you have any issues
+please contact the [core members](https://github.com/orgs/holidays/teams/core/members) for assistance.
+
+### Setup
+
+This guide assumes that you have forked the repository in Github. If you require assistance in this please contact the core members listed above.
+
+### Merging new definition changes
+
+When new PRs are submitted you can navigate the following steps:
+
+* Make sure that the PR Travis CI builds are green. If they are green then you can simply continue. If there are errors you
+will need to investigate further (contact a core member for assistance).
+* If the builds are green and the changes look reasonable to you then go ahead and merge!
+* Once the merges are done, make a new branch on your fork that includes an updated [CHANGELOG](https://github.com/holidays/definitions/blob/master/CHANGELOG.md)
+that has the new version and associated changes. This is pretty open-ended! Include the information that you feel is
+important. Use past CHANGELOG updates as a guide.
+* Open a PR against the CHANGELOG branch and merge it (this may require another maintainer for safety)
+* Once the updated CHANGELOG is merged, go to [releases](https://github.com/holidays/definitions/releases) and create a new release. It should point at the latest commit that contains the changes that you want included in this release. If you just merged then you can just point at master.  All release versions follow this format: `vMAJOR.MINOR.PATCH`. This should follow normal [semver rules](https://semver.org/).
+
+You don't need to list out the specific changes that were made on the release description. You can just give a general overview and then link to the updated CHANGELOG that you did in a previous step. Example: [v2.2.0](https://github.com/holidays/definitions/releases/tag/v2.2.0)
+
+Once the release is created in Github you are done! The definitions have been 'released' and downstream projects (right now just ruby) can reference them without issues. See the maintainers guides in downstream projects for information on how to release updates for each language.