GMT-Zeitversatz als verständliche Bezeichnung formatieren

Geben Sie 120 ein, erhalten Sie eine stabile Bezeichnung entsprechend GMT plus zwei. Bei angebrochenen Stunden bleiben die Minuten erhalten, negative Werte verwenden minus und null wird als GMT ausgegeben. Das Ergebnis eignet sich für Benutzeroberflächen, Berichte, barrierefreie Texte, automatisch erzeugte Nachrichten und Abläufe, die aus einem Zahlenwert eine vorhersehbare Formulierung benötigen.

Beginnen Sie mit einem vorzeichenbehafteten Minutenwert

Geben Sie die Abweichung von GMT als eine einzige ganze Minutenzahl an. Positive Zahlen stehen für eine Uhrzeit vor GMT, negative Zahlen für eine Uhrzeit hinter GMT und null für GMT selbst. So bedeutet 120 zwei Stunden voraus, während -240 vier Stunden zurück bedeutet. Minuten als Eingabe machen den Vertrag eindeutig und unterstützen auch Versätze, die nicht auf einer vollen Stunde liegen. Zulässig sind -840 bis 840 Minuten, also vierzehn Stunden zurück bis vierzehn Stunden voraus. Der Formatierer leitet keinen Versatz aus einer Stadt, einem Land, einer Abkürzung, einem Zeitstempel oder einer Geräteeinstellung ab. Diese Trennung ist beabsichtigt: Geografische Zeitzonen können sich durch Gesetze und Sommerzeitregelungen ändern, diese Funktion soll jedoch ausschließlich den genau übergebenen Zahlenwert ausdrücken. Ermitteln oder prüfen Sie daher zunächst die örtlichen Zeitregeln und übergeben Sie anschließend den endgültigen Wert mit Vorzeichen. Weil die Eingabe ausdrücklich feststeht, erzeugt derselbe Wert in jeder Umgebung immer dieselbe Bezeichnung.

So wird die verständliche Bezeichnung aufgebaut

Der Wert null liefert die kurze Bezeichnung GMT. Bei jedem anderen Wert bestimmt der Formatierer zunächst anhand des Vorzeichens plus oder minus und zerlegt anschließend den absoluten Betrag in volle Stunden und verbleibende Minuten. Bei einer vollen Stundenzahl entfällt das Wort Stunden, damit das Ergebnis kompakt bleibt: 120 wird zu GMT plus zwei und -60 zu GMT minus eins. Bleiben Minuten übrig, verdeutlichen Einheiten den Aufbau: 330 wird zu GMT plus fünf Stunden dreißig Minuten, 30 dagegen zu GMT plus dreißig Minuten. Für genau eine Stunde oder Minute wird die Einzahl verwendet; zusammengesetzte Zahlen folgen dem natürlichen deutschen Sprachgebrauch. Das zurückgegebene Objekt enthält die lesbare Bezeichnung und den ursprünglichen Versatz als offset_minutes. Die Zahl neben dem Text unterstützt Menschen und Software zugleich: Sie können die Bezeichnung anzeigen, anhand der Zahl sortieren oder vergleichen und müssen den Text nicht zurückparsen. Weder Lokalisierung noch Abkürzungssuche oder verborgene Systemeinstellungen verändern dieses Verfahren.

Nutzen Sie stabile Bezeichnungen ohne Zeitzonenbehauptung

GMT-Versätze und benannte Zeitzonen hängen zusammen, sind aber nicht austauschbar. Ein Versatz sagt lediglich, wie weit eine Uhr von GMT entfernt ist; er identifiziert keine Region und legt keine saisonalen Umstellungen fest. Verwenden Sie den Formatierer, wenn Ihre Quelle bereits einen festen Versatz enthält und Wörter verständlicher sind als eine kompakte Schreibweise wie +05:30. Geeignete Anwendungen sind barrierefreie Beschriftungen an Auswahlfeldern, gesprochene Zusammenfassungen, Prüfprotokolle, Konfigurationsvorschauen und normalisierte API-Antworten. Behaupten Sie mit dem Ergebnis nicht, eine Person befinde sich gegenwärtig in einer bestimmten Zeitzone, und verwenden Sie es nicht als Sommerzeitberechnung. Der Algorithmus stellt keine Netzwerkanfragen und liest weder Uhr, Gebietsschema, Betriebssystem noch Zeitzonendatenbank. Dadurch bleibt er in Builds, Tests, zwischengespeicherten Dokumenten und Browsern reproduzierbar. Die Automatisierung per API kostet $0.002 je Anfrage. Fehlt die Eingabe, ist sie gebrochen, nicht numerisch oder außerhalb des Bereichs, folgt ein typisierter Fehler statt einer Schätzung oder stillen Rundung.