Referenz

Referenz: Arbeitstage

Arbeitstage zwischen zwei Daten je Bundesland, ohne Wochenenden und Feiertage.

Zählt die Arbeitstage zwischen zwei Daten in einem Bundesland: Montag bis Freitag oder auf Wunsch Montag bis Samstag, abzüglich der gesetzlichen Feiertage. Für Teilmonate, Tagessätze, Fristen und Personalplanung.

Endpunkte und Aufrufe

Zugang	Aufruf
REST-API	`GET /hr/arbeitstage`
SDK JavaScript	`qk.hr.arbeitstage(…)`
SDK Python	`qk.hr.arbeitstage(…)`
CLI	`qk arbeitstage --von 2027-01-01 --bis 2027-01-31 --land HE`
MCP-Werkzeug	`hr_arbeitstage`

Parameter

Name	Typ	Pflicht	Standard	Erlaubt	Beschreibung
`von`	Datum (JJJJ-MM-TT)	ja			Erster Tag, einschließlich
`bis`	Datum (JJJJ-MM-TT)	ja			Letzter Tag, einschließlich. Nicht vor von, Zeitraum höchstens zehn Jahre, innerhalb 2015 bis 2035
`land`	Text	ja		BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH	Kürzel des Bundeslands, zum Beispiel HE; der Name wie Hessen geht auch
`samstag`	true oder false	nein	false		Samstage mitzählen (Werktage). Standard: false
`regionale`	true oder false	nein	false		Regionale Feiertage abziehen. Standard: false

Unbekannte Parameter lehnt die API mit unbekannter_parameter ab. Dazu kommen format und trennzeichen, siehe CSV.

Antwortfelder

Feld	Typ	Bedeutung
`datensatz`	Text	Kennung des Datensatzes
`von`	Datum	Erster Tag, einschließlich
`bis`	Datum	Letzter Tag, einschließlich
`land`	Text oder null	Kürzel des Bundeslands
`land_name`	Text	Name des Bundeslands
`samstag_als_arbeitstag`	Boolesch	Ob Samstage mitgezählt sind
`regionale_feiertage_abgezogen`	Boolesch	Ob regionale Feiertage abgezogen sind
`kalendertage`	Ganzzahl	Zahl der Kalendertage
`arbeitstage`	Ganzzahl	Zahl der Arbeitstage
`feiertage_an_arbeitstagen`	Liste	Abgezogene Feiertage
`rechtsgrundlage`	Text	Gesetz oder Verordnung
`quelle`	Objekt	Titel und URL der Quelle, auf der der Wert beruht
`quellen`	Liste	Alle Normen, auf denen die Antwort beruht, mit Titel und URL
`hinweise`	Liste	Grenzen der Werte oder der Berechnung, in Sätzen
`stand`	Datum	Tag der letzten Prüfung gegen die Quelle
`lizenz`	Text	Nutzungsbedingungen der Werte
`zitat`	Text	Fertiger Satz mit Wert, Gültigkeit, Rechtsgrundlage und Quelle zum Zitieren
`datenstand`	Text	Kennung des Datenstands: Datum und laufende Nummer der letzten Änderung im Änderungsprotokoll (/v1/aenderungen), die diesen Datensatz betrifft. Gleicher Datenstand heißt unveränderter Inhalt, praktisch für Prüfer und zum Vergleich zweier Abfragen

Beispiel

Aufruf mit von = 2027-01-01, bis = 2027-01-31, land = HE. Die Antwort erzeugt derselbe Code, der auch die API beantwortet.

api.quellenkontor.dev/v1/hr/arbeitstage?von=2027-01-01&bis=2027-01-31&land=HE

Zur API-Doku →

curl "https://api.quellenkontor.dev/v1/hr/arbeitstage?von=2027-01-01&bis=2027-01-31&land=HE" \
  -H "Authorization: Bearer $QK_KEY"

import { Quellenkontor } from "@quellenkontor/sdk";

const qk = new Quellenkontor(process.env.QK_KEY);
const daten = await qk.hr.arbeitstage({ von: "2027-01-01", bis: "2027-01-31", land: "HE" });

import os
from quellenkontor import Quellenkontor

qk = Quellenkontor(api_key=os.environ["QK_KEY"])
daten = qk.hr.arbeitstage(von="2027-01-01", bis="2027-01-31", land="HE")

$ qk arbeitstage --von 2027-01-01 --bis 2027-01-31 --land HE

{
  "name": "hr_arbeitstage",
  "arguments": {
    "von": "2027-01-01",
    "bis": "2027-01-31",
    "land": "HE"
  }
}

So ruft ein Agent das Werkzeug auf. Die Einrichtung des Servers steht in der MCP-Doku.

Antwort200 OK · JSON

{
  "datensatz": "arbeitstage",
  "von": "2027-01-01",
  "bis": "2027-01-31",
  "land": "HE",
  "land_name": "Hessen",
  "samstag_als_arbeitstag": false,
  "regionale_feiertage_abgezogen": false,
  "kalendertage": 31,
  "arbeitstage": 20,
  "feiertage_an_arbeitstagen": [
    {
      "datum": "2027-01-01",
      "name": "Neujahr",
      "regional": false
    }
  ],
  "rechtsgrundlage": "Hessisches Feiertagsgesetz (HFeiertagsG), Hessen",
  "quelle": {
    "titel": "Hessisches Feiertagsgesetz (HFeiertagsG), Hessen",
    "url": "https://www.rv.hessenrecht.hessen.de/bshe/document/jlr-FeiertGHE1952pP1"
  },
  "quellen": [
    {
      "titel": "Hessisches Feiertagsgesetz (HFeiertagsG), Hessen",
      "url": "https://www.rv.hessenrecht.hessen.de/bshe/document/jlr-FeiertGHE1952pP1"
    }
  ],
  "hinweise": [
    "Gezählt werden Montag bis Freitag.",
    "Regionale Feiertage sind nicht abgezogen. Setze regionale=true, wenn dein Standort in einem Gebiet mit regionalem Feiertag liegt."
  ],
  "stand": "2026-09-23",
  "lizenz": "Berechnung nach den genannten Normen. Nutzung nach den Nutzungsbedingungen von Quellenkontor.",
  "zitat": "Arbeitstage vom 01.01.2027 bis 31.01.2027 in Hessen: 20 von 31 Kalendertagen, Montag bis Freitag ohne gesetzliche Feiertage des Landes. Rechtsgrundlage: Hessisches Feiertagsgesetz (HFeiertagsG), Hessen. Quelle: Hessisches Feiertagsgesetz (HFeiertagsG), Hessen, https://www.rv.hessenrecht.hessen.de/bshe/document/jlr-FeiertGHE1952pP1. Daten: Quellenkontor (quellenkontor.dev).",
  "datenstand": "2026-09-23.1"
}

Fehlerfälle

Status	Code	Wann
400	`parameter_fehlt`	wenn von oder bis oder land fehlt
400	`ungueltiger_parameter`	falsches Format oder Wert außerhalb von: land (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH)
400	`unbekannter_parameter`	Parameter, den es für diesen Datensatz nicht gibt
404	`kein_wert`	außerhalb der Abdeckung (2015 bis 2035) oder Wert für diesen Zeitraum noch nicht verkündet
401, 429	siehe Fehler	alle Fehlercodes

Schema für MCP

So beschreibt der MCP-Server die Argumente des Werkzeugs hr_arbeitstage:

inputSchema

{
  "type": "object",
  "properties": {
    "von": {
      "description": "Erster Tag, einschließlich",
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "examples": [
        "2027-01-01"
      ]
    },
    "bis": {
      "description": "Letzter Tag, einschließlich. Nicht vor von, Zeitraum höchstens zehn Jahre, innerhalb 2015 bis 2035",
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "examples": [
        "2027-01-31"
      ]
    },
    "land": {
      "description": "Kürzel des Bundeslands, zum Beispiel HE; der Name wie Hessen geht auch",
      "type": "string",
      "enum": [
        "BW",
        "BY",
        "BE",
        "BB",
        "HB",
        "HH",
        "HE",
        "MV",
        "NI",
        "NW",
        "RP",
        "SL",
        "SN",
        "ST",
        "SH",
        "TH"
      ],
      "examples": [
        "HE"
      ]
    },
    "samstag": {
      "description": "Samstage mitzählen (Werktage). Standard: false",
      "type": "boolean"
    },
    "regionale": {
      "description": "Regionale Feiertage abziehen. Standard: false",
      "type": "boolean"
    }
  },
  "required": [
    "von",
    "bis",
    "land"
  ],
  "additionalProperties": false
}

Quelle und Stand

Angabe	Inhalt
Quelle	Feiertagsgesetze der Länder
Lizenz	Berechnung nach den genannten Normen. Nutzung nach den Nutzungsbedingungen von Quellenkontor.
Aktualisierung	bei Gesetzesänderung
Abdeckung	Deutschland, 2015 bis 2035
Zuletzt geprüft	23.09.2026
Nächste erwartete Änderung	folgt den Feiertagen

Überblick mit Tabellen und Fragen zum Datensatz: Arbeitstage-Rechner. Einen Fehler meldest du über das Kontaktformular.

Fehlt etwas oder ist etwas unklar? Schreib uns, wir ergänzen die Doku.