Die Methode Date.prototype.getUTCMinutes() gibt die Minuten-Komponente eines Date-Objekts in der koordinierten Weltzeit (UTC) zurück. Der Wert liegt zwischen 0 und 59. Anders als bei getUTCMilliseconds(), wo der Unterschied zur lokalen Variante praktisch nie spürbar ist, kann getUTCMinutes() durchaus von getMinutes() abweichen – nämlich in Zeitzonen mit halb- oder viertelstündlichem Offset wie Indien, Iran, Nepal, Afghanistan oder Neufundland.
Funktionsweise
Da die meisten Zeitzonen Stunden-Offsets verwenden, stimmt der Wert in der Regel mit getMinutes() überein. Es gibt jedoch Zonen mit nicht-stündlichem Versatz:
- UTC+5:30 – Indien (IST)
- UTC+5:45 – Nepal (NPT)
- UTC+3:30 – Iran (IRST)
- UTC+4:30 – Afghanistan (AFT)
- UTC-3:30 – Neufundland (NST)
- UTC+9:30 – Teile Australiens (ACST)
In diesen Regionen weicht getUTCMinutes() von getMinutes() ab. Das ist ein Klassiker bei internationalisierten Anwendungen und einer der häufigsten Bugs bei Termine-Apps.
Syntax
date.getUTCMinutes()Die Methode erwartet keine Parameter.
Rückgabewert
Eine Ganzzahl zwischen 0 und 59, die die Minute in UTC repräsentiert. Bei einem ungültigen Datum wird NaN zurückgegeben.
Beispiele
Minuten in UTC ermitteln
const date = new Date("2026-05-01T14:30:00Z");
console.log(date.getUTCMinutes());30Differenz bei nicht-stündlichen Zeitzonen
// 14:30 Uhr in Indien (UTC+5:30)
const date = new Date("2026-05-01T14:30:00+05:30");
console.log(`Lokal: ${date.getMinutes()}`);
console.log(`UTC: ${date.getUTCMinutes()}`);Lokal: 30
UTC: 0UTC-Zeit als HH:MM formatieren
function formatUtcZeit(date) {
const hh = String(date.getUTCHours()).padStart(2, "0");
const mm = String(date.getUTCMinutes()).padStart(2, "0");
return `${hh}:${mm} UTC`;
}
console.log(formatUtcZeit(new Date("2026-05-01T09:05:00Z")));09:05 UTCCron-ähnliche Trigger auf bestimmte Minutenwerte
function istVolleViertelstundeUTC(date) {
return date.getUTCMinutes() % 15 === 0;
}
console.log(istVolleViertelstundeUTC(new Date("2026-05-01T14:00:00Z")));
console.log(istVolleViertelstundeUTC(new Date("2026-05-01T14:15:00Z")));
console.log(istVolleViertelstundeUTC(new Date("2026-05-01T14:23:00Z")));true
true
falseHinweise & verwandte Methoden
- Für die lokale Variante:
Date.prototype.getMinutes(). In Zonen mit nicht-stündlichem Offset weichen die Werte ab. - Zum Setzen:
Date.prototype.setUTCMinutes()– kann optional Sekunden und Millisekunden gleichzeitig setzen. - Bei Cron-Jobs und zeitbasierten Triggern in Server-Anwendungen sollte konsequent in UTC gerechnet werden.
- Für die Berechnung von Zeitdifferenzen niemals Minutenwerte direkt subtrahieren – stattdessen
getTime()verwenden.