Zum Inhalt
HALOWERK

Kalender

werktage

Count working days between two dates and explain excluded days. See the linked schema for inputs, coverage and limitations.

POST https://kalender.halowerk.com/werktage

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
vonstringJaFirst day of the range, inclusive, format YYYY-MM-DD.
bisstringJaLast day of the range, inclusive.
landstringNeinCountry code.
regionstringNeinState code for DE (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH) and AT (B, K, N, O, S, ST, T, V, W), canton code for CH (AG, AI, AR, BE, BL, BS, FR, GE, GL, GR, JU, LU, NE, NW, OW, SG, SH, SO, SZ, TG, TI, UR, VD, VS, ZG, ZH). "DE-BY" works as well. Germany also knows the municipal code BY-AU for the city of Augsburg. Without a region only nationwide holidays are returned.
samstag_ist_werktagbooleanNeinCount Saturdays as working days.
sonntag_ist_werktagbooleanNein
zusatzfreiarrayNeinOwn days off on top of the statutory ones, for example company holidays. Either "2026-05-15" or {"datum":"2026-05-15","grund":"Betriebsferien"}.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "von",
    "bis"
  ],
  "properties": {
    "von": {
      "type": "string",
      "format": "date",
      "description": "First day of the range, inclusive, format YYYY-MM-DD."
    },
    "bis": {
      "type": "string",
      "format": "date",
      "description": "Last day of the range, inclusive."
    },
    "land": {
      "type": "string",
      "enum": [
        "DE",
        "AT",
        "CH"
      ],
      "default": "DE",
      "description": "Country code."
    },
    "region": {
      "type": "string",
      "description": "State code for DE (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH) and AT (B, K, N, O, S, ST, T, V, W), canton code for CH (AG, AI, AR, BE, BL, BS, FR, GE, GL, GR, JU, LU, NE, NW, OW, SG, SH, SO, SZ, TG, TI, UR, VD, VS, ZG, ZH). \"DE-BY\" works as well. Germany also knows the municipal code BY-AU for the city of Augsburg. Without a region only nationwide holidays are returned."
    },
    "samstag_ist_werktag": {
      "type": "boolean",
      "default": false,
      "description": "Count Saturdays as working days."
    },
    "sonntag_ist_werktag": {
      "type": "boolean",
      "default": false
    },
    "zusatzfrei": {
      "type": "array",
      "maxItems": 100,
      "description": "Own days off on top of the statutory ones, for example company holidays. Either \"2026-05-15\" or {\"datum\":\"2026-05-15\",\"grund\":\"Betriebsferien\"}.",
      "items": {
        "type": [
          "string",
          "object"
        ]
      }
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "von": "2026-01-15",
  "bis": "2026-01-15",
  "land": "DE",
  "samstag_ist_werktag": false,
  "sonntag_ist_werktag": false
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →