/Feiertage

Kalender und Informationen zu Deutschen Feiertagen

Primary LanguagePHPMIT LicenseMIT

Deutsche Feiertage

Dies ist die Datengrundlage für https://projects.kkapsner.de/Kalender/Feiertage/

Viele Leute wissen nicht, dass es nur einen Deutschen Feiertag gibt: der Tag der Deutschen Einheit (3. Oktober)1

Alle anderen Feiertage sind durch die Länder festgelegt. Dabei gibt es 8 weitere Feiertage, die bundeseinheitlich sind1:

  • Neujahr (1. Januar)
  • Karfreitag (Freitag vor dem Ostersonntag2)
  • Ostermontag (Montag nach dem Ostersonntag2)
  • Christi Himmelfahrt (39 Tage nach dem Ostersonntag2)
  • Pfingstmontag (50 Tage nach dem Ostersonntag2)
  • Tag der Arbeit (1. Mai)
  • erster Weihnachtstag (25. Dezember)
  • zweiter Weihnachtstag (26. Dezember)

Die anderen Feiertage sind von Bundesland zu Bundesland verschieben. Es gibt sogar Feiertage, die von Gemeinde zu Gemeinde unterschiedlich sind (z.B. Mariä Himmelfahrt in Bayern34 oder das Friedensfest in Augsburg3)

verpflichtende Parameter

region

Code der Region, für die die Feiertage ausgegeben werden sollen. Folgende Codes sind unterstützt5:

  • BB: Brandenburg
  • BE: Berlin
  • BW: Baden-Württemberg
    • BW-Schule: schulfreie Tage in Baden-Württemberg
  • BY: Bayern36
    • BY-A: Stadt Augsburg36
    • BY-k: Landkreis in Bayern mit vorwiegend katholischer Bevölkerung346
    • BY-Schule: schulfreie Tage in Bayern367
    • BY-A-Schule: schulfreie Tage der Stadt Augsburg367
  • HB: Bremen
  • HE: Hessen
  • HH: Hamburg
  • MV: Mecklenburg-Vorpommern
  • NI: Niedersachsen 8
  • NW: Nordrhein-Westfalen
  • RP: Rheinland-Pfalz
  • SH: Schleswig-Holstein
  • SL: Saarland
  • SN: Sachsen
  • ST: Sachsen-Anhalt
  • TH: Thüringen

optionale Parameter

type

Rückgabetyp der Feriendatei. Mögliche Werte:

  • ics (Standardwert)
  • csv
  • html
  • json
  • raw (funktioniert ohne Region)

Beispiel: https://projects.kkapsner.de/Kalender/Feiertage/?type=json

year

Erstes Jahr, das für die beweglichen Feiertage verwendet wird. Standartwert ist das aktuelle Jahr minus dem Parameter yearsAgo.

yearsAgo

Anzahl der Jahre in der Vergangenheit, in denen bewegliche Feiertage angezeigt wird. Standartwert in 1.

Wird ignoriert wenn year verwendet wird.

endYear

Letztes Jahr, das für die beweglichen Feiertage verwendet wird. Standartwert ist das Startjahr plus dem Parameter yearsCount.

yearsCount

Anzahl der Jahre, in denen bewegliche Feiertage angezeigt wird. Standartwert in 5.

Wird ignoriert wenn endYear verwendet wird.

noCache

Die reine Anwesenheit dieses Parameters schaltet den Cache aus

separator

Separator der CSV-Datei. Sollte immer in Zusammenhang mit noCache verwendet werden.

Beispiel: https://projects.kkapsner.de/Kalender/Feiertage/?region=BY&type=csv&noCache&separator=;

Disclaimer

  1. Bis jetzt sind nur die Feiertage von Bayern und Niedersachsen mit den Gesetzestexten abgeglichen.
  2. Die Feiertage bilden den aktuellen Stand (29.04.2022) ab. Abweichende Regelungen in der Vergangenheit (z.B. Änderungen beim Reformationstag) werden nicht berücksichtigt.

Footnotes

  1. https://www.bmi.bund.de/DE/themen/verfassung/staatliche-symbole/nationale-feiertage/nationale-feiertage-node.html Stand 29.04.2022 ↩ ↩2

  2. Zur Berechnung des Ostersonntags wird Spencers Osterformel verwendet: https://doi.org/10.1038/013487a0 ↩ ↩2 ↩3 ↩4

  3. https://www.gesetze-bayern.de/Content/Document/BayFTG-1 Stand 29.04.2022 ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7

  4. https://www.statistik.bayern.de/statistik/gebiet_bevoelkerung/zensus/himmelfahrt/index.php ↩ ↩2

  5. https://www.destatis.de/DE/Methoden/abkuerzung-bundeslaender-DE-EN.html Stand 29.04.2022 ↩

  6. https://www.stmi.bayern.de/suv/bayern/feiertage/index.php Stand 29.04.2022 ↩ ↩2 ↩3 ↩4 ↩5

  7. https://www.gesetze-bayern.de/Content/Document/BayFTG-4 Stand 29.04.2022 ↩ ↩2

  8. https://www.mi.niedersachsen.de/startseite/themen/allgemeine_angelegenheiten_des_inneren/feiertagsrecht/feiertagsgesetz-61491.html Stand 30.04.2022 ↩