Die Methode Date.prototype.getUTCHours() gibt die Stunde eines Date-Objekts gemäß der koordinierten Weltzeit (UTC) zurück. Der Rückgabewert liegt zwischen 0 und 23 (24-Stunden-Format) und ist im Gegensatz zu getHours() unabhängig von der Systemzeitzone. Sie ist die richtige Wahl für Logging, Server-zu-Server-Kommunikation und überall dort, wo eine einheitliche Zeitbasis erforderlich ist – etwa in verteilten Microservices, Batch-Jobs oder Audit-Trails.
Funktionsweise
Im Unterschied zu getHours() wird die Stunde nicht in lokaler Zeit, sondern in UTC zurückgegeben. Das hat zur Folge, dass derselbe absolute Zeitpunkt überall auf der Welt denselben UTC-Stundenwert liefert. Insbesondere wird die Sommerzeit nicht berücksichtigt – UTC kennt keine Sommerzeit.
Praktischer Effekt: Auf einem Server in Berlin liefert getHours() für 2026-05-01T14:30:00Z den Wert 16 (MESZ), getUTCHours() hingegen den Wert 14.
Syntax
date.getUTCHours()Die Methode erwartet keine Parameter.
Rückgabewert
Eine Ganzzahl zwischen 0 und 23, die die Stunde in UTC repräsentiert. Bei einem ungültigen Datum wird NaN zurückgegeben.
Beispiele
UTC-Stunde auslesen
const date = new Date("2026-05-01T14:30:00Z");
console.log(date.getUTCHours());14Differenz zwischen lokaler Zeit und UTC
const date = new Date("2026-05-01T14:30:00+02:00");
console.log(`Lokal: ${date.getHours()}`);
console.log(`UTC: ${date.getUTCHours()}`);Lokal: 14
UTC: 12UTC-Logging-Format
function utcZeit(date) {
const hh = String(date.getUTCHours()).padStart(2, "0");
const mm = String(date.getUTCMinutes()).padStart(2, "0");
const ss = String(date.getUTCSeconds()).padStart(2, "0");
return `${hh}:${mm}:${ss}Z`;
}
console.log(utcZeit(new Date("2026-05-01T09:05:08Z")));09:05:08ZTagesfenster in UTC abdecken
Bei Server-seitiger Tagesabrechnung (z. B. Berichten, die einen ganzen UTC-Tag umfassen) wird die Anfangs- und Endstunde in UTC benötigt.
const von = new Date("2026-05-01T00:00:00Z");
const bis = new Date("2026-05-01T23:59:59Z");
console.log(`${von.getUTCHours()}:00 - ${bis.getUTCHours()}:59`);0:00 - 23:59Hinweise & verwandte Methoden
- Für die lokale Variante:
Date.prototype.getHours(). - Zum Setzen der UTC-Stunde:
Date.prototype.setUTCHours()– kann optional Minuten, Sekunden und Millisekunden in einem Aufruf setzen. - Bei serialisierten Datenformaten (JSON, ISO-8601) wird die Zeit standardmäßig in UTC dargestellt –
getUTCHours()ist daher die natürliche Wahl beim Parsen oder Erzeugen solcher Strings. - UTC kennt keine Sommerzeit; das macht UTC-basierte Logik deutlich robuster als zeitzonenabhängige.