ForHosting KIT · Entwickler-Tools

Beginn des nächsten Jahres

Beginn des nächsten Jahres nimmt ein explizites Datum im ISO-Format YYYY-MM-DD entgegen und gibt den 1.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Januar des Folgejahres zurück. Die Berechnung ist deterministisch: Das angegebene gregorianische Datum wird geprüft, sein Jahr wird erhöht und das Ergebnis wird formatiert, ohne die aktuelle Uhrzeit abzufragen oder von Regionseinstellungen beziehungsweise der Zeitzone eines Geräts abzuhängen. Dadurch eignet sich die Funktion für wiederholbare Automatisierungen, Tests, Abrechnungszeiträume, Aufbewahrungspläne und alle Abläufe, bei denen dieselbe Eingabe stets dieselbe Ausgabe liefern muss.

Geben Sie ein explizites ISO-Kalenderdatum an

Übermitteln Sie das Feld date als vollständigen Wert im Format YYYY-MM-DD, einschließlich führender Nullen bei Monat und Tag. Die Funktion akzeptiert gregorianische Jahre von 0001 bis 9998, damit das Folgejahr weiterhin im gleichen vierstelligen Format ausgegeben werden kann. Unvollständige Datumsangaben, Zeitstempel, Zeitzonenzusätze, unmögliche Monatsnummern und ungültige Tage wie der 31. April oder der 29. Februar eines gewöhnlichen Jahres werden abgelehnt. Dieser strenge Eingabevertrag ist nützlich, wenn Datumswerte aus Formularen, Tabellen, Datenbanken oder anderen Diensten stammen: Ein fehlerhafter Wert führt zu einer klaren Fehlermeldung, anstatt unbemerkt angepasst zu werden. Der angegebene Monat und Tag ändern die Form der Antwort nicht, werden aber dennoch geprüft, damit die Eingabe einen echten Kalendertag bezeichnet. Beispielsweise ergibt 2024-08-19 den Wert 2025-01-01; 2024-02-29 wird akzeptiert, weil 2024 nach dem gregorianischen Kalender ein Schaltjahr ist. Übermitteln Sie das Quelldatum selbst und keine Formulierung wie nächstes Jahr oder aktuelles Datum, da dieser Vorgang fehlenden zeitlichen Kontext niemals ergänzt.

Verstehen Sie das deterministische UTC-Ergebnis

Das Ergebnis enthält das geprüfte Quelldatum, das numerische Folgejahr und start_of_next_year als 1. Januar im Format YYYY-MM-DD. Der Algorithmus liest die vier Datumsbestandteile als Dezimalzahlen, prüft die gregorianischen Regeln für Schaltjahre und Monatslängen, erhöht das Jahr genau um eins und formatiert Monat und Tag als 01-01. Er erzeugt kein Date-Objekt, fragt die Systemuhr nicht ab, liest keine Regionseinstellung des Browsers und nimmt keine Umrechnung über eine lokale Zeitzone vor. Daher erzeugt eine Anfrage in UTC, New York, Tokio oder einem Offline-Browser bei gleicher Eingabe dasselbe JSON. Die Bezeichnung UTC-Kalenderrechnung bedeutet, dass das zurückgegebene Datum eine eindeutige bürgerliche Datumsgrenze bildet, die 00:00:00 UTC darstellen kann, falls ein nachgelagertes System später einen Zeitstempel benötigt. Hier wird kein Zeitstempel ausgegeben; dadurch entstehen weder unbeabsichtigte Verschiebungen noch Sommerzeitumrechnungen. Dieser Unterschied ist rund um Silvester wichtig, weil uhrbasierte Abkürzungen je nach Ausführungsort unterschiedliche Jahre auswählen können. Die explizite Eingabe bleibt die einzige maßgebliche Zeitquelle.

Verwenden Sie die Grenze sicher in Arbeitsabläufen

Nutzen Sie diese Funktion, wenn ein Ablauf den ersten Kalendertag nach dem Jahr des Quelldatums benötigt: zum Öffnen des nächsten jährlichen Berichtszeitraums, zum Festlegen einer Verlängerungsgrenze, zum Berechnen des Beginns eines künftigen kalendergleichen Geschäftsjahres oder zum Erzeugen fester Testdaten für datumsabhängige Prüfungen. Speichern oder vergleichen Sie start_of_next_year als ISO-Datum, wenn das umgebende System mit reinen Datumswerten arbeitet. Verlangt eine andere API einen Zeitpunkt, fügen Sie erst in dieser nachgelagerten Schicht eine explizite UTC-Uhrzeit hinzu; behandeln Sie die zurückgegebene Grenze beispielsweise entsprechend dem dokumentierten Format der API als Mitternacht UTC. Deuten Sie die Ausgabe nicht als ein Jahr nach dem Eingabedatum, denn dies sind unterschiedliche Vorgänge. Ein Jahr nach 2024-08-19 wäre 2025-08-19, während der Beginn des Folgejahres 2025-01-01 ist. Der Preis je über die API angefordertem Element beträgt $0.002; die reine Berechnung eignet sich außerdem für den erzeugten Browser-Client. Da keine aktuelle Uhr abgefragt wird, bleiben gespeicherte Beispiele und wiederholte Aufträge noch lange nach ihrer Erstellung reproduzierbar.

Anwendungsfälle

Das nächste Berichtsjahr eröffnen

Wandeln Sie jeden datierten Datensatz in die Grenze zum 1. Januar seines folgenden jährlichen Berichtszeitraums um.

Stabile Testdaten erstellen

Erzeugen Sie eine vorhersehbare Folgejahresgrenze, ohne die Systemuhr zu simulieren oder die Zeitzone des Testprogramms zu steuern.

Jährliche Aufbewahrungsregeln planen

Leiten Sie vor Anwendung einer Aufbewahrungsfrist den Beginn des nächsten Kalenderjahres aus einem expliziten Dokument- oder Ereignisdatum ab.

Häufige Fragen

Wird dabei das heutige Datum verwendet?

Nein. Die Berechnung verwendet ausschließlich das in der Anfrage angegebene Datum und liest niemals die aktuelle Systemuhr.

Was kostet eine Anfrage?

Jede API-Anfrage kostet $0.002.

Werden Schaltjahre geprüft?

Ja. Der 29. Februar wird nur akzeptiert, wenn das angegebene Jahr ein gregorianisches Schaltjahr ist.

Warum ist das maximale Eingabejahr 9998?

Das Folgejahr muss als vierstelliges ISO-Datum darstellbar bleiben; deshalb kann 9999 innerhalb dieses Vertrags nicht erhöht werden.

Ist dies dasselbe wie das Addieren eines Jahres?

Nein. Unabhängig von Monat und Tag des Quelldatums wird stets der 1. Januar des Folgejahres zurückgegeben.

Hängt das Ergebnis von einer Zeitzone ab?

Nein. Die Berechnung verwendet die Datumsbestandteile direkt und führt keine lokale Zeitumrechnung durch.

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/start-of-next-year

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/start-of-next-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-08-19"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/start-of-next-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-08-19"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2024-08-19"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/start-of-next-year", 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-08-19"
}

Beispiel-Antwort

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

Vollständige KIT-Dokumentation lesen →