ForHosting KIT · Entwickler-Tools

Ortszeit aus UTC-Offset berechnen

Der Rechner für Ortszeit aus einem UTC-Offset wandelt eine bekannte UTC-Uhrzeit in die entsprechende Uhrzeit einer Stadt um, wenn Ihnen deren fester Offset bereits vorliegt.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Geben Sie UTC-Zeit, Stadtbezeichnung sowie vorzeichenbehaftete Stunden und Minuten ein. Das Ergebnis nennt die Ortszeit und zeigt, ob sie auf den vorherigen, denselben oder nächsten Kalendertag fällt. Zeitzonensuche, Netzwerk, Systemuhr und Annahmen zur Sommerzeit beeinflussen die Berechnung nicht.

UTC-Referenzzeit und Stadt eingeben

Beginnen Sie mit einer Uhrzeit in koordinierter Weltzeit und verwenden Sie strikt das 24-Stunden-Format HH:MM. Mitternacht ist 00:00, Mittag ist 12:00 und die letzte gültige Minute ist 23:59. Das Stadtfeld kennzeichnet lediglich das Ergebnis und löst keine geografische Suche aus. Wenn Sie beispielsweise Kathmandu eingeben, fragt der Rechner keinen Zeitzonendienst ab und entscheidet nicht, welcher Offset derzeit gilt. Den für Datum und Situation zutreffenden Offset müssen Sie selbst bereitstellen. Diese Trennung ist wichtig, weil Städte Sommerzeit anwenden können, Behörden Regeln ändern und historische Offsets von heutigen Werten abweichen können. Ermitteln Sie den geltenden Offset aus einer verlässlichen Quelle und kombinieren Sie ihn anschließend mit der UTC-Zeit. Das strenge Format verhindert mehrdeutige Angaben; die Stadtbezeichnung macht das Ergebnis in Zeitplänen, Berichten und Anzeigen verständlich, ohne eine geprüfte geografische Zuordnung vorzutäuschen.

Vorzeichenbehaftete UTC-Offsetteile angeben

Tragen Sie ganze Stunden in offset_hours und die verbleibenden Minuten in offset_minutes ein. Positive Werte stehen für eine Uhr vor UTC, negative Werte für eine Uhr hinter UTC. +05:45 wird mit 5 Stunden und 45 Minuten dargestellt; -03:30 mit -3 Stunden und -30 Minuten. Beide von null verschiedenen Teile müssen dasselbe Vorzeichen haben. Für einen negativen Offset unter einer Stunde verwenden Sie null Stunden und negative Minuten. Der zulässige Gesamtbereich reicht von -12:00 bis +14:00. Minuten müssen ganze Zahlen zwischen -59 und 59 sein; Bruchteile oder übergroße Werte werden weder gerundet noch stillschweigend übertragen. Nach der Prüfung wandelt der Rechner den vollständigen Offset in vorzeichenbehaftete Minuten um und addiert ihn zu den Minuten seit UTC-Mitternacht. So lassen sich Halb- und Viertelstunden-Offsets ohne ungenaue Dezimalstunden zuverlässig verarbeiten.

Ortszeit und Tageswechsel auswerten

local_time enthält die umgerechnete Uhrzeit im nullaufgefüllten 24-Stunden-Format HH:MM. day_offset beschreibt die Beziehung zum Kalendertag der UTC-Referenz: -1 bedeutet Vortag, 0 denselben Tag und 1 Folgetag. Ein positiver Offset kann spät am Tag Mitternacht überschreiten; ein negativer Offset kurz nach UTC-Mitternacht kann zum Vortag führen. Da kein Datum eingegeben wird, erfindet der Rechner weder Monat noch Wochentag oder neues Datum. Wenden Sie day_offset mit einer geeigneten Kalenderbibliothek auf Ihr bekanntes Datum an. Die Antwort enthält Stadt, beide Uhrzeiten und die Offsetteile, sodass die Rechnung nachvollziehbar bleibt. Der Algorithmus arbeitet ausschließlich mit begrenzten Ganzzahlen und ist unabhängig von Gebietsschema, Rechnerzeitzone und aktueller Uhrzeit. Ungültige Eingaben führen zu einem typisierten Fehler. Die API-Nutzung kostet $0.002 pro Anfrage; dieselbe reine Logik kann auch im Browser ausgeführt werden.

Anwendungsfälle

Eine Online-Besprechung planen

Wandeln Sie einen vereinbarten UTC-Termin mit bekanntem Offset in die Uhrzeit am Standort eines Teilnehmers um.

Einen Reiseplan erstellen

Zeigen Sie die Zielzeit an und bewahren Sie den Hinweis zum Tageswechsel in einem Plan aus UTC-Daten.

Betriebsanzeigen vereinheitlichen

Wandeln Sie UTC-Ereigniszeiten in feste städtische Offsetanzeigen um, ohne von der Serverzeitzone abzuhängen.

Häufige Fragen

Ermittelt der Rechner den aktuellen UTC-Offset einer Stadt?

Nein. Sie geben den Offset vor; die Stadt ist lediglich eine beschreibende Kennzeichnung des Ergebnisses.

Berücksichtigt er die Sommerzeit?

Nein. Geben Sie nach Prüfung saisonaler Regeln den für Ort und Datum geltenden festen Offset ein.

Wie wird UTC-03:30 eingegeben?

Verwenden Sie -3 für offset_hours und -30 für offset_minutes, damit beide Teile eine Lage hinter UTC ausdrücken.

Was bedeutet day_offset?

Der Wert ist -1 für den Vortag, 0 für denselben Tag oder 1 für den Folgetag relativ zur UTC-Referenz.

Was kostet eine API-Anfrage?

Jede API-Anfrage kostet $0.002. Die deterministische Berechnung kann ebenfalls direkt im Browser laufen.

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/local-time-from-offset

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/local-time-from-offset \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}'

const res = await fetch("https://api.kit.forhosting.com/date/local-time-from-offset", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "utc_time": "18:45",
    "city": "Kathmandu",
    "offset_hours": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/local-time-from-offset",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "utc_time": "18:45",
    "city": "Kathmandu",
    "offset_hours": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/local-time-from-offset", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/local-time-from-offset", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "utc_time": "18:45",
  "city": "Kathmandu",
  "offset_hours": 5
}

Beispiel-Antwort

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