ForHosting KIT · Datum und Zeit

Wochentag des Monatsersten aus einem ISO-Datum

Geben Sie ein beliebiges Datum ein und erfahren Sie, an welchem Wochentag sein Monat begann: Der 13. August 2026 führt zum 1. August 2026, einem Samstag. Sie erhalten auch die ISO-Wochentagsnummer und einen Index ab Sonntag für Kalenderraster. 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-08-13

Erhalten Sie

Eingegebenes Datum: 2026-08-13
Erstes Datum: 2026-08-01
Jahr: 2.026
Monat: 8

Dieser Rechner bestimmt, an welchem Wochentag der Monat eines ausdrücklich angegebenen ISO-Datums begann. Der eingegebene Tag darf an jeder Stelle des Monats liegen; das Ergebnis bezieht sich immer auf den ersten Tag. Ausgegeben werden das kanonische Anfangsdatum, der Name des Wochentags, die ISO-Nummer und ein sonntagsbasierter Index. Eine strenge gregorianische Prüfung weist unmögliche Daten zurück.

Geben Sie ein vollständiges, eindeutiges ISO-Datum ein

Übergeben Sie das Feld date als vollständiges ISO-Kalenderdatum im Format YYYY-MM-DD. Vier Ziffern stehen für das Jahr, zwei für den Monat und zwei für den Tag. Beispielsweise wählt 2026-08-13 den August 2026 aus; zugleich belegt der letzte Bestandteil, dass Sie ein echtes, ausdrückliches Datum und nicht nur eine unvollständige Monatsangabe übermittelt haben.

Das Werkzeug prüft den gesamten Wert, bevor es einen Wochentag berechnet. Monate müssen zwischen 01 und 12 liegen, der Tag muss im angegebenen Monat vorkommen, und für Februar gelten die gregorianischen Schaltjahrregeln. Durch vier teilbare Jahre sind normalerweise Schaltjahre, Jahrhundertjahre jedoch nur dann, wenn sie durch vierhundert teilbar sind.

Zulässig sind die Jahre 0001 bis 9999. Zeitstempel, Zeitzonensuffixe, Wochen- oder Ordinaldaten, abweichende Trennzeichen und regionale Formate werden abgewiesen. Dadurch werden unmögliche Werte wie 2023-02-29 oder 2026-13-01 nicht unbemerkt in ein anderes Datum umgewandelt.

So funktioniert die deterministische Berechnung

Nach der Prüfung behält der Algorithmus Jahr und Monat bei und setzt den Tag für die Wochentagsberechnung gezielt auf eins. Er verwendet eine feste gregorianische Ganzzahlformel mit einer kleinen Tabelle von Monatsverschiebungen, Anpassungen für durch vier teilbare Jahre, Korrekturen für Jahrhundertjahre und einer Wiederherstellung bei durch vierhundert teilbaren Jahren. Januar und Februar zählen dabei rechnerisch zum Vorjahr.

Der Rest modulo sieben ergibt einen sonntagsbasierten Index: Null bedeutet Sonntag, eins Montag und sechs Samstag. Zusätzlich wird dieser Index in die ISO-Zählung umgerechnet, bei der Montag eins und Sonntag sieben ist, und der Wochentagsname wird aus einer festen Tabelle gewählt. Zu keinem Zeitpunkt entsteht ein Systemdatum.

Nutzen Sie das Ergebnis für Kalender, Berichte und Tests

Kalenderoberflächen können mit dem Index die leeren Zellen vor dem ersten Tag bestimmen. Berichte können den Eröffnungswochentag jeder Abrechnungsperiode nennen, und Tests erhalten stabile Vergleichswerte, ohne eine Uhr zu simulieren oder die Zeitzone zu ändern. Das Werkzeug berechnet weder den ersten Arbeitstag noch Feiertage, lokalisiert keine Wochentagsnamen und sucht nicht das erste Auftreten eines gewünschten Wochentags.

Es beantwortet ausschließlich, auf welchen Wochentag der Erste des Monats fiel, der das ISO-Datum enthält.

Anwendungsfälle

Monatskalender aufbauen

Platzieren Sie den ersten Tag mithilfe des Index in der richtigen Spalte und berechnen Sie die vorangehenden Leerzellen.

Abrechnungsperioden kennzeichnen

Ergänzen Sie Monatsberichte um den Eröffnungswochentag, wenn ein Buchungsdatum den Zeitraum bestimmt.

Stabile Datumstests erstellen

Erzeugen Sie deterministische Monatsanfangswerte, ohne die Systemuhr zu lesen, lokale Daten anzulegen oder Zeitzonen einzustellen.

Häufige Fragen

Muss der eingegebene Tag der Monatserste sein?

Nein. Jedes echte Datum des gewählten Monats ist zulässig. Es wird geprüft und anschließend der Wochentag des ersten Tages berechnet.

Kann die Zeitzone das Ergebnis verändern?

Nein. Die Berechnung nutzt gregorianische Ganzzahlarithmetik und erzeugt weder ein Date noch liest sie lokale Zeitzoneneinstellungen.

Wie hilft mir das Ergebnis beim Aufbau eines Monatskalenders?

Zählen Sie mit dem Index ab Sonntag die leeren Felder vor dem Monatsersten. Der August 2026 beginnt an einem Samstag, Index 6, ein Raster ab Sonntag braucht also sechs leere Felder.

Worin unterscheiden sich die beiden Wochentagsnummern?

Die ISO-Nummer reicht von Montag als 1 bis Sonntag als 7. Der Index ab Sonntag reicht von Sonntag als 0 bis Samstag als 6. Für einen Samstag sind beide zufällig 6.

Liefert das Werkzeug den ersten Werktag des Monats?

Nein. Es nennt nur den Wochentag des Monatsersten. Es überspringt weder Wochenenden noch Feiertage und sucht auch nicht das erste Vorkommen eines gewählten Wochentags.

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/weekday-of-first-of-month

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/weekday-of-first-of-month \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-08-13"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/weekday-of-first-of-month",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-08-13"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2026-08-13"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weekday-of-first-of-month", 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-08-13"
}

Beispiel-Antwort

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

Die Berechnung verwendet feste Ganzzahlarithmetik ohne Netzwerk, Zufall, Systemuhr, Zeitzonenumrechnung oder Date-Objekt, sodass Browser und API deterministische Ergebnisse liefern.

Geben Sie ein vollständiges, eindeutiges ISO-Datum ein

Nach erfolgreicher Prüfung beeinflusst der eingegebene Tag das Ergebnis nicht mehr: Jedes gültige Datum desselben Monats erzeugt dieselben Felder first_date und weekday.

So funktioniert die deterministische Berechnung

Das verhindert, dass eine Datums-API eine reine Datumszeichenfolge nach lokalen Regeln deutet und Mitternacht über eine Kalendergrenze verschiebt. Dieselbe Eingabe hängt ausschließlich vom proleptischen gregorianischen Kalender ab und liefert daher in UTC, in Browsern mit anderer Zeitzone und bei späteren API-Aufrufen dasselbe Ergebnis.

Nutzen Sie das Ergebnis für Kalender, Berichte und Tests

Die Antwort eignet sich sowohl zur Anzeige als auch zur technischen Weiterverarbeitung. first_date enthält den kanonischen Wert YYYY-MM-01 des ausgewählten Monats. weekday nennt den Wochentag, iso_weekday liefert die ISO-Zahl von eins bis sieben für Montag bis Sonntag, und weekday_sunday_zero unterstützt Systeme, deren Wochenlisten mit Sonntag am Index null beginnen. input_date, year und month sorgen außerdem dafür, dass gespeicherte Ergebnisse verständlich bleiben. Die Browserausführung ist kostenlos; automatisierte API-Anfragen kosten $0.002. Ungültige Eingaben liefern invalid_input und bleiben damit von internen Fehlern unterscheidbar.

Technische Fragen

Was bedeutet iso_weekday?

Das Feld folgt ISO: Montag ist 1, Dienstag 2 und Sonntag 7. weekday_sunday_zero wird zusätzlich für sonntagsbasierte Listen ausgegeben.

Was geschieht bei einem unmöglichen Datum?

Die Anfrage liefert invalid_input, etwa bei ungültigen Monaten, nicht vorhandenen Tagen, dem Jahr 0000 oder einem unzulässigen 29. Februar.

Was kostet eine API-Anfrage?

Eine erfolgreiche API-Anfrage kostet $0.002. Dieselbe deterministische Berechnung läuft im Browser auch kostenlos.

Vollständige KIT-Dokumentation lesen →

Wochentag des Monatsersten aus einem ISO-Datum

Im Browser ausführen – kostenlos

Rechenbeispiel

Geben Sie ein vollständiges, eindeutiges ISO-Datum ein

So funktioniert die deterministische Berechnung

Nutzen Sie das Ergebnis für Kalender, Berichte und Tests

Anwendungsfälle

Monatskalender aufbauen

Abrechnungsperioden kennzeichnen

Stabile Datumstests erstellen

Häufige Fragen

Verwandte Tools

Für Entwickler — API-Zugang

Endpunkt

Aufruf aus Ihrem Stack

Beispiel-Anfrage

Beispiel-Antwort

Preis

Fehler

Technische Hinweise

Geben Sie ein vollständiges, eindeutiges ISO-Datum ein

So funktioniert die deterministische Berechnung

Nutzen Sie das Ergebnis für Kalender, Berichte und Tests

Technische Fragen

danke