ForHosting KIT · Datum und Zeit

Genäherte Zeitgleichung

Am 11. Februar 2024, dem 42. Tag des Jahres, geht eine Sonnenuhr rund vierzehneinhalb Minuten gegenüber einer mittleren Uhr nach. Geben Sie ein Datum ein und erhalten Sie die genäherte Zeitgleichung in Minuten: positiv, wenn die Sonnenuhr vorgeht, negativ, wenn sie nachgeht. 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: 2024-02-11

Erhalten Sie

Jahr: 2.024
Monat: 2
Tag: 11
Tag des Jahres: 42

Die Zeitgleichung sind die Minuten, die eine Sonnenuhranzeige von einer gleichmäßigen mittleren Uhr auf demselben Meridian trennen. Sie entsteht, weil die Erdbahn leicht elliptisch ist und die Achse geneigt ist, sodass der wahre Sonnenmittag dem bürgerlichen Mittag im Jahreslauf um bis zu etwa sechzehn Minuten vorauseilt oder hinterherhinkt. Konstrukteure von Sonnenuhren, Solartrackern und Lehrmodulen brauchen für einen gewählten Kalendertag eine reproduzierbare Zahl, ohne einen Ephemeridendienst aufzurufen. Dieser Näherungsrechner zur Zeitgleichung akzeptiert ein einzelnes ISO-Datum im Format YYYY-MM-DD, wandelt es nach proleptischen gregorianischen Schaltregeln in den Jahrestag um und wertet die klassische Dreitermformel aus solartechnischen Lehrbüchern aus. Die Berechnung ist rein und deterministisch im UTC-Kalenderraum allein aus dem Eingabedatum — ohne Netz, ohne Zufall und ohne Abhängigkeit von der Host-Systemuhr.

Bedeutung der Zeitgleichung und die Dreiterm-Näherung

Die wahre Sonnenzeit ist, was eine korrekt ausgerichtete Sonnenuhr zeigt: den Stundenwinkel der wahren Sonne. Die mittlere Sonnenzeit ist der gleichmäßige Vierundzwanzig-Stunden-Tag bürgerlicher Uhren auf derselben Länge. Ihre Differenz ist die Zeitgleichung.

Über ein Jahr schwingt der Offset von etwa minus vierzehn Minuten (Sonnenuhr nachgehend, oft Mitte Februar) bis etwa plus sechzehn Minuten (Sonnenuhr vorgehend, oft Anfang November), mit Nullstellen nahe Mitte April, Mitte Juni, Anfang September und Ende Dezember je nach Modell. Diese Fähigkeit setzt die weit unterrichtete Dreiterm-Näherung um: E gleich 9.87 mal sin von 2B minus 7.53 mal cos von B minus 1.5 mal sin von B, wobei B zwei pi geteilt durch dreihundertfünfundsechzig mal N minus einundachtzig ist und N der Jahrestag mit dem 1.

Januar gleich eins ist. Der einundachtzig-Tage-Versatz verankert die Phase nahe der März-Äquinoktiumsregion der klassischen Formel. Die Näherung ist absichtlich einfach: sie enthält weder orbitale Reihen höherer Ordnung noch Nutation, genügt aber für Sonnenuhr-Layout, Unterrichtskontrollen und Sonnenmittag-Schätzungen, die nur Minuten-Genauigkeit brauchen.

Schaltjahre speisen weiterhin den echten Kalendertag in N über gregorianische Regeln, während die Winkelperiode wie im Lehrbuchmodell bei dreihundertfünfundsechzig bleibt. Vorzeichenkonvention Sonnenuhr minus Uhr: eine positive Zeitgleichung bedeutet, dass der wahre Sonnenmittag vor dem mittleren Mittag eintritt; Sie subtrahieren also E Minuten von der Sonnenuhr, um die mittlere Zeit zu treffen, oder addieren E zur mittleren Zeit, um die Sonnenuhrzeit zu schätzen.

Wo sich die Zeitgleichung im Alltag lohnt

Sonnenuhrbauer und Vermittler an Kulturerbestätten nutzen einen Zeitgleichung-Rechner, damit Besucher verstehen, warum Mittag auf der Scheibe nicht immer zwölf auf der Armbanduhr ist. Solarinstallateure schätzen den wahren Sonnenmittag für Azimutprüfungen von Panels, ohne eine volle planetare Ephemeride aufzubauen. Dokumentationsseiten, die für genäherte Zeitgleichung ranken, profitieren von einem kostenlosen Browserpfad, dessen reines Modul bytegenau mit dem bezahlten Automatisierungspfad übereinstimmt.

Weil die Implementierung analytische Parse-Mathematik der Stufe A ist, bleibt die Worst-Case-Latenz vernachlässigbar, und fehlgeschlagene Validierung wird nicht berechnet.

Anwendungsfälle

Sonnenuhr-Entwurf und Deutung

Wandeln Sie ein gewähltes ISO-Datum in Minuten Sonnenuhr-versus-Uhr-Offset um, damit gravierte Korrekturtabellen und Besucherschilder zum Dreiterm-Modell passen.

Unterricht und LMS-Autokorrektur

Bewerten Sie Zeitgleichungs-Hausaufgaben mit einem deterministischen Orakel, das ungültige Daten ablehnt und für dasselbe YYYY-MM-DD stets dieselben Minuten liefert.

Häufige Fragen

Was bedeutet eine positive Zeitgleichung?

Positives E bedeutet, dass die Sonnenuhr (wahre Sonnenzeit) der mittleren Uhr voraus ist. Negatives E bedeutet, dass die Sonnenuhr hinterherhinkt.

Nutzt der Rechner meine lokale Zeitzone?

Nein. Die Eingabe ist nur ein Kalenderdatum (UTC-Tageslabel). Länge und zivile Zonenoffsets werden nicht angewendet; fügen Sie sie selbst hinzu, wenn Sie den lokalen Sonnenmittag brauchen.

Wie rechne ich eine Sonnenuhrablesung in Uhrzeit um?

Ziehen Sie die Zeitgleichung von der Sonnenuhrablesung ab. Am 11. Februar 2024 ist der Wert negativ, rund vierzehneinhalb Minuten, also addieren Sie diesen Betrag zur Anzeige der Sonnenuhr, um die mittlere Zeit zu erhalten.

Wann im Jahr ist der Unterschied am größten?

Etwa vierzehn Minuten Nachgang um Mitte Februar und sechzehn Minuten Vorgang Anfang November. Sonnenuhr und Uhr stimmen ungefähr Mitte April, Mitte Juni, Anfang September und Ende Dezember überein.

Wie genau ist die Dreiterm-Näherung?

Sie lässt Bahnterme höherer Ordnung und die Nutation weg und ist deshalb eine Orientierung auf die Minute, keine exakte Ephemeride. Für den Entwurf einer Sonnenuhr, Übungen im Unterricht oder die Schätzung des Sonnenmittags reicht das.

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/equation-of-time-approx

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/equation-of-time-approx \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-02-11"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/equation-of-time-approx",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-02-11"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2024-02-11"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/equation-of-time-approx", 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-02-11"
}

Beispiel-Antwort

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

Das Ergebnis ist equation_of_time_min (identisch mit sundial_minus_clock_min): positiv, wenn die Sonnenuhr der mittleren Uhr voraus ist, negativ, wenn sie hinterherhinkt.

Eingangsvertrag, Antwortfelder und Validierungsfehler

Aliase iso, day und d werden für dasselbe Feld akzeptiert. Der gültige Jahresbereich ist 0001 bis 9999 unter proleptischen gregorianischen Schaltregeln (Februar hat neunundzwanzig Tage, wenn das Jahr durch vier, aber nicht durch hundert teilbar ist, es sei denn auch durch vierhundert). Kombinieren Sie die Minuten mit Ihrer eigenen Längenkorrektur (vier Minuten pro Längengrad vom Standardmeridian), wenn Sie den lokalen Sonnenmittag gegen eine Zonenuhr brauchen; dieser Endpunkt liefert nur den Zeitgleichungsteil. Senden Sie per POST ein JSON-Objekt mit dem Pflicht-Stringfeld date im strengen ISO-Format YYYY-MM-DD — vierstellige Jahreszahl, zweistelliger Monat und Tag, ohne Zeitkomponente und ohne Zeitzonen-Suffix. Das Datum gilt nur als UTC-Kalendertag-Label; Länge und zivile Ortsoffsets liegen außerhalb des Umfangs. Nicht-Strings, fehlende Werte, leere Strings, falsche Formen wie 2024/02/11 und unmögliche Kalendertage wie 2023-02-29 scheitern mit invalid_input und werden nicht berechnet. Bei Erfolg spiegelt der Body date, year, month, day, day_of_year und is_leap_year wider; liefert equation_of_time_min und das identische sundial_minus_clock_min gerundet für stabile Goldens über Runtimes; enthält b_rad (den Zwischenwinkel B in Radiant); und liefert formula, method gleich three_term_approx sowie eine kurze sign_note. Beispielablauf: senden Sie date 2024-02-11, erhalten Sie day_of_year zweiundvierzig und eine negative Zeitgleichung nahe dem Februar-Extrem (Sonnenuhr hinter der mittleren Uhr), geeignet zum Anpassen einer horizontalen Sonnenuhrablesung an die mittlere Zeit.

Wo eine API zur genäherten Zeitgleichung sich lohnt

Unterrichtslabore und MOOC-Autokorrektoren brauchen ein deterministisches Orakel, das dasselbe ISO-Datum immer denselben Minuten zuordnet, einschließlich Jahrestagsverschiebungen an Schalttagen, sodass Arbeitsblätter und API-Prüfungen nie abweichen. Automatisierungsskripte, die Fotos oder Protokolle mit Sonnenzeit annotieren, können die vorausbezahlte API zum veröffentlichten Basispreis $0.002 pro erfolgreichem Element aufrufen — ohne Modell-Token und ohne ausgehendes Netz vom Worker. Halten Sie die Anfrage auf ein einzelnes Kalenderdatum, pinnen Sie gerundetes equation_of_time_min in Tests, und Sie erhalten reproduzierbare Sonnenuhr-zu-Uhr-Offsets für Bildung, Produkt-UX und Edge-Worker, ohne eigene Astronomie-Bibliotheken einzubetten.

Integrationsbeispiele

Sonnenmittag-Schätzungen für Installateure

Kombinieren Sie equation_of_time_min mit Minuten Länge-vom-Meridian, um den lokalen wahren Sonnenmittag gegen eine Zonenuhr ohne Ephemeridendienst zu schätzen.

Technische Fragen

Wie berechne ich die genäherte Zeitgleichung für ein Datum?

Senden Sie {"date":"YYYY-MM-DD"}. Die API liefert equation_of_time_min (und sundial_minus_clock_min) aus E=9.87·sin(2B)−7.53·cos(B)−1.5·sin(B) mit B=2π/365·(N−81) und N=Jahrestag.

Welche Daten werden abgelehnt?

Fehlendes oder nicht-string date, Formen außer YYYY-MM-DD, Jahre außerhalb 0001–9999 und unmögliche Tage wie 2023-02-29 scheitern mit invalid_input und werden nicht berechnet.

Was kostet der Näherungsrechner zur Zeitgleichung?

Das Browser-Werkzeug ist kostenlos. API-Anfragen nutzen vorausbezahltes KIT-Guthaben zu $0.002 pro erfolgreichem Aufruf; ungültige Eingabe wird nicht berechnet.

Vollständige KIT-Dokumentation lesen →