ForHosting KIT · Entwickler-Tools

Countdown bis zum nächsten Geburtstag berechnen

Dieser Countdown-Rechner ermittelt den nächsten Geburtstag anhand eines ausdrücklich angegebenen Geburtsdatums und Stichtags.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Er liefert das Kalenderdatum, die genaue Anzahl verbleibender Kalendertage, das dann erreichte Alter und die Angabe, ob der Termin im Bezugsjahr liegt. Jahreswechsel und Schaltjahre werden berücksichtigt, ohne die aktuelle Uhr abzufragen, eine Zeitzone zu verwenden oder externe Dienste aufzurufen. Gleiche Eingaben ergeben daher stets dieselbe überprüfbare Antwort.

Geben Sie zwei vollständige Kalenderdaten ein

Tragen Sie birth_date und reference_date im eindeutigen Format YYYY-MM-DD einschließlich führender Nullen ein. Das Geburtsdatum liefert den wiederkehrenden Monat und Tag sowie das Jahr für die Altersberechnung. Der Stichtag beginnt den Countdown und darf nicht vor der Geburt liegen. Beide Werte werden als echte gregorianische Daten geprüft; unmögliche, unvollständige oder mehrdeutige Angaben werden abgelehnt und nicht stillschweigend berichtigt. Weil Sie den Stichtag selbst bestimmen, eignet sich das Werkzeug für historische Abfragen, Tests und künftige Planung, ohne von der Geräteuhr abzuhängen. Fällt der Stichtag auf den Geburtstag, ist days_remaining null und dasselbe Datum wird zurückgegeben. So bleibt der Geburtstag während des gesamten Kalendertags der nächste und springt nicht vorzeitig ins Folgejahr.

Verstehen Sie Jahreswechsel und Ausgabefelder

Zunächst wird der Geburtstag im Bezugsjahr gebildet. Liegt er am Stichtag oder danach, wird er ausgewählt und occurs_this_year ist true. Ist er bereits vergangen, verwendet der Rechner den Termin im Folgejahr und setzt den Wert auf false. Damit werden alle Jahresgrenzen eindeutig behandelt. days_remaining ist die exakte Differenz gregorianischer Kalendertage und keine Zeitspanne zwischen lokalen Uhrzeiten; Sommerzeit und UTC-Verschiebungen verändern das Ergebnis nicht. next_birthday bleibt im Format YYYY-MM-DD, während turning_age das an diesem Termin erreichte Alter bezeichnet, nicht das Alter bei der Abfrage. Die Felder eignen sich für eine lesbare Anzeige und ein normalisiertes Zieldatum. Jede API-Anfrage verarbeitet ein Datumspaar für $0.002; im Browser läuft dieselbe reine Logik.

Wenden Sie die Regel für den 29. Februar einheitlich an

Eine Geburt am 29. Februar braucht eine feste Regel, weil dieses Datum in den meisten Jahren fehlt. Der Rechner nimmt in gewöhnlichen Jahren den 28. Februar als beobachteten Geburtstag und in Schaltjahren den 29. Februar. Dieselbe Regel gilt für Vergleich, Auswahl, Resttage und Alter, sodass keine unterschiedlichen Annahmen vermischt werden. Dies ist eine praktische Countdown-Konvention und keine Aussage über Volljährigkeit, Leistungen, Verträge oder persönliche Wünsche. Gesetze und Bräuche können den 28. Februar, den 1. März oder eine andere Definition vorsehen. Verwenden Sie bei amtlichen Fristen die jeweils maßgebliche Vorschrift. Unterstützt werden die Jahre 0001 bis 9999. Ein später Stichtag im Jahr 9999 kann abgelehnt werden, wenn der nächste Geburtstag das nicht vierstellig darstellbare Jahr 10000 erfordern würde.

Anwendungsfälle

Eine Geburtstagserinnerung erstellen

Wandeln Sie Geburtsdatum und Ausführungstag in einen genauen Countdown und ein normalisiertes Zieldatum um.

Die nächste Feier planen

Prüfen Sie, ob der Geburtstag dieses Jahr noch bevorsteht oder ins Folgejahr fällt.

Datumssoftware testen

Erzeugen Sie reproduzierbare Ergebnisse für den Geburtstag selbst, Jahreswechsel und Schalttage ohne Systemuhr.

Häufige Fragen

Ergibt ein heutiger Geburtstag null Tage?

Ja. Das Ergebnis nennt null Tage und behält den Stichtag als nächsten Geburtstag bei.

Was geschieht, wenn der Geburtstag schon vorbei ist?

Der Termin im Folgejahr wird gewählt und occurs_this_year liefert false.

Wie wird der 29. Februar in einem gewöhnlichen Jahr behandelt?

Wenn es keinen 29. Februar gibt, gilt der 28. Februar als beobachteter Geburtstag.

Kann die Zeitzone den Countdown verändern?

Nein. Die Berechnung verwendet ganzzahlige gregorianische Arithmetik und erzeugt keine Zeitstempel.

Was kostet eine API-Anfrage?

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

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/next-birthday-countdown

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/next-birthday-countdown \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth_date":"1990-10-20","reference_date":"2026-08-12"}'

const res = await fetch("https://api.kit.forhosting.com/date/next-birthday-countdown", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "birth_date": "1990-10-20",
    "reference_date": "2026-08-12"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/next-birthday-countdown",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "birth_date": "1990-10-20",
    "reference_date": "2026-08-12"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/next-birthday-countdown", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"birth_date":"1990-10-20","reference_date":"2026-08-12"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"birth_date":"1990-10-20","reference_date":"2026-08-12"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/next-birthday-countdown", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "birth_date": "1990-10-20",
  "reference_date": "2026-08-12"
}

Beispiel-Antwort

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