ForHosting KIT · Datum und Zeit

Wochenanfang und -ende

Geben Sie einen Tag ein und erhalten Sie den ersten und letzten Tag seiner Woche: Mittwoch, der 3. Januar 2024, liegt in der Woche von Montag, dem 1., bis Sonntag, dem 7. Januar. Die Woche beginnt am Montag oder an einem Tag Ihrer Wahl. Kostenlos in Ihrem Browser.

  • Kostenlos
  • Läuft in Ihrem Browser
  • Ohne Anmeldung
  • Ihre Daten bleiben auf Ihrem Gerät
Nutzen Sie es über WebAPIE-MailTelegramApp bald
Wenn Sie eingeben
Datum
2024-01-03
Erster Wochentag
monday
Erhalten Sie
Index des ersten Wochentags
1
Wochentag
wednesday
Wochentagsindex
3
Tage vom Anfang
2

Den ersten und letzten Kalendertag der Woche zu finden, die ein gegebenes Datum enthält, ist ein häufiger Bedarf in Stundenzetteln, Sprint-Boards, Schulkalendern, Lohnperioden und Reporting-Dashboards. Wer nach einem Rechner für Wochenanfang und -ende sucht, kennt bereits einen Tag innerhalb der Woche und braucht die vollständige Spanne von Montag bis Sonntag oder Sonntag bis Samstag, ohne an den Fingern zu zählen. Dieses Werkzeug akzeptiert ein striktes ISO-Kalenderdatum in der Form Jahr-Monat-Tag, eine optionale Einstellung des ersten Wochentags (Standard Montag für ISO-Wochen, oder Sonntag für US-Wochen), prüft, dass der Tag im gregorianischen Kalender wirklich existiert einschließlich Schalt-Februare, berechnet den Wochentag mit Sakamotos Methode und liefert den inklusiven Wochenanfang und das Wochenende als ISO-Zeichenketten plus julianische Tagesnummern und den Versatz vom Wochenanfang. Unmögliche Basen wie der neunundzwanzigste Februar in einem Gemeinjahr scheitern mit einem klaren Validierungsfehler statt still zu umwickeln.

Wie Wochenanfang und -ende berechnet werden

Beginnen Sie mit einem zivilen Kalenderdatum, geschrieben als Jahr, Monat und Tag in der internationalen ISO-Form mit Bindestrichen und festen Breiten, damit jeder Client dieselben drei Ganzzahlen vereinbart. Bestätigen Sie, dass das Jahr in einem praktischen gregorianischen Bereich vom Jahr eins bis neuntausendneunhundertneunundneunzig liegt, dass der Monat zwischen eins und zwölf liegt und dass der Tag für diesen Monat unter den gregorianischen Schaltregeln existiert: ein Jahr ist ein Schaltjahr, wenn es durch vier teilbar ist, außer dass Jahrhundertjahre nur Schaltjahre sind, wenn sie auch durch vierhundert teilbar sind.

Diese Regel macht den neunundzwanzigsten Februar in Jahren wie zweitausendvierundzwanzig und zweitausend legal und in zweitausenddreiundzwanzig und neunzehnhundert illegal. Als Nächstes lösen Sie die Einstellung des ersten Wochentags: englische Namen sunday bis saturday oder numerische Indizes null bis sechs mit Sonntag gleich null und Montag gleich eins, standardmäßig Montag wenn weggelassen, sodass ISO-Wochen der übliche Weg sind. Berechnen Sie den Wochentag des gegebenen Datums mit Sakamotos ganzzahliger Methode, die nie die Host-Uhr abfragt.

Wandeln Sie den zivilen Tag mit der Formel von Fliegel und Van Flandern in eine astronomische julianische Tagesnummer um, subtrahieren Sie den modularen Versatz, der die Anzahl der Tage seit dem konfigurierten Wochenanfang ist, und addieren Sie sechs, um das inklusive Wochenende zu erhalten. Die inverse julianische Umwandlung liefert die zivilen ISO-Zeichenketten für Anfang und Ende.

Wo Wochengrenzen-Rechner in der echten Arbeit erscheinen

Programmmanager und Scrum Master ordnen jeden Tag mitten im Sprint dem Montag–Sonntag- oder benutzerdefinierten ersten-Wochentag-Block zu, der ihn besitzt, für Kapazitätsboards und Burndown-Diagramme. HR- und Lohnteams wandeln einen gearbeiteten Tag in die Lohnwoche um, die ihn enthält, ohne eine volle Planungsbibliothek zu laden oder von der Server-Locale abzuhängen. Lehrkräfte und Schulverwaltungen verwandeln jeden Unterrichtstag in Wochenanfang und -ende für Anwesenheitslisten und Elternkommunikation.

Analytics-Ingenieure materialisieren Wochen-Bucket-Schlüssel für Dashboards, sodass Ereignisse nach zivilem Wochenanfang gruppiert werden statt nach willkürlichen Host-Zeit-Trunkierungen, die unter Sommerzeit verschieben. Wenn Sie später ganze Wochen zwischen zwei Daten, Wochenend-Zählungen in einem Bereich, den n-ten Wochentag eines Monats oder reine Tagesaddition zu einer einzelnen Basis brauchen, behandeln Sie diese als getrennte Suchabsichten und Landingpages statt diese Wochenanfang-und-ende-Seite zu überladen.

Sprint- und Stundenzettel-Wochengrenzen

Ordnen Sie jedes Arbeitsdatum mitten in der Woche dem inklusiven Montag–Sonntag- oder Sonntag–Samstag-Bereich für Stundenzettel, Sprint-Boards und Kapazitätsberichte ohne Host-Zeitzonen-Drift zu.

Lohn- und Anwesenheitsperioden

Wandeln Sie einen gearbeiteten oder Unterrichtstag in die ISO-Zeichenketten für Wochenanfang und -ende um, die von Lohnzyklen, Schul-Anwesenheitslisten und elternorientierten Kalendern genutzt werden.

Was bedeuten Wochenanfang und -ende?

Es bedeutet den ersten und letzten zivilen Kalendertag der siebentägigen Woche, die Ihr Datum enthält, gemäß einer Einstellung des ersten Wochentags wie Montag oder Sonntag, ohne Geschäftstag-Regeln oder Wanduhrzeit.

Welches Datumsformat ist erforderlich?

Striktes ISO YYYY-MM-DD mit vierstelliger Jahreszahl und zweistelligem Monat und Tag. Werte wie 2024-1-3 oder 2024/01/03 werden abgelehnt, damit jeder Client übereinstimmt.

Was passiert bei einem ungültigen Datum wie 2023-02-29?

Die Fehlermeldung erklärt, dass der Tag für dieses Jahr und diesen Monat im date-Feld nicht gültig ist.

An welchem Tag beginnt die Woche standardmäßig?

Am Montag, wie bei Wochen im ISO-Stil. Sie können auch Sonntag wie in den USA oder einen anderen Wochentag wählen, die Woche hat immer sieben Tage und enthält Ihr Datum.

Kann die Woche in einen anderen Monat oder ein anderes Jahr reichen?

Ja. Beginnt die Woche am Sonntag, liegt Mittwoch, der 3. Januar 2024, in der Woche vom 31. Dezember 2023 bis zum 6. Januar 2024. Beide Grenzen werden vollständig angegeben.

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.

POSThttps://api.kit.forhosting.com/date/week-start-end

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

curl -X POST https://api.kit.forhosting.com/date/week-start-end \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-01-03"}'
{
  "date": "2024-01-03"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.week_start_end",
  "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.

pro Anfrage$0.002

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

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Was Sie senden und was Sie zurückerhalten

Senden Sie ein Pflicht-Zeichenkettenfeld date als strikten ISO-Kalendertag wie zweitausendvierundzwanzig Bindestrich null eins Bindestrich null drei, und optional first_weekday wie monday oder sunday oder einen Index von null bis sechs. Fehlendes date, Nicht-Zeichenkettenwerte, Zeichenketten die nicht dem Vier-Zwei-Zwei-Ziffernmuster entsprechen, Daten die dem Muster entsprechen aber keine echten Kalendertage sind, und unbekannte Wochentags-Token scheitern mit invalid_input und werden nicht berechnet. Bei Erfolg spiegelt die Antwort das normalisierte Datum, den aufgelösten first_weekday-Namen und -Index, den Wochentagsnamen und -Index des Eingabetags, days_from_start als Versatz null bis sechs vom Wochenanfang, week_start und week_end als inklusive ISO-Zeichenketten, julianische Tagesnummern für die Eingabe und beide Grenzen, length_days immer sieben, und eine kurze Formelzeichenkette, die den Sakamoto- und JDN-Pfad dokumentiert. Klassische Prüfungen umfassen den Mittwoch den dritten Januar zweitausendvierundzwanzig mit montagsbeginnenden Wochen, die den ersten bis siebten Januar ergeben, dasselbe Datum mit sonntagsbeginnenden Wochen, die den einunddreißigsten Dezember zweitausenddreiundzwanzig bis sechsten Januar zweitausendvierundzwanzig ergeben, und eine Eingabe die bereits der erste Wochentag ist und diesen Tag als week_start mit days_from_start null zurückgibt. Die Preisgestaltung für erfolgreiche API-Aufrufe ist die veröffentlichte Basis von $0.002 pro Element; Validierungsfehler verbrauchen kein vorausbezahltes Guthaben.

Wo Wochengrenzen-Rechner in der echten Arbeit erscheinen

Weil diese Fähigkeit eine reine Parse-Engine ist, ist der API-Preis die veröffentlichte Basis von $0.002 pro erfolgreichem Element und fehlgeschlagene Validierung wird nicht berechnet.

Analytics-Wochen-Bucket-Schlüssel

Leiten Sie stabile zivile week_start-Schlüssel für Ereignisgruppierung und Kohorten-Dashboards ab, sodass Buckets in jeder Umgebung derselben Erst-Wochentags-Regel folgen.

Was ist der Standard-erste Wochentag?

Montag, passend zu üblichen ISO-Wochen. Übergeben Sie first_weekday als sunday (oder 0) für US-Wochen, oder einen anderen Wochentagsnamen oder Index 0–6.

Was kostet es?

Das Browser-Werkzeug ist kostenlos und läuft lokal. API-Anfragen nutzen vorausbezahltes KIT-Guthaben zu $0.002 pro erfolgreichem Element; ungültige Eingabe wird nicht berechnet.

Vollständige KIT-Dokumentation lesen →