ForHosting KIT · Entwickler-Tools

Arbeitstage pro Jahr

Der Arbeitstagerechner übernimmt ein eindeutiges ISO-Datum, bestimmt dessen Kalenderjahr und zählt alle Montage bis Freitage.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Mit einer optionalen Feiertagsliste ziehen Sie Feiertage unter der Woche ab, ohne doppelte Daten oder bereits am Wochenende liegende Feiertage mehrfach zu berücksichtigen. Feste gregorianische Regeln und deterministische Arithmetik sorgen dafür, dass dieselbe Eingabe in jeder Zeitzone stets dasselbe Ergebnis liefert.

Wählen Sie das Jahr mit einem eindeutigen Datum

Geben Sie ein Datum im exakten ISO-Format YYYY-MM-DD ein. Obwohl für die Berechnung nur das Jahr verwendet wird, ist das vollständige Datum erforderlich. Dadurch bleiben API-Anfragen eindeutig und unabhängig vom aktuellen Jahr, den Regionseinstellungen des Kontos oder der Serveruhr. Beispielsweise wählt 2024-07-25 das gesamte Kalenderjahr 2024 vom 1. Januar bis zum 31. Dezember aus; die Zählung beginnt nicht erst am 25. Juli. Das Ergebnis nennt das übermittelte Datum, das gewählte Jahr, die Kalendertage, Wochenendtage, Feiertage an Werktagen und die endgültige Zahl der Arbeitstage. Die Jahre 0001 bis 9999 folgen dem proleptischen gregorianischen Kalender einschließlich seiner Schaltjahrregel. Ungültige Kalenderdaten wie 2025-02-29 werden abgewiesen und nicht stillschweigend angepasst. So eignet sich die Berechnung für reproduzierbare Planungen, Prüfungen, Tests und dauerhaft gespeicherte Geschäftsregeln.

Ziehen Sie Wochenenden und Feiertage korrekt ab

Zunächst werden alle Samstage und Sonntage des gewählten Jahres ausgeschlossen. Anschließend können Sie Feiertage als Liste von ISO-Daten übergeben. Ein Feiertag verringert die Arbeitstage nur, wenn er im ausgewählten Jahr und zwischen Montag und Freitag liegt. Fällt er auf einen Samstag oder Sonntag, ist er bereits als Wochenendtag ausgeschlossen und wird nicht erneut abgezogen. Doppelte Einträge werden ebenfalls zusammengeführt. Gültige Feiertage aus anderen Jahren werden akzeptiert, aber ignoriert. Daher können Sie eine gemeinsame mehrjährige Liste senden, ohne sie vor jeder Anfrage zu filtern. Das Werkzeug erfindet keine gesetzlichen Feiertage, verschiebt keine freien Tage automatisch und leitet kein Land aus Ihrem Standort ab. Solche Regeln unterscheiden sich je nach Rechtsraum, Arbeitgeber, Vereinbarung und Jahr. Geben Sie deshalb die tatsächlichen Schließtage Ihrer Organisation an. Die getrennte Ausgabe von Wochenenden und wirksamen Feiertagen macht das Endergebnis vollständig nachvollziehbar.

Nutzen Sie eine deterministische Zahl für Ihre Planung

Die Berechnung verwendet ausschließlich ganzzahlige Kalenderarithmetik. Sie ruft keinen Netzwerkdienst auf, liest nicht die aktuelle Uhrzeit, verwendet nicht das JavaScript-Date-Objekt und berücksichtigt weder Sommerzeitwechsel noch lokale Einstellungen. UTC steht daher für eine stabile Auslegung: 2026-01-01 bleibt in Tokio, London und Kalifornien dasselbe Kalenderdatum. Das ist besonders hilfreich für jährliche Kapazitätspläne, Personalmodelle, Auslastungsziele, Service-Level-Prognosen und Entgeltschätzungen. Speichern Sie Eingabedatum und Feiertagsliste zusammen mit der ausgegebenen Aufschlüsselung, um einen später erneut berechenbaren Prüfbeleg zu erhalten. Das Ergebnis zählt mögliche Arbeitstage von Montag bis Freitag, nicht die Stunden einzelner Beschäftigter. Urlaub, Teilzeit, nicht angegebene Betriebsschließungen, andere Wochenendmodelle und halbe freie Tage werden nicht einbezogen. Im Browser ist die Berechnung kostenlos; für automatisierte Abläufe steht die API für $0.002 bereit.

Anwendungsfälle

Jährliche Kapazität planen

Beginnen Sie mit den verfügbaren Wochentagen, ziehen Sie tatsächliche Schließtage ab und multiplizieren Sie das Ergebnis mit der täglichen Teamkapazität.

Annahmen zu Entgelt und Auslastung prüfen

Vergleichen Sie den Modellwert mit einer deterministischen Aufschlüsselung nach Wochenenden und wirksamen Feiertagen.

Prognosen reproduzierbar machen

Speichern Sie Datum und Feiertagsliste, damit spätere Berechnungen dieselben Regeln statt der aktuellen Uhr verwenden.

Häufige Fragen

Beginnt der Zählzeitraum am eingegebenen Datum?

Nein. Das Datum wählt sein gesamtes Kalenderjahr aus; alle Tage vom 1. Januar bis zum 31. Dezember werden berücksichtigt.

Welche Tage gelten als Wochenende?

Samstag und Sonntag. Andere wöchentliche Ruhetagsmodelle werden nicht automatisch erkannt.

Was geschieht mit einem Feiertag am Wochenende?

Er wird nicht erneut abgezogen, weil dieses Datum bereits in den Wochenendtagen enthalten ist.

Kennt der Rechner die gesetzlichen Feiertage?

Nein. Geben Sie die für Ihre Organisation und Ihren Rechtsraum geltenden Feiertage oder Schließtage genau an.

Was kostet eine API-Anfrage?

Eine API-Anfrage kostet $0.002. Dieselbe deterministische Berechnung ist im Browser kostenlos verfügbar.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/date/workdays-in-year

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/date/workdays-in-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-07-25"}'

const res = await fetch("https://api.kit.forhosting.com/date/workdays-in-year", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2024-07-25"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/workdays-in-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-07-25"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/workdays-in-year", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2024-07-25"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2024-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/workdays-in-year", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "date": "2024-07-25"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.workdays_in_year",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →