ForHosting KIT · Datum und Zeit

ISO-8601-Wochennummer

Geben Sie ein Datum ein und erhalten Sie die ISO-8601-Kalenderwoche samt Wochenjahr: Der 25. Juli 2026 liegt in Woche 30, kurz 2026-W30. Wochen laufen von Montag bis Sonntag, und Woche 1 enthält den ersten Donnerstag des Jahres. Kostenlos in Ihrem Browser.

Kostenlos
Läuft in Ihrem Browser
Ohne Anmeldung
Ihre Daten bleiben auf Ihrem Gerät

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Rechenbeispiel

Wenn Sie eingeben

Datum: 2026-07-25

Erhalten Sie

Woche: 30
Wochenjahr: 2.026
ISO-Woche: 2026-W30
Wochentag: 6

Die ISO-8601-Wochennummerierung ist der Standard für europäische Berichte, Lohnkalender, Fertigungspläne und viele APIs. Anders als US-Wochen, die oft am Sonntag beginnen und nicht ins nächste Jahr greifen, beginnt eine ISO-Woche immer am Montag, und Woche 1 ist die Woche mit dem ersten Donnerstag des gregorianischen Jahres. Deshalb können Ende Dezember und Anfang Januar zu einem anderen ISO-Wochenjahr gehören als das auf dem Datum stehende Kalenderjahr. Diese Fähigkeit nimmt eine ISO-Datumszeichenkette, interpretiert sie als zivilen UTC-Tag und liefert die Wochennummer (1–53), das ISO-Wochenjahr, ein kompaktes YYYY-Www-Label und den Wochentag — deterministisch, ohne Zeitzonen-Rätselraten.

Was eine ISO-Wochennummer tatsächlich bedeutet

Mit «Wochennummer» meinen Menschen oft drei verschiedene Dinge: die ordinale Woche des Kalenderjahres ab dem 1. Januar, die Woche im Monat (erste bis fünfte Woche innerhalb eines Monats) oder die in der internationalen Norm definierte ISO-8601-Woche. Nur die letzte ist in Ländern mit ISO-Kalendern stabil.

Nach ISO 8601 hat jede Woche sieben Tage von Montag bis Sonntag. Woche 1 des Jahres Y ist die Woche mit dem ersten Donnerstag von Y — gleichbedeutend mit der Woche, die den 4. Januar enthält.

Jahre können daher 52 oder 53 ISO-Wochen haben. Bei 53 Wochen können der 29., 30. oder 31. Dezember noch in Woche 53 jenes ISO-Jahres liegen, und der 1.–3.

Januar des nächsten Kalenderjahres kann noch zu Woche 52 oder 53 des vorherigen ISO-Wochenjahres gehören. Kalenderjahr und Wochenjahr zu verwechseln ist der häufigste Fehler in selbst gebauten Datumshelfern, Dashboards und SQL-Berichten. Dieser Endpunkt isoliert diese Regel, damit Aufrufer eine einzige, geprüfte Antwort erhalten statt abweichender Ergebnisse aus locale-abhängigen Bibliotheken.

Eingabevertrag und Auswertung nur in UTC

Senden Sie ein Pflichtfeld date als ISO-8601-Zeichenkette. Bevorzugt ist YYYY-MM-DD (zum Beispiel 2026-07-25). Ein vollständiges DateTime mit Uhrzeit und optionalem Zonensuffix wird akzeptiert, aber nach dem Parsen zählt nur der Kalendertag; die Berechnung läuft stets auf diesem zivilen Tag um Mitternacht UTC.

Fehlende oder nicht-stringige Werte scheitern ebenfalls an der Validierung und werden nicht berechnet.

Wo Pipelines Wochennummern nutzen und wie Sie aufrufen

Wöchentliche KPIs, Sprint-Boards, ISO-Wochen folgende Finanzberichte, nach Woche etikettierte Logistikfenster und CSV-Anreicherungsjobs brauchen einen verlässlichen Wochenindex. Allein diese drei fangen Off-by-one-Fehler bei Montag/Sonntag, Wochenjahr-Fehler an Jahresgrenzen und die Auffüllung einstelliger Wochen. Halten Sie den UTC-Vertrag ein: brauchen Sie lokale Mitternächte in einer anderen Zone, wandeln Sie zuerst in das lokale zivile Datum um und übergeben Sie hier YYYY-MM-DD, damit die Wochenberechnung rein und reproduzierbar bleibt.

Anwendungsfälle

Wöchentliche Analysen und KPI-Rollups

Gruppieren Sie Ereignisse nach ISO-Woche und Wochenjahr, damit Dezember- und Januar-Verkehr in die richtige Berichtswoche fällt und nicht ins falsche Kalenderjahr.

Lohn- und Fertigungskalender

Kennzeichnen Sie Stundenzettel, Schichten und Produktionslose mit ISO-Wochennummern, die zu europäischen und ISO-konformen Planungssystemen passen.

Häufige Fragen

Was ist die ISO-8601-Wochennummer?

Es ist der Wochenindex von 1 bis 53 laut ISO 8601: Wochen beginnen am Montag, und Woche 1 ist die Woche mit dem ersten Donnerstag des Jahres (bzw. die Woche mit dem 4. Januar).

Läuft die Berechnung in lokaler Zeit oder in UTC?

Nur UTC. Das Datum gilt als ziviler UTC-Tag (YYYY-MM-DD). Optionale Zeitsuffixe werden für die Wochenrechnung ignoriert, damit Ergebnisse über Zeitzonen hinweg deterministisch bleiben.

Warum gehören die ersten Januartage manchmal zur Woche des Vorjahres?

Weil ISO-Wochen zu einem Wochenjahr gehören, das vom Kalenderjahr abweichen kann. Der 1. bis 3. Januar kann noch in Woche 52 oder 53 des vorherigen ISO-Jahres liegen.

Wie viele ISO-Wochen hat ein Jahr?

Entweder 52 oder 53. Woche 1 ist die Woche mit dem 4. Januar, daher kann in Jahren mit 53 Wochen der 29., 30. oder 31. Dezember noch in Woche 53 liegen.

Kann ich ein Datum mit Uhrzeit eingeben?

Ja. Ein Datum mit Uhrzeit, auch mit Zeitzone, wird angenommen, aber nur der Kalendertag zählt. Die Woche wird immer für diesen Tag um Mitternacht UTC berechnet.

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/week-number

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/week-number \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-25"}'

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

import os, requests

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

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

body := bytes.NewBufferString(`{"date":"2026-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/week-number", 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": "2026-07-25"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.week_number",
  "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.

Technische Hinweise

Eingabevertrag und Auswertung nur in UTC

Unmögliche Daten wie 2026-02-30 werden mit invalid_input abgelehnt statt von der Host-Date-Implementierung vorgerollt. Die Antwort enthält das normalisierte Datum, week (1–53), week_year (das ISO-Wochenjahr, das nahe Grenzen vom gregorianischen Jahr abweichen kann), iso_week in kompakter Form 2026-W30 sowie weekday (Montag=1 … Sonntag=7) und weekday_name zur Lesbarkeit.

Wo Pipelines Wochennummern nutzen und wie Sie aufrufen

Nutzen Sie das kostenlose Browser-Tool für Einzelprüfungen oder die Prepaid-API, wenn Sie Tausende Zeilen normalisieren: jedes erfolgreiche Item kostet den veröffentlichten Basispreis von $0.002, ungültige Eingaben sind kostenlos. Kombinieren Sie diese Fähigkeit mit Datumsnormalisierung bei unsauberen Quelldaten und mappen Sie danach jeden bereinigten ISO-Tag auf week und week_year vor dem Gruppieren.

Integrationsbeispiele

CSV- und Warehouse-Anreicherung

Fügen Sie week- und iso_week-Spalten in Exportpipelines ein, damit BI-Tools Zeilen gruppieren können, ohne ISO-Regeln in SQL-Dialekten nachzubauen.

Technische Fragen

Warum kann week_year vom Kalenderjahr abweichen?

Um den Jahreswechsel können Tage Ende Dezember oder Anfang Januar zum vorherigen oder nächsten ISO-Wochenjahr gehören. Der Donnerstag jener Woche bestimmt das Wochenjahr, nicht das gregorianische Jahr des Tages selbst.

Welche Datumsformate werden akzeptiert?

YYYY-MM-DD ist bevorzugt. Vollständige ISO-DateTimes werden akzeptiert, wenn sie mit einem gültigen Kalenderdatum beginnen; unmögliche Daten und fehlende Werte liefern invalid_input.

Was kostet die ISO-Wochennummer-API?

Das Browser-Tool ist kostenlos. Erfolgreiche API-Aufrufe nutzen Prepaid-Guthaben zum veröffentlichten Basispreis von $0.002 pro Item; ungültige Eingaben werden nicht berechnet.

Vollständige KIT-Dokumentation lesen →

ISO-8601-Wochennummer

Im Browser ausführen – kostenlos

Rechenbeispiel

Was eine ISO-Wochennummer tatsächlich bedeutet

Eingabevertrag und Auswertung nur in UTC

Wo Pipelines Wochennummern nutzen und wie Sie aufrufen

Anwendungsfälle

Wöchentliche Analysen und KPI-Rollups

Lohn- und Fertigungskalender

Häufige Fragen

Verwandte Tools

Für Entwickler — API-Zugang

Endpunkt

Aufruf aus Ihrem Stack

Beispiel-Anfrage

Beispiel-Antwort

Preis

Fehler

Technische Hinweise

Eingabevertrag und Auswertung nur in UTC

Wo Pipelines Wochennummern nutzen und wie Sie aufrufen

Integrationsbeispiele

CSV- und Warehouse-Anreicherung

Technische Fragen

danke