Schulferienklar ← Zurück zu Schulferienklar

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.

Hinweis: Schulferienklar ist ein Informationsangebot. Für verbindliche Auskünfte sind die offiziellen Veröffentlichungen der jeweiligen Bundesländer maßgeblich.

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
app/scripts/validate-generated-seo-pages.mjs

Zusätzlich werden die generierten SEO-Seiten geprüft. Dabei wird kontrolliert, ob wichtige Seitenelemente wie Titel, Meta-Beschreibung, Canonical-Link, Hauptüberschrift und Sitemap-Verweise vorhanden sind.

Der geprüfte SEO-Build kombiniert Datenvalidierung, Seitengenerierung, Prüfung der erzeugten HTML-Seiten und den Produktions-Build der App.

Aktualisierung und Zeitraum

Die App ist aktuell auf Ferien- und Feiertagsdaten von 2026 bis 2030 ausgelegt. Neue Jahre können ergänzt werden, sobald belastbare Daten vorliegen und die Validierung erfolgreich durchläuft.

Das Datum der letzten Datengenerierung wird auf den automatisch erzeugten Ferienseiten angezeigt. Die Sitemap enthält zusätzlich ein lastmod-Datum für die generierten Seiten.

Fehler melden

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

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.