ISO-Wochennummer berechnen
Geben Sie ein Datum ein und sehen Sie seine ISO-Woche: Der 1. Januar 2024 liegt in Woche 1 von 2024, der 1. Januar 2021 dagegen noch in Woche 53 von 2020. Das Wochenjahr steht gleich daneben. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Datum
- 2024-01-01
- Jahr
- 2.024
- Monat
- 1
- Tag
- 1
- ISO-Woche
- 1
Dieser ISO-Wochennummer-Rechner nimmt ein einzelnes gregorianisches Kalenderdatum im Format JJJJ-MM-TT entgegen und liefert dessen ISO-8601-Wochennummer zusammen mit dem Wochenjahr, zu dem diese beiden Werte gehören. ISO-Wochen beginnen immer am Montag und enden am Sonntag, und Woche 1 eines Jahres ist die Woche, die den ersten Donnerstag dieses Jahres enthält — deshalb weichen Ende Dezember und Anfang Januar oft von dem zivilen Jahr auf dem Kalender ab. Klassische Kontrollwerte: 2024-01-01 fällt auf Woche 1 des Jahres 2024, und 2021-01-01 fällt auf Woche 53 des Jahres 2020. Die Engine nutzt ausschließlich deterministische ganzzahlige Kalenderarithmetik: Schaltjahre, Monatslängen, Ordnungstag im Jahr und ISO-Wochentag werden ohne Netzwerkaufrufe, Zufallsstichproben oder die Systemuhr berechnet.
Was eine ISO-Wochennummer ist und was die Antwort enthält
ISO-8601-Wochendaten beantworten eine andere Frage als Monats-und-Tag-Kalender: Sie verorten einen Tag innerhalb einer montagsbasierten Woche, die von 1 bis 52 oder 53 innerhalb eines Wochenjahres nummeriert ist. Woche 1 ist definiert als die Woche, die den ersten Donnerstag des Jahres enthält, was gleichbedeutend mit der Woche ist, die den 4. Januar enthält.
Wegen dieser Regel können der 29. Dezember bis 3. Januar zum vorherigen oder nächsten Wochenjahr gehören, selbst wenn das zivile Jahr auf der Rechnung noch die alte oder neue Zahl trägt.
Dieser Rechner akzeptiert ein erforderliches Feld, date, als strikte JJJJ-MM-TT-Zeichenkette, prüft, dass der Tag im gregorianischen Kalender tatsächlich existiert — einschließlich des 29. Zu den zurückgewiesenen Fällen zählen ein fehlendes date, ein falsches Format wie 2024/01/01, unmögliche Monate und nicht existierende Tage wie 2023-02-29. Wenn Sie Unix-Epochen, Multi-Format-Parsing oder Geschäftstagsarithmetik benötigen, nutzen Sie die dafür vorgesehenen Werkzeuge; diese Seite beantwortet ausschließlich die ISO-Wochennummer und das Wochenjahr für ein validiertes Kalenderdatum.
Wie das Datum gelesen wird und wie die Woche reproduzierbar bleibt
Die Zeichenkette muss aus vier Ziffern, einem Bindestrich, zwei Ziffern, einem weiteren Bindestrich und zwei Ziffern bestehen; führende oder abschließende Leerzeichen werden entfernt, aber unvollständige Daten, ein reiner Ordnungstag im Jahr und Monatsnamen werden hier nicht erweitert. Nach dem Parsen muss das Jahr zwischen 1 und 9999 liegen, der Monat zwischen 1 und 12 und der Tag zwischen 1 und der tatsächlichen Länge dieses Monats in diesem Jahr, wobei Schaltjahre der gregorianischen Regel folgen: durch vier teilbar, außer Jahrhundertjahre, die nicht durch vierhundert teilbar sind.
Aus dem validierten Tripel berechnet die Engine den Tag im Jahr durch Summieren der Monatslängen, den ISO-Wochentag über Sakamotos reine Ganzzahlmethode, so zugeordnet, dass Montag eins und Sonntag sieben ist, und dann die Wochennummer als Abrundung von Tag-im-Jahr minus Wochentag plus zehn, alles geteilt durch sieben. Ist diese Woche kleiner als eins, gehört das Datum zur letzten Woche des vorherigen Wochenjahres; übersteigt sie die Anzahl der Wochen im zivilen Jahr, gehört sie zu Woche eins des nächsten Wochenjahres.
Ein Jahr hat dreiundfünfzig ISO-Wochen, wenn sein erster oder letzter Tag ein Donnerstag ist.
Wo ISO-Wochennummern in Planung, Berichtswesen und Software passen
Betriebs- und Finanzteams nutzen ISO-Wochennummern, wenn ein wöchentlicher Rhythmus über Länder hinweg abgeglichen werden muss, die nicht alle den Sonntag als Wochenbeginn nehmen: Produktionspläne, Verkaufsberichte im Einzelhandel, Sprint-Bezeichnungen in agilen Teams und gesetzliche Berichte, die sich auf die Kalenderwoche beziehen, profitieren alle von einer einzigen eindeutigen Wochen-ID. Entwickler rufen denselben Vertrag aus Skripten auf, um Log-Buckets zu stempeln, deterministische Testvektoren für Lohn- und Zeiterfassungssysteme zu erzeugen, oder um Produktanforderungen zu erfüllen, die W01-bis-W53-Bezeichnungen statt ad-hoc lokaler Wochennummerierung verlangen.
Lehrkräfte und Autoren von Standards nutzen das Werkzeug, um Grenzdaten wie 2005-01-01 in Woche 53 von 2004 gegenüber 2005-01-03 in Woche 1 von 2005 zu demonstrieren, ohne sich auf Tabellenkalkulations-Seriennummern zu verlassen, die zwischen Excel und ISO voneinander abweichen. Kombinieren Sie es mit Epoch-Umrechnung oder Datumsnormalisierung, wenn Sie verwandte Kalenderschritte benötigen, und mit weiteren freien deterministischen Helfern, wenn Sie ein kleines Labor von Datumshilfsmitteln zusammenstellen.
Anwendungsfälle
Wöchentliche Berichtsbezeichnungen
Dashboards, Einzelhandelsberichte und Ops-Reports mit stabilen ISO-Wochen- und Wochenjahr-Paaren statt gebietsschema-abhängiger lokaler Wochen versehen.
Jahreswechsel-Compliance-Prüfungen
Ende-Dezember- und Anfang-Januar-Daten prüfen, die zum vorherigen oder nächsten Wochenjahr gehören, bevor Bücher geschlossen oder wochenbasierte Statistiken eingereicht werden.
Häufige Fragen
Was kostet der ISO-Wochennummer-Rechner?
Auf dieser Seite ist er im Browser gratis.
Wie ist die ISO-Wochennummer definiert?
Wochen laufen Montag bis Sonntag. Woche 1 ist die Woche, die den ersten Donnerstag des Jahres enthält (die Woche mit dem 4. Januar). Das Ergebnis kann ein anderes Wochenjahr als das zivile Jahr verwenden.
Rechnet dieses Werkzeug Zeitzonen um oder nutzt es die aktuelle Uhrzeit?
Nein. Es bildet nur ein validiertes Kalenderdatum mit reiner Arithmetik auf ISO-Wochenfelder ab. Es gibt kein Date-Objekt, keine Zeitzonenverschiebung und keine Abhängigkeit von „heute“.
Warum liegt der 1. Januar 2021 in Woche 53 von 2020?
Weil Woche 1 eines Jahres die Woche mit seinem ersten Donnerstag ist und der 1. Januar 2021 davor liegt. Dieser Tag gehört deshalb noch zur letzten Woche von 2020, also zu Woche 53.
Was zeigt das Ergebnis außer der Wochennummer?
Sie sehen außerdem den Wochentag von 1 für Montag bis 7 für Sonntag mit Namen, eine kurze Kennung wie 2024-W01, die Zahl der Wochen in diesem Wochenjahr und den Tag im Jahr.
Verwandte Tools
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
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/iso-week-number \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-01-01"}'const res = await fetch("https://api.kit.forhosting.com/date/iso-week-number", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-01-01"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/iso-week-number",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-01-01"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/iso-week-number", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-01-01"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-01-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/iso-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": "2024-01-01"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.iso_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
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Limits
year_min | 1 |
year_max | 9999 |
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
Nutzen Sie ihn gratis im Browser für Planung, Lohnabrechnung und Compliance-Arbeitsblätter, oder rufen Sie die API zu $0.002 pro erfolgreicher Anfrage auf, wenn Sie reproduzierbare Wochenbezeichnungen für CI, Berichtspipelines oder Produktfunktionen benötigen.
Was eine ISO-Wochennummer ist und was die Antwort enthält
Februar nur in Schaltjahren und der korrekten Länge jedes Monats —, und liefert dann das normalisierte Datum, das zivile Jahr, den Monat und den Tag, die ISO-Wochennummer als iso_week, das Wochenjahr als iso_week_year, den ISO-Wochentag von 1 für Montag bis 7 für Sonntag mit lesbarem Namen, ein kompaktes iso_week_string wie 2020-W53, wie viele Wochen dieses Wochenjahr enthält, den Ordnungswert day-of-year sowie einen kurzen Formelhinweis. Es gibt keine Zeitzonenumrechnung, keinen gebietsschema-abhängigen ersten Wochentag und keine gleitende Näherung: Entweder ist die Eingabe ein echter Kalendertag und die Wochenfelder sind vollständig bestimmt, oder die Anfrage scheitert mit invalid_input.
Wie das Datum gelesen wird und wie die Woche reproduzierbar bleibt
Das bevorzugte Feld ist date, aber die Aliase iso_date, d und value werden akzeptiert, damit Tabellenblätter, Query-Strings und typisierte Formulare denselben Vertrag wiederverwenden können, ohne Spalten umzubenennen. Kombinieren Sie den kostenlosen Browser-Lauf auf dieser Seite mit der kostenpflichtigen API, wenn Sie dieselbe Wochenbezeichnung innerhalb einer automatisierten Pipeline benötigen.
Wo ISO-Wochennummern in Planung, Berichtswesen und Software passen
Analysten, die Jahresvergleichs-Dashboards aufbauen, vermeiden den klassischen Off-by-one-Fehler, bei dem die ersten Januartage noch zu Woche 52 oder 53 des vorherigen Wochenjahres gehören, indem sie sowohl iso_week als auch iso_week_year statt nur des zivilen Jahres speichern. Auf dieser Seite läuft die Berechnung vollständig in Ihrem Browser; über die API kostet jede erfolgreiche Abfrage $0.002, fehlgeschlagene Validierung wird nicht berechnet, und nach der Antwort wird nichts gespeichert. Diese Aufteilung — freie interaktive Erkundung und eine kostenpflichtige, identische API — entspricht dem Rest des KIT-Tier-A-Katalogs und erlaubt es Ihnen, von einer einmaligen Prüfung zu einer Pipeline zu wechseln, ohne das mathematische Ergebnis zu ändern.
Integrationsbeispiele
Deterministische Test-Fixtures
Reproduzierbare iso_week- und iso_week_string-Werte für Unit-Tests, Property-Checks und CI-Assertions ohne Date-Abweichungen erzeugen.
Technische Fragen
Warum kann iso_week_year vom Kalenderjahr abweichen?
Daten von etwa dem 29. Dezember bis 3. Januar fallen unter den ISO-8601-Regeln oft in die letzte Woche des vorherigen Wochenjahres oder in Woche 1 des nächsten.
Welche Datumsformate werden akzeptiert?
Nur strikte JJJJ-MM-TT-Kalenderdaten. Werte wie 2024/01/01, 01-01-2024 oder 2023-02-29 (kein Schaltjahr) werden mit invalid_input zurückgewiesen.