Feiertage als CSV-Download: Excel, Outlook, Google Kalender

Warum eine einmal kopierte Liste irgendwann nicht mehr reicht

Für ein einzelnes Team an einem Standort reicht es oft, die Feiertage einmal im Jahr von Hand in eine Tabelle zu tippen. Das Problem beginnt, sobald mehr als ein Bundesland dazukommt, sobald jemand die Liste für eine Software statt für eine Übersicht braucht, oder sobald ein Jahr wie 2027 kommt, in dem sich Kündigungsfristen, Rechengrößen und eben auch Feiertage gleichzeitig ändern und die Pflege leicht untergeht.

Drei Dinge machen eine von Hand gepflegte Liste besonders anfällig: regionale Feiertage, die nur in einem Teil eines Landes gelten, einmalige Feiertage wie ein Gedenktag, der nur ein einziges Mal im Kalender auftaucht, und der Jahreswechsel selbst, an dem eine vergessene Aktualisierung erst auffällt, wenn ein Feiertag im Kalender fehlt.

CSV direkt in Excel öffnen

Jeder Aufruf, der eine Liste liefert, akzeptiert den Parameter format=csv und schreibt sie als CSV-Datei statt als JSON. Für ein deutsches Excel kommt trennzeichen=semikolon dazu: Dann trennt die Datei die Spalten mit Semikolon statt Komma und schreibt Dezimalzahlen mit Komma, genau wie Excel es mit deutschen Spracheinstellungen erwartet. Ein Doppelklick auf die heruntergeladene Datei öffnet sie direkt als Tabelle, ohne Importassistenten.

Technisch folgt die Datei dem Standard RFC 4180: erste Zeile mit Spaltennamen, Zeilenumbruch als CRLF, Felder mit Komma oder Anführungszeichen in Anführungszeichen. Sie kommt als UTF-8 mit BOM, damit Umlaute in Namen wie Fronleichnam korrekt erscheinen, und der Dateiname steht im Header Content-Disposition. Mehr zum Aufbau steht unter Antworten und CSV.

Was eine Zeile der Feiertage-CSV enthält (Beispiel Neujahr, erster Eintrag des Jahrgangs)

Arbeitstage als Liste, nicht nur einzelne Feiertage

Für Sollstunden, Tagessätze oder eine Kapazitätsplanung reicht die Feiertagsliste allein oft nicht, gebraucht wird die Zahl der tatsächlichen Arbeitstage in einem Zeitraum. Genau das liefert derselbe Weg über den Arbeitstage-Rechner: Januar 2027 hat in Hessen 20 Arbeitstage bei 31 Kalendertagen, ebenfalls mit format=csv abrufbar.

Der Unterschied zur reinen Feiertagsliste: Der Arbeitstage-Rechner braucht einen Zeitraum (von und bis) und liefert eine Zahl plus die im Zeitraum abgezogenen Feiertage, nicht den kompletten Jahreskalender. Für eine vollständige Liste aller Feiertage eines Jahres bleibt die Feiertage-CSV der richtige Weg, für eine einzelne Kennzahl je Monat oder Projekt der Arbeitstage-Rechner.

Mehrere Bundesländer in einem Rutsch

Für eine bundesweite Übersicht muss der Aufruf nicht 16-mal laufen. Ohne den Parameter land liefert dieselbe Abfrage jeden Feiertag einmal, zusammen mit der Liste der Länder, in denen er gilt: 20 verschiedene Feiertage kommen 2027 auf diesem Weg zusammen, von Neujahr, der überall gilt, bis zu den drei regionalen Feiertagen, die nur in einzelnen Ländern oder Gemeinden zählen.

Für eine CSV je Standort bleibt trotzdem ein Aufruf je Bundesland der klarere Weg, weil dann jede Zeile eindeutig zu einem Land gehört. Die kombinierte Liste eignet sich besser für eine Übersicht oder als einmaliger Import in eine eigene Tabelle, aus der die Software anschließend selbst nach Standort filtert.

Automatisch aktuell bleiben, ohne auf den Jahreswechsel zu warten

Die Feiertage stehen im Datenbestand nicht nur für das laufende Jahr, sondern von 2015 bis 2035 im Voraus berechnet. Ein neues Jahr kommt deshalb nicht als plötzliche Lücke: Auch ein einmaliger Feiertag steht schon jetzt in der Liste, in Berlin zum Beispiel 75. Jahrestag des Aufstands vom 17. Juni 1953 am 17.06.2028, obwohl das Jahr noch weit voraus liegt.

Ändert sich trotzdem etwas, etwa weil ein Land ein neues Feiertagsgesetz beschließt, trägt der wöchentliche Prüflauf die Änderung ein und ein Webhook meldet sie als Ereignis wert.neu mit der fertigen Abfrageadresse für den neuen Wert. Damit muss niemand jeden Januar von Hand nachsehen, ob sich etwas geändert hat, sondern bekommt eine Nachricht, wenn es passiert.

Für einen einfachen, planbaren Rhythmus reicht auch ein jährlicher Export ohne Webhook: ein Cronjob, der Anfang Januar die aktuelle und die nächstjährige Liste zieht, deckt die meisten Fälle ab. Beide Wege ersetzen das manuelle Nachschlagen einer Webseite mit Jahreszahl im Titel.

In Outlook oder Google Kalender bekommen

Ein ehrlicher Punkt zuerst: Quellenkontor liefert die Feiertage als CSV oder JSON, keine ICS-Datei zum Abonnieren. Wer wirklich nur einen Kalender-Feed sucht, in den sich die Feiertage von selbst eintragen, ist mit einem reinen Kalenderdienst wie der OpenHolidays API, die Feiertage mehrerer Länder wahlweise als JSON oder iCal anbietet, unter Umständen schneller am Ziel.

Für Excel ist das kein Nachteil, für einen Kalender schon: Google Kalender akzeptiert Termine per CSV nur am Rechner, mit englischen Spaltennamen wie Subject, Start Date und All Day Event und Datum im Format MM/TT/JJJJ, siehe die Google-Hilfe zum Importieren von Terminen. Outlook erwartet beim klassischen CSV-Import eigene Spalten wie Betreff und Beginnt am, neuere Versionen und Outlook im Browser eher eine ICS-Datei, siehe die Microsoft-Hilfe zum Importieren und Exportieren.

Die Feiertage-CSV von Quellenkontor nutzt eigene, deutsche Spaltennamen, weil sie für Auswertungen und nicht für einen Kalender-Import gebaut ist. Für einen einmaligen Übertrag reicht es, die Spalten name und datum in Excel umzubenennen und eine Spalte für ganztägig mit dem Wert wahr zu ergänzen, dann passt die Datei zum CSV-Format der meisten Kalenderprogramme.

So bleibt die Feiertagsliste in der Praxis nutzbar

• Für Excel und Auswertungen: format=csv mit trennzeichen=semikolon, einmal je Bundesland und Jahr, direkt per Doppelklick öffnen.
• Für einen Kalender-Import: die Spalten vorher auf das Format des Zielprogramms umbenennen, statt die Rohdatei unverändert zu importieren.
• Für mehrere Bundesländer: je Land ein eigener Aufruf mit dem passenden Kürzel, etwa land=BY für Bayern.
• Für Software statt Tabellen: denselben Aufruf als JSON, SDK-Methode oder MCP-Werkzeug, ohne den CSV-Umweg.
• Für automatische Aktualität: einen Webhook auf den Datensatz feiertage einrichten oder einen jährlichen Cronjob wie im Beispiel unten.

Typische Fehler beim CSV- oder Kalender-Import

• Die Rohdatei unverändert in Google Kalender oder Outlook importieren und sich über eine Fehlermeldung wegen fehlender Spalten wundern.
• Eine CSV ohne trennzeichen=semikolon in ein deutsches Excel laden, wodurch alle Werte in einer einzigen Spalte landen.
• Die Liste einmal herunterladen und dauerhaft weiterverwenden, ohne eine Wiederholung für den nächsten Jahreswechsel einzuplanen.
• Regionale Feiertage übersehen: Sie stehen in der Liste mit regional: true, zählen aber nicht automatisch für jeden Standort im Land.
• Google Sheets mit IMPORTDATA auf die API-Adresse zeigen lassen: Die Funktion kann keinen Header und damit keinen Schlüssel mitschicken, die Datei muss heruntergeladen und importiert werden.
• Die Liste eines Vorjahres weiterverwenden, statt sie neu zu ziehen: Bewegliche Feiertage wie Christi Himmelfahrt richten sich nach Ostern und fallen jedes Jahr auf ein anderes Datum, 2027 auf den 06.05.2027.

CSV für ein deutsches Excel abrufen

$ curl "https://api.quellenkontor.dev/v1/hr/feiertage?jahr=2027&land=HE&format=csv&trennzeichen=semikolon" \
    -H "Authorization: Bearer $QK_KEY" -o feiertage-2027-he.csv

# feiertage-2027-he.csv, erste Zeile
datum;id;name;wochentag;regional;regional_hinweis;sonntag
2027-01-01;neujahr;Neujahr;Freitag;false;;false

Jährlicher Export ohne Webhook

# jeden 2. Januar um 6 Uhr die Feiertage des laufenden und des kommenden Jahres neu ziehen
0 6 2 1 * QK_KEY=qk_live_… qk feiertage --jahr 2027 --land HE --format csv --trennzeichen semikolon > /daten/feiertage-2027.csv
5 6 2 1 * QK_KEY=qk_live_… qk feiertage --jahr 2028 --land HE --format csv --trennzeichen semikolon > /daten/feiertage-2028.csv

Wofür sich der API-Weg zusätzlich lohnt

Ein CSV-Export ist der einfachste Einstieg, aber nur eine von vier Formen desselben Datensatzes. REST-API, JavaScript- und Python-SDK, CLI und MCP-Server liefern dieselben Felder, nur in anderer Form: die CLI für Skripte und Cronjobs, das SDK für eine feste Integration in eine Anwendung, der MCP-Server, damit ein KI-Agent Feiertage nachschlägt statt sie zu schätzen.

Für HR-Software, die Feiertage direkt in Abwesenheits- oder Schichtplänen braucht, beschreibt die Lösung Feiertage, Fristen und Urlaub für HR-Software den vollständigen Weg von der Planung bis zur Abfrage je Standort.