Wochennummer mit freiem Wochenstart
Wählen Sie, an welchem Tag Ihre Wochen beginnen, und erhalten Sie die Wochennummer jedes Datums, wobei Woche 1 stets den 1. Januar enthält: Der 15. März 2024 liegt in Woche 11, wenn die Woche am Montag beginnt. 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
- Erster Wochentag
- monday
- Jahr
- 2.024
- Monat
- 3
- Tag
- 15
- Tag des Jahres
- 75
Dieser Wochennummer-Rechner nimmt ein gregorianisches Kalenderdatum im Format YYYY-MM-DD und den von Ihnen gewählten ersten Wochentag entgegen und liefert die Wochennummer des Jahres nach einer einfachen, expliziten Regel: Wochen beginnen stets an dem von Ihnen gewählten Tag, und Woche 1 ist die Woche, die den 1. Januar des bürgerlichen Jahres enthält. Diese Konvention entspricht der gängigen Praxis in Tabellenkalkulation und Betrieb, wenn Sie Sonntag, Montag, Samstag oder einen anderen Start brauchen, ohne die ISO-8601-Grenzen des Wochenjahres zu übernehmen. Die Engine nutzt ausschließlich deterministische ganzzahlige Kalenderarithmetik—Schaltjahre, Monatslängen, Jahrestag und Sakamoto-Wochentage—ohne Netzaufrufe, Zufall oder Host-Uhr.
Was eine Wochennummer mit freiem Start ist und was die Antwort enthält
Eine Wochennummer des Jahres beantwortet „in welcher Woche dieses bürgerlichen Jahres liegt dieses Datum?“, sobald feststeht, wie Wochen beginnen. Anders als das ISO-8601-Wochendatum, das stets am Montag beginnt und späten Dezember oder frühen Januar einem anderen Wochenjahr zuordnen kann, hält dieser Rechner das bürgerliche Jahr fest und ändert nur den Startwochentag. Abgelehnt werden fehlendes Datum, Formen wie 2024/03/15, unmögliche Monate, der 29.
Februar außerhalb eines Schaltjahres und unbekannte Wochentags-Token. Wenn Sie ISO-Woche und Wochenjahr-Paare brauchen, nutzen Sie das eigene ISO-Wochennummer-Werkzeug; brauchen Sie nur US-Wochen mit Sonntagsstart, ist das US-Wochennummer-Werkzeug eine feste Spezialisierung derselben Familie. Diese Seite richtet sich an Teams, die den ersten Wochentag bewusst wählen und dennoch einen stabilen Wochenindex im bürgerlichen Jahr wollen.
Wo Wochennummern mit freiem Start in Planung, Reporting und Software passen
Operations- und Produktteams brauchen oft einen Wochenrhythmus, der zur lokalen Kultur passt: viele europäische Boards starten am Montag, US-Handel und manche Schulkalender am Sonntag, und manche Branchen behandeln Samstag als ersten Tag der Schichtrotation. Ein einziger Rechner, der nur den Startwochentag ändert und Woche 1 an der Woche des 1. Januar festhält, lässt dieselbe Codebasis diese Zielgruppen bedienen, ohne sieben leicht verschiedene Wochenhelfer auszuliefern.
Entwickler stempeln Log-Buckets, Sprint-Labels und Zeitenblatt-Perioden mit einem deterministischen Index, der Tabellenkalkulations-Erwartungen im Stil von WEEKNUM trifft, wenn der Rückgabetyp über Sonntag hinaus verallgemeinert wird. Lehrende und Normenautoren können nebeneinander zeigen, dass montagsbeginnende Wochennummern unter der 1.-Januar-Regel nicht dieselben sind wie ISO-Wochennummern nahe Jahresgrenzen, was teure Off-by-one-Fehler in Compliance-Blättern verhindert. Kombinieren Sie sie mit Wochenanfangs- und -end-Werkzeugen, wenn Sie die Montags- oder Sonntagsgrenzen derselben Woche brauchen, mit der ISO-Wochennummer, wenn gesetzliches Reporting ISO-8601 verlangt, und mit Wochentags-Hilfen, wenn Sie nur den Wochentagsnamen ohne Wochenindex brauchen.
Anwendungsfälle
Regionsbewusste Wochen-Dashboards
Berichte mit Wochen-des-Jahres-Labels stempeln, die regionale Erste-Tage-Einstellungen (Montag, Sonntag oder Samstag) treffen, ohne auf ISO-Wochenjahr-Regeln umzuschalten.
Tabellenkompatible Wochenindizes
Excel-artiges WEEKNUM-Verhalten, verallgemeinert auf jeden Startwochentag, für Importe, Zeitenblätter und Finanzpakete, die im bürgerlichen Jahr bleiben.
Häufige Fragen
Was kostet der Wochennummer-Rechner mit freiem ersten Tag?
Auf dieser Seite ist er in Ihrem Browser kostenlos.
Wie ist Woche 1 definiert?
Woche 1 ist die Woche, die den 1. Januar des bürgerlichen Jahres enthält. Wochen laufen stets sieben Tage ab dem von Ihnen gewählten Wochentag. Das ist nicht die ISO-Regel des ersten Donnerstags.
Worin unterscheidet sich das vom ISO-Wochennummer-Rechner?
ISO-Wochen beginnen stets am Montag und können nahe dem 1. Januar ein anderes Wochenjahr zuweisen. Dieses Werkzeug behält das bürgerliche Jahr und ändert nur den ersten Wochentag; Woche 1 enthält stets den 1. Januar.
Nutzt dies Zeitzonen oder die aktuelle Uhr?
Nein. Es ordnet nur ein geprüftes Kalenderdatum und einen ersten Wochentag mit reiner Arithmetik Wochenfeldern zu. Es gibt kein Date-Objekt, keine Zeitzonenverschiebung und keine Abhängigkeit von heute.
Welcher Starttag gilt, wenn ich keinen wähle?
Der Montag. Sie können auf jeden Tag von Sonntag bis Samstag wechseln, und Woche 1 bleibt die Woche mit dem 1. Januar, ganz gleich, welchen Starttag Sie wählen.
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/week-number-custom-start \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-15"}'const res = await fetch("https://api.kit.forhosting.com/date/week-number-custom-start", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-15"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/week-number-custom-start",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-15"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/week-number-custom-start", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-15"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/week-number-custom-start", 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"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.week_number_custom_start",
"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
Nutzen Sie sie kostenlos im Browser für Planungsboards und regionsspezifische Kalender, oder rufen Sie die API zu $0.002 pro erfolgreicher Anfrage auf, wenn Pipelines jedes Mal dasselbe Wochenlabel brauchen.
Was eine Wochennummer mit freiem Start ist und was die Antwort enthält
Sie übergeben date als strenge YYYY-MM-DD-Zeichenkette und optional first_weekday als englischen Namen (sunday bis saturday) oder eine ganze Zahl von null für Sonntag bis sechs für Samstag; fehlt first_weekday, wird Montag angenommen. Nach der Prüfung spiegelt die Antwort das normalisierte Datum, bürgerliches Jahr, Monat und Tag, den Ordinalwert day_of_year, den Wochentag der Eingabe in Kleinbuchstaben und Title Case plus nullbasierten Index, aufgelöstes first_weekday und first_weekday_index, wie viele Tage das Datum vom Wochenanfang entfernt liegt, week_number ab eins aufwärts, weeks_in_year als Wochennummer des 31. Dezember unter demselben Starttag, week_1_rule gleich contains_january_1, Schaltjahr- und Kalenderflags, ein method-Tag und eine kurze Formelzeichenkette zur Dokumentation. Es gibt keine Zeitzonenumrechnung und keine Abhängigkeit von „heute“: Entweder bilden die Eingaben einen echten Kalendertag und einen gültigen ersten Wochentag, oder die Anfrage scheitert mit invalid_input.
Wie Datum und erster Wochentag gelesen werden, damit Ergebnisse reproduzierbar bleiben
Die Zeichenkette muss vier Ziffern, einen Bindestrich, zwei Ziffern, einen weiteren Bindestrich und zwei Ziffern ergeben; führende und nachgestellte Leerzeichen werden gekürzt, aber Teilangaben, Monatsnamen und der bloße Jahrestags-Ordinalwert werden hier nicht expandiert. Das Jahr muss zwischen 1 und 9999 liegen, der Monat zwischen 1 und 12, und der Tag zwischen 1 und der wahren Länge dieses Monats in jenem Jahr, mit Schaltjahren nach der gregorianischen Regel (durch vier teilbar außer Jahrhunderte, die nicht durch vierhundert teilbar sind). Januar mit Sakamotos rein ganzzahliger Methode (Sonntag null, Samstag sechs). Der Versatz des 1. Januar in der benutzerdefinierten Woche ist (Wochentag des 1. Die Wochennummer des 31. Das bevorzugte Datumsfeld ist date, aber die Aliase iso_date, d, value und calendar werden akzeptiert, damit Tabellen, Query-Strings und Formulare den Vertrag ohne Spaltenumbenennung wiederverwenden. Das Feld first_weekday akzeptiert Namen oder numerische Indizes und hat die Aliase week_start, start_day und first_day; leere oder weggelassene Werte gelten standardmäßig als Montag, sodass ein ISO-artiger Wochenstart einen Tastendruck entfernt ist, ohne die ISO-Wochenjahr-Regel zu erzwingen. Aus dem geprüften Tripel berechnet die Engine day_of_year durch Summieren der Monatslängen mit Februar-Schaltjahresanpassung, dann die Wochentage des Eingabedatums und des 1. Januar minus first_weekday plus sieben) modulo sieben; die Wochennummer ist der Floor von day_of_year minus eins plus diesem Versatz, alles geteilt durch sieben, dann plus eins. Dezember unter demselben Starttag wird als weeks_in_year zurückgegeben, damit Dashboards wissen, ob ein Jahr unter dieser Konfiguration 52, 53 oder 54 Wochenlabels hat. Kombinieren Sie den kostenlosen Browserlauf auf dieser Seite mit der tarifierten API, wenn Sie dasselbe Wochenlabel in einer automatisierten Pipeline brauchen.
Wo Wochennummern mit freiem Start in Planung, Reporting und Software passen
Analysten, die Jahr-über-Jahr-Dashboards bauen, können week_number zusammen mit first_weekday_index speichern, damit Filter eindeutig bleiben, wenn zwei Regionen den Wochenbeginn unterschiedlich sehen. Auf dieser Seite läuft die Arbeit 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—kostenlose interaktive Erkundung und tarifierte, identische API—entspricht dem übrigen KIT-Katalog der Stufe A und lässt Sie von einer Einzelprüfung zu einer Pipeline wechseln, ohne das mathematische Ergebnis zu ändern.
Integrationsbeispiele
Deterministische CI-Fixtures
Reproduzierbare week_number-Werte für Unit-Tests unter mehreren first_weekday-Einstellungen erzeugen, ohne Date-Schieflage oder Host-Locale.
Technische Fragen
Welche Werte darf first_weekday annehmen?
Englische Namen sunday bis saturday (ohne Groß-/Kleinschreibung) oder ganze Zahlen 0–6 mit Sonntag = 0 und Samstag = 6. Standard ist monday, wenn das Feld weggelassen wird.