Feiertagskalender — Werktage-API Online
Werktagsarithmetik für ein Land, optional für eine Region: Werktage zwischen zwei Daten zählen, Werktage addieren oder subtrahieren, ein Datum prüfen oder den nächsten / vorherigen Werktag finden. Berücksichtigt das Wochenende des jeweiligen Landes, landesweite und regionale arbeitsfreie Feiertage, Verschiebungen per Erlass (ein Samstag, an dem gearbeitet wird) und die Kriegsrechtsregelung der Ukraine. Daten von 2020-01-01 bis 2035-12-31. Antworten aus einem vorberechneten Kalender in wenigen Millisekunden.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/business-days
— Kontingentklasse: cheap
| Parameter | Beschreibung |
|---|---|
op | count (Standard) | add | subtract | is | next | prev |
country | ISO-2-Ländercode (erforderlich, genau eines) |
region | ISO-3166-2-Region, z. B. DE-BY (optional) |
start_date | YYYY-MM-DD (erforderlich) |
end_date | YYYY-MM-DD (op=count) |
days | Zu addierende oder zu subtrahierende Werktage, 0-3650 (op=add|subtract); 0 = start_date, wenn es ein Werktag ist, sonst der nächste (add) bzw. vorherige (subtract) |
inclusive | op=count: true (Standard) zählt start_date und end_date mit; false lässt start_date weg |
weekend | Optionale Wochenend-Überschreibung, z. B. fri,sat oder 5,6 (ISO-Wochentage); none = keine Wochenendtage |
Antwortfelder — innerhalb des data-Objekts im Antwortumschlag. [] steht für eine Liste, data.items[].name ist also das Feld name jedes Elements. Ein Feld ist null, fehlt oder ist eine leere Liste, wenn wir keinen Wert dafür haben — nie ein Platzhalter.
| Feld | Beschreibung |
|---|---|
data.business_days | op=count: Werktage im Zeitraum, mit calendar_days und non_business_days. |
data.result_date | op=add|subtract|next|prev: das resultierende Datum. |
data.is_business_day | op=is: true oder false, bei false mit reasons[] (weekend, holiday: <name>, day off by decree transfer). |
data.weekend_days | Vorhanden, wenn ?weekend= das Wochenende des Landes überschrieben hat. |
data.calendar_window | Erstes und letztes Datum, das der Kalender abdeckt. |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/business-days?op=count&country=DE®ion=DE-BY&start_date=2026-01-01&end_date=2026-12-31" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Aktualisiert