Datenquellen

Schulferienklar zeigt Schulferien, gesetzliche Feiertage und zusammenhängende freie Zeiten für deutsche Bundesländer. Die Daten werden als strukturierte JSON-Dateien gepflegt und vor der Veröffentlichung automatisch validiert.

Schulferien

Die Schulferien-Daten liegen im Repository unter data/holidays. Sie enthalten Datensätze für alle 16 Bundesländer.

• alle 16 deutschen Bundesländer
• Ferien, unterrichtsfreie Tage und landesspezifische Besonderheiten
• JSON- und CSV-Dateien pro Bundesland
• zusätzliche Validierungsnotizen je Datensatz

Feiertage

Die Feiertags-Daten liegen unter data/public-holidays. Sie werden nach Bundesland und Jahr gepflegt.

• alle 16 deutschen Bundesländer
• Jahre 2026 bis 2030
• landesweite, regionale und lokale Feiertage
• automatisch erzeugte Index-Datei für die App

Regionale und lokale Feiertage

Nicht jeder Feiertag gilt automatisch für ein gesamtes Bundesland. Einige Feiertage gelten nur regional oder lokal, zum Beispiel in bestimmten Gemeinden oder Städten.

Solche Feiertage sind in den Daten enthalten, werden aber in der Standard-Kalenderansicht nicht automatisch als Feiertag markiert, wenn sie nicht für das gesamte Bundesland gelten.

Beispiele:

• Mariä Himmelfahrt in Bayern: regional, abhängig von der Gemeinde.
• Augsburger Friedensfest: lokal, nur in Augsburg.
• Fronleichnam in Teilen von Sachsen und Thüringen: regional.

Freie Zeit rund um Ferien

Schulferienklar unterscheidet zwischen offiziellen Ferien und tatsächlich zusammenhängenden freien Zeiten. Wochenenden und gesetzliche Feiertage, die direkt an Ferien angrenzen, können deshalb zusätzlich als freie Zeit sichtbar gemacht werden.

Diese Darstellung soll bei der praktischen Planung helfen, ersetzt aber nicht die offiziellen Ferien- oder Feiertagsregelungen.

Validierung

Vor der Veröffentlichung werden die Daten mit Validierungsskripten geprüft. Dabei werden unter anderem Pflichtfelder, Datumsformate, Bundesland-Codes, Duplikate und erlaubte Statuswerte kontrolliert.

Verwendete Prüfskripte:

• scripts/validate-holidays.mjs
• scripts/validate-public-holidays.mjs

Fehler melden

Wenn ein Datum fehlt oder falsch wirkt, kann ein Hinweis über die Support-Seite gesendet werden.

Stand: MVP-Version. Die Datenstruktur und Darstellung werden weiter verbessert.

English note

Schulferienklar provides German school holiday and public holiday data by federal state. Regional and local public holidays may be included in the data, but they are not shown as statewide holidays by default if they do not apply to the entire Bundesland.