ForHosting KIT · Entwickler-Tools

Mondphase für ein beliebiges Datum schätzen

Dieser Rechner wandelt ein Kalenderdatum in eine verständliche Beschreibung des Mondzyklus um, etwa Neumond, zunehmende Sichel, erstes Viertel, Vollmond oder abnehmende Sichel.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Zusätzlich nennt er das ungefähre Mondalter, den beleuchteten Anteil und die Zyklusposition. Die deterministische Berechnung verwendet einen mittleren synodischen Monat ab einem bekannten Referenzneumond. Sie benötigt weder Standort noch Netzwerkzugriff, Astronomiedienst oder gespeicherte Nutzerdaten und eignet sich daher für schnelle Planungen und reproduzierbare Softwareabläufe.

Geben Sie ein vollständiges gregorianisches Datum ein

Tragen Sie das Datum genau im Format JJJJ-MM-TT ein und verwenden Sie bei einstelligen Monaten oder Tagen eine führende Null. Der 8. April 2024 wird beispielsweise als 2024-04-08 geschrieben. Der Rechner prüft den tatsächlichen gregorianischen Kalender und nicht nur die Textform; unmögliche Angaben wie der 30. Februar werden deshalb abgelehnt. Für Schaltjahre gilt die übliche Teilbarkeit durch vier mit der Jahrhundertausnahme und der Vierhundertjahrkorrektur. Die Berechnung wertet das gewünschte Kalenderdatum um 12 Uhr koordinierter Weltzeit aus. Dadurch erhält jeder Tag einen einheitlichen Bezugspunkt und das Ergebnis hängt nicht unbemerkt von der lokalen Zeitzone des Computers ab. Unterstützt werden die vierstellig dargestellten Jahre 0001 bis 9999. Umgangssprachliche Angaben, regionale Datumsreihenfolgen, Zeitstempel oder Zeitzonenzusätze werden nicht verarbeitet. Wandeln Sie solche Werte vor dem Aufruf in das dokumentierte Format um. Die strenge Eingabe sorgt für wiederholbare API-Aufrufe und verhindert, dass ein mehrdeutiges Datum wie 03/04/2025 auf verschiedenen Systemen unterschiedlich verstanden wird.

Verstehen Sie die Berechnung der Schätzung

Das Verfahren beginnt mit einem bekannten Neumond am 6. Januar 2000 um 18:14 UTC und wandelt das angeforderte Datum in eine julianische Tageszahl um. Anschließend bestimmt es die seit diesem Bezugspunkt verstrichene Zeit und ordnet sie in einen mittleren synodischen Monat von 29.530588853 Tagen ein. Die Position innerhalb dieses wiederkehrenden Intervalls ist der Zyklusanteil; der bereits verstrichene Abschnitt wird als Mondalter in Tagen ausgegeben. Acht geläufige Bezeichnungen teilen den Zyklus in gleich große Winkelbereiche, die um Neumond, erstes Viertel, Vollmond und letztes Viertel zentriert sind. Eine Kosinuskurve schätzt die Beleuchtung: Sie beginnt bei Neumond nahe null Prozent, steigt um Vollmond gegen hundert Prozent und fällt in der abnehmenden Hälfte wieder. Die Werte werden stabil und zweckmäßig gerundet. Dies ist ein kompaktes Rechenmodell und keine Ephemeride. Da die tatsächliche Mondbahn schwankt, kann eine genaue astronomische Beobachtung um mehrere Stunden abweichen und nahe einer Phasengrenze die benachbarte Bezeichnung ergeben.

Nutzen Sie das Ergebnis mit angemessener Genauigkeit

Verwenden Sie diese Funktion, wenn eine schnelle und reproduzierbare Schätzung wichtiger ist als ein observatoriumsgenauer Zeitpunkt. Kalender können neben Terminen eine verständliche Mondphase anzeigen, Lernprojekte den wiederkehrenden Zyklus veranschaulichen und Planungshilfen eine grobe Einschätzung der nächtlichen Helligkeit liefern. Das Phasenfeld ist für eine lesbare Kategorie gedacht. Mondalter und Zyklusanteil eignen sich besser zum Sortieren, für visuelle Anzeigen oder zum Vergleich naher Daten; illumination_percent vermittelt eine anschauliche Helligkeitsschätzung. Weil der Algorithmus nur ein Datum erhält, berechnet er weder Mondaufgang noch Monduntergang, Höhe, Azimut, Finsternisse, örtliche Sichtbarkeit, Wetter oder die scheinbare Ausrichtung der beleuchteten Seite. Dafür wären geografische Koordinaten, eine genaue Uhrzeit und detailliertere Bahndaten nötig. Nutzen Sie die Schätzung nicht für Navigation, Sicherheitsentscheidungen, wissenschaftliche Veröffentlichungen, religiöse Festlegungen mit vorgeschriebener Beobachtung oder Ereignisse, die vom exakten Phasenzeitpunkt abhängen. Für gewöhnliche Datumsabfragen und grafische Elemente in Anwendungen ist sie jedoch transparent, günstig und bei jedem Lauf identisch. Im Browser ist kein Serveraufruf nötig; automatisierte API-Anfragen kosten jeweils $0.002.

Eine Mondphase im Kalender anzeigen

Zeigen Sie neben Terminen eine ungefähre Phase an, ohne einen externen Astronomiedienst aufzurufen.

Nächtliche Freizeitfotografie planen

Vergleichen Sie Daten nach geschätzter Beleuchtung, bevor Sie örtliche Zeiten und Wetter prüfen.

Den Mondzyklus vermitteln

Erzeugen Sie wiederholbare Beispiele für zunehmende, volle und abnehmende Phasen im Unterricht.

Wie genau ist die Phasenschätzung?

Sie eignet sich für allgemeine Kalender. Da ein mittlerer Mondmonat statt vollständiger Ephemeriden verwendet wird, können genaue Zeitpunkte um mehrere Stunden abweichen.

Welche Tageszeit wird verwendet?

Die Berechnung wertet das eingegebene Datum um 12:00 UTC aus und bleibt dadurch unabhängig von der lokalen Zeitzone.

Werden Mondaufgang oder Monduntergang berechnet?

Nein. Diese Zeiten erfordern einen Standort und ein ausführlicheres astronomisches Modell.

Welches Datumsformat wird akzeptiert?

Verwenden Sie genau JJJJ-MM-TT mit einem gültigen gregorianischen Monat und Tag, zum Beispiel 2024-04-08.

Was kostet eine API-Anfrage?

Jede API-Anfrage kostet $0.002. Die Browserversion kann lokal ohne Aufruf der API ausgeführt werden.

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/misc2/moon-phase-estimate

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/misc2/moon-phase-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-04-08"}'
{
  "date": "2024-04-08"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "misc2.moon_phase_estimate",
  "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.

Vollständige KIT-Dokumentation lesen →