US-Wochennummer-Rechner
Ermitteln Sie die US-Wochennummer eines Datums, mit Wochen von Sonntag bis Samstag und Woche 1 als der Woche mit dem 1. Januar: Der 15. März 2024 liegt in Woche 11. Sie sehen auch, wie viele Wochen das Jahr hat. 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-03-15
- Jahr
- 2.024
- Monat
- 3
- Tag
- 15
- Tag des Jahres
- 75
In den Vereinigten Staaten nummerieren viele Kalender, Gehaltssysteme, Schulplaner und Tabellenmodelle die Wochen so, dass jede Woche am Sonntag beginnt und Woche eins einfach die Woche ist, die den ersten Januar enthält. Diese Regel unterscheidet sich vom ISO-8601-Wochendatensystem, das Wochen am Montag startet und Woche eins als die Woche mit dem ersten Donnerstag des Jahres definiert. Wenn ein Plan, Bericht oder Audit-Trail US-Wochennummern statt ISO-Wochennummern treffen muss, vermeidet ein kleiner deterministischer Konverter Eigenheiten des Host-Date und Locale-Drift.
So zählt die US-Wochennummer
In den USA beginnen die Wochen in vielen Lohnsystemen, Schulplänen und Tabellen am Sonntag und enden am Samstag. Woche 1 ist dabei einfach die Woche, in der der 1. Januar liegt, auch wenn sie schon im Dezember des Vorjahres begonnen hat. Danach zählt jeder neue Sonntag eine Nummer weiter. Für die Berechnung nehmen Sie den Tag des Jahres, ziehen eins ab, addieren den Wochentag des 1. Januar mit Sonntag als null, teilen durch sieben, runden ab und zählen eins dazu. Der 15. März 2024 ist so der 75. Tag des Jahres und liegt in Woche 11.
Typische Verwechslungen vermeiden
Der häufigste Fehler ist, die US-Nummer mit der ISO-Kalenderwoche gleichzusetzen. ISO-Wochen beginnen am Montag, und Woche 1 ist dort die Woche mit dem ersten Donnerstag des Jahres, deshalb kann derselbe Tag zwei verschiedene Nummern tragen. Ebenso irrt, wer annimmt, dass ein Jahr immer zweiundfünfzig Wochen hat: Der 31. Dezember kann in Woche 53 fallen, je nachdem, auf welchen Wochentag der 1. Januar fiel und ob es ein Schaltjahr ist. Nutzen Sie die US-Zählung für Lohnperioden sowie für Schul- und Handelskalender, deren Wochen am Sonntag beginnen.
US-Wochenregeln gegenüber ISO-Wochen und wie Sie ein Datum senden
Nach der hier verwendeten US-Konvention beginnt eine Woche immer am Sonntag und endet am Samstag. Woche eins eines Jahres ist die Woche, die den ersten Januar einschließt, selbst wenn diese Woche im Dezember des Vorjahres am Wandkalender begann. Spätere Wochen zählen als vollständige Sonntag-bis-Samstag-Blöcke bis zum einunddreißigsten Dezember, der in Woche zweiundfünfzig oder dreiundfünfzig fallen kann, je nachdem wo der erste Januar lag und ob das Jahr ein Schaltjahr ist.
ISO-8601-Wochen sind anders: sie starten am Montag, und Woche eins ist die mit dem ersten Donnerstag des Jahres, sodass derselbe bürgerliche Tag auf einen anderen Wochenindex abbilden kann.
Wie die Nummer berechnet wird und wie ungültige Daten aussehen
Die Engine validiert zuerst den gregorianischen Kalendertag und wendet Schaltjahresregeln an, sodass Februar neunundzwanzig Tage nur hat, wenn das Jahr durch vier teilbar ist, außer dass Jahrhundertjahre auch durch vierhundert teilbar sein müssen. Dann berechnet sie den Tag des Jahres aus kumulativen Monatslängen und den Wochentag des Datums mit Integer-Arithmetik, ohne ein Host-Date-Objekt zu verwenden. Die US-Wochennummer ist der Floor von Tag-des-Jahres minus eins plus dem Wochentag des ersten Januar, alles geteilt durch sieben, plus eins, wobei Sonntag Wochentag null ist.
Diese Formel setzt den ersten Januar in Woche eins und rückt an jedem folgenden Sonntag um eins vor. Fehlgeformte Zeichenketten, die nicht vierstellige Jahr, zweistelliger Monat und zweistelliger Tag durch Bindestriche getrennt sind, werden ebenfalls abgelehnt.
Anwendungsfälle
Gehaltsabrechnung und US-Arbeitswochenberichte
HR- und Gehaltspipelines, die Stunden nach sonntagsbeginnenden Wochen gruppieren, kennzeichnen jede Lohnperiode mit der US-Wochennummer, die das Arbeitsdatum enthält, abgestimmt auf gängige WEEKNUM-Erwartungen in Tabellen.
Schul- und Einzelhandelsplanungskalender
Bezirkskalender und Merchandising-Pläne nummerieren Wochen oft mit dem 1. Januar in Woche 1; wandeln Sie ISO-Daten in diesen Index für Folien, E-Mail-Digests und Bestandsfenster um.
Häufige Fragen
Ist das dieselbe wie die ISO-Wochennummer?
Nein. ISO-Wochen beginnen am Montag und definieren Woche 1 über die Regel des ersten Donnerstags. Dasselbe bürgerliche Datum kann unter ISO-Regeln einen anderen Index liefern.
Was passiert, wenn das Datum ungültig ist?
Beispiele: falsches YYYY-MM-DD-Format, 30. Februar oder 29. Februar in einem Nicht-Schaltjahr. Fehlgeschlagene Validierung wird nicht berechnet.
Kann ein Jahr 53 US-Wochen haben?
Ja. Der 31. Dezember liegt in Woche zweiundfünfzig oder 53, je nach Wochentag des 1. Januar und danach, ob es ein Schaltjahr ist. Das Jahr 2024 etwa endet mit Woche 53.
Kann Woche 1 schon im Dezember beginnen?
Ja. Woche 1 ist die Woche von Sonntag bis Samstag, die den 1. Januar enthält. Fällt dieser Tag in die Wochenmitte, hat sie in den letzten Dezembertagen des Vorjahres begonnen.
Beginnen die Wochen am Sonntag oder am Montag?
Am Sonntag. Jede US-Woche läuft von Sonntag bis Samstag, anders als ISO-Wochen, die am Montag beginnen und deren Woche 1 den ersten Donnerstag des Jahres enthält.
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/us-week-number \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-15","calendar":"valor-ejemplo"}'const res = await fetch("https://api.kit.forhosting.com/date/us-week-number", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-15",
"calendar": "valor-ejemplo"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/us-week-number",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-15",
"calendar": "valor-ejemplo"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/us-week-number", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-15","calendar":"valor-ejemplo"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-15","calendar":"valor-ejemplo"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/us-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-03-15",
"calendar": "valor-ejemplo"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.us_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.
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
Dieser US-Wochennummer-Rechner akzeptiert ein ISO-Kalenderdatum, wendet gregorianische Schaltjahresarithmetik und eine reine Wochentagsformel an und liefert den Wochenindex zusammen mit Wochentags- und Jahresfakten in stabilem JSON.
US-Wochenregeln gegenüber ISO-Wochen und wie Sie ein Datum senden
Senden Sie entweder eine Datumszeichenkette im Format YYYY-MM-DD oder die strukturierten Felder year, month und day zusammen. Aliase wie calendar, calendar_date und iso_date werden für den Zeichenkettenpfad akzeptiert. Teilweise strukturierte Eingabe ohne alle drei Teile wird mit invalid_input abgelehnt, damit Aufrufer den Körper korrigieren statt fehlende Werte zu raten. Identische Eingaben erzeugen immer identisches JSON, weil der Pfad nie die Wanduhr, Locale oder das Netz liest.
Wie die Nummer berechnet wird und wie ungültige Daten aussehen
Unmögliche Daten wie der einunddreißigste April, der dreißigste Februar oder der neunundzwanzigste Februar in einem Nicht-Schaltjahr scheitern mit invalid_input und einer Meldung, die die echte Länge des Monats angibt. Die Antwort spiegelt week_starts gleich Sunday, week_1_rule gleich contains_january_1 und weeks_in_year gleich der US-Woche des einunddreißigsten Dezember wider, damit Dashboards den Jahresbereich ohne zweiten Aufruf zeigen können.
API-Nutzung, Preise, Workflows und praktische Grenzen
Rufen Sie den kostenlosen US-Wochennummer-Rechner im Browser für Hausaufgabenprüfungen, Planungsdemos und schnelle Verifikation ohne Installieren von Kalenderbibliotheken auf. Kombinieren Sie diesen Endpunkt mit ISO-Ordinal- oder Tage-im-Monat-Werkzeugen, wenn Sie Tagesindizes oder die Februarlänge brauchen, erwarten Sie aber nicht, dass der Wochenindex ISO-Wochendatum-Labels trifft. Jahresgrenzen folgen dem veröffentlichten Parameterbereich für Isolationssicherheit. Senden Sie einen JSON-Körper mit date als YYYY-MM-DD oder mit year, month und day als Ganzzahlen in den veröffentlichten Bereichen. Bei Erfolg enthält die Nutzlast das normalisierte Datum, strukturierte Komponenten, day_of_year, day_of_week von null für Sonntag bis sechs für Samstag mit einem englischen Namen, week_number, weeks_in_year, is_leap_year, calendar gleich gregorian und method gleich us_week_number für Router und Tests, die nach Labels verzweigen. Nutzen Sie die Prepaid-API, wenn ein Gehaltsexport, Schulkalender, Einzelhandelsplanungswerkzeug oder SDK einen stabilen Vertrag unter KIT-Guthaben zu $0.002 pro erfolgreichem Element braucht; Validierungsfehler verbrauchen nie Guthaben nach Ablehnung durch die Engine.
Integrationsbeispiele
Tabellenparität in APIs
Dienste, die sonntagsbasierte Wochennummern von Excel oder Google Sheets treffen müssen, stellen ein stabiles JSON-Feld bereit, statt die Wochentagsmathematik in jeder Client-Sprache neu zu implementieren.
Technische Fragen
Wie erhalte ich die US-Wochennummer für ein Datum?
Senden Sie JSON mit date als ISO-Zeichenkette wie 2024-03-15 oder year, month und day. Die Antwort enthält week_number und day_of_week_name.
Beginnen Wochen am Sonntag oder Montag?
Am Sonntag. Dieser Rechner nutzt die US-Konvention: week_starts ist immer Sunday, und Woche 1 ist die mit dem 1. Januar.
Ist der US-Wochennummer-Rechner kostenlos?
Das Browser-Werkzeug läuft kostenlos auf Ihrem Gerät. API-Aufrufe nutzen Prepaid-KIT-Guthaben zu $0.002 pro erfolgreichem Element; Validierungsfehler werden nicht berechnet.