Ankunftszeit-Rechner (lokal)

Der Pfad ist vollständig deterministisch: keine Netzwerkanrufe, keine IANA-Zonendatenbank und kein Date-Objekt, sodass Hausaufgabenprüfer, Itinerar-Generatoren und vorausbezahlte API-Clients jedes Mal dasselbe JSON erhalten. Ungültige Uhrzeichenketten wie fünfundzwanzig Uhr oder sechzig Minuten nach der vollen Stunde scheitern mit einem klaren invalid_input-Fehler und werden nicht berechnet.

Eingaben: Abfluguhr, Dauer und UTC-Offsets

Die Engine lehnt unmögliche Uhren ab — Stunden außerhalb von null bis dreiundzwanzig, Minuten oder Sekunden außerhalb von null bis neunundfünfzig, oder Freitext, der keine Uhr ist —, sodass Tippfehler nie stillschweigend in einen anderen Tag umschlagen. UTC-Offsets von Start und Ziel sind Stunden zur koordinierten Weltzeit: negativ westlich von Greenwich, positiv östlich, einschließlich Halbstundenzonen wie 5.5 oder der Zeichenkettenform plus null fünf Doppelpunkt dreißig. Offsets müssen zwischen minus vierzehn und plus vierzehn Stunden liegen, dem praktischen Spann der zivilen Zeitzonen. Senden Sie departure_time als vierundzwanzigstündige Ortsuhrzeichenkette HH:MM oder HH:MM:SS am Abflughafen oder in der Abflugstadt. Drücken Sie die Flugdauer mit duration_minutes in ganzen Minuten, mit duration_hours in Stunden (Bruchwerte wie 8.5 werden auf die nächste Minute gerundet) oder mit duration als H:MM-Zeichenkette aus, etwa acht Doppelpunkt null null für acht Stunden. Aliasse wie departure_local_time, origin_offset und dest_offset werden akzeptiert, damit Formulare und SDK-Demos natürliche Feldnamen ohne Neuabbildung nutzen können. Fehlende Dauer oder fehlender Offset ist invalid_input. Dieses Produkt löst absichtlich keine Namen wie America/New_York auf; Sie liefern den Offset, der am Reisetag gilt, damit das Ergebnis offline, reproduzierbar und frei von Sommerzeit-Überraschungen mitten in der Anfrage bleibt.

So werden lokale Ankunftszeit und day_offset berechnet

Diese Größe wird in eine Vierundzwanzig-Stunden-Uhr und einen ganzzahligen day_offset gefaltet: null bedeutet, dass der Kalendertag am Ziel unter diesem reinen Offset-Modell dem Abflugkalendertag entspricht; eins bedeutet den nächsten Tag; negative Werte bedeuten den Vortag bei westwärts ultralangen oder offset-lastigen Teilstrecken. Die Antwort spiegelt departure_time, duration_minutes, duration_hours, beide Offsets, arrival_time und arrival_local_time als nullauffülltes HH:MM, day_offset, ein kurzes day_offset_label wie same_day oder next_day, die Formelzeichenkette und method utc_offset_minute_arithmetic wider. Beispiel: Start um vierzehn Uhr dreißig von UTC minus fünf, acht Stunden Flug nach UTC plus null, Landung um null drei dreißig mit day_offset eins. Die Dauer ist auf sieben Tage in Minuten begrenzt, damit Worker-Isolate begrenzt bleiben; längere mehrwöchige Summen sollten außerhalb dieses Rechners aufgeteilt werden.

API-Nutzung, Preise, Itinerare und praktische Grenzen

Senden Sie einen JSON-Körper mit der erforderlichen Abfluguhr, einem Dauerfeld und beiden UTC-Offsets. Nutzen Sie die vorausbezahlte API, wenn ein Reisebürowerkzeug, ein Packlisten-Generator, ein Mehrstädte-Reisebauer oder ein Unterrichtsblatt einen stabilen Vertrag unter KIT-Guthaben zu $0.002 pro erfolgreichem Element braucht; Validierungsfehler verbrauchen nie Guthaben, nachdem die Engine die Anfrage abgelehnt hat. Autoren, die SDKs ausliefern, können arrival_time und day_offset direkt in Itinerarkarten abbilden, die «landet morgen um 03:30 Ortszeit» zeigen, ohne eine vollständige Zonendatenbank im Client einzubetten.