Zum Inhalt
HALOWERK

Kalender

werktage / rechnen

Add or subtract working days from a starting date and report the calculation. See the linked schema for inputs, coverage and limitations.

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

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
startstringJaStart date, format YYYY-MM-DD. It is never counted itself.
werktageintegerJaPositive counts forward, negative backward, 0 returns the next working day on or after the start date.
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": [
    "start",
    "werktage"
  ],
  "properties": {
    "start": {
      "type": "string",
      "format": "date",
      "description": "Start date, format YYYY-MM-DD. It is never counted itself."
    },
    "werktage": {
      "type": "integer",
      "minimum": -2000,
      "maximum": 2000,
      "description": "Positive counts forward, negative backward, 0 returns the next working day on or after the start date."
    },
    "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

{
  "start": "2026-01-15",
  "werktage": -2000,
  "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 →