Die Methode Date.prototype.setUTCMinutes() setzt die Minuten eines Date-Objekts in der koordinierten Weltzeit (UTC). Optional können Sekunden und Millisekunden im selben Aufruf festgelegt werden – ideal für eine atomare Setzung der UTC-Zeitangabe innerhalb einer Stunde. Werte außerhalb von 0–59 führen zu einem Stundenüberlauf in UTC.
Funktionsweise
Werte außerhalb von 0–59 führen zu einem automatischen Stunden- bzw. Tagesüberlauf in UTC. Anders als bei setMinutes() wird die lokale Zeitzone hierbei nicht berücksichtigt – die Methode arbeitet ausschließlich auf UTC-Basis.
Ein wichtiger Unterschied zu setMinutes(): In Zeitzonen mit halb- oder viertelstündlichem Offset (z. B. Indien, Iran, Nepal) liefert ein einzelnes Date-Objekt unterschiedliche Minutenwerte für getMinutes() und getUTCMinutes() – der Setter ist entsprechend zu wählen.
Syntax
date.setUTCMinutes(minutesValue)
date.setUTCMinutes(minutesValue, secondsValue)
date.setUTCMinutes(minutesValue, secondsValue, msValue)minutesValue Eine Ganzzahl von 0 bis 59.
secondsValue (Optional) Eine Ganzzahl von 0 bis 59.
msValue (Optional) Eine Ganzzahl von 0 bis 999.
Rückgabewert
Die Anzahl der Millisekunden seit dem 1. Januar 1970 UTC nach der Aktualisierung.
Beispiele
UTC-Minuten setzen
const date = new Date("2026-05-01T10:00:00Z");
date.setUTCMinutes(45);
console.log(date.toISOString());2026-05-01T10:45:00.000ZStundenüberlauf in UTC
const date = new Date("2026-05-01T10:00:00Z");
date.setUTCMinutes(75);
console.log(date.toISOString());2026-05-01T11:15:00.000ZMinuten und Sekunden zusammen setzen
const date = new Date("2026-05-01T10:00:00Z");
date.setUTCMinutes(30, 45);
console.log(date.toISOString());2026-05-01T10:30:45.000ZStunden-Anfang in UTC
function utcStundenAnfang(date) {
const result = new Date(date);
result.setUTCMinutes(0, 0, 0);
return result;
}
console.log(utcStundenAnfang(new Date("2026-05-01T10:42:13.500Z")).toISOString());2026-05-01T10:00:00.000ZHinweise & verwandte Methoden
- Für die lokale Variante:
Date.prototype.setMinutes(). - In Zonen mit nicht-stündlichem Offset weichen lokale und UTC-Minuten voneinander ab; die Wahl des richtigen Setters ist dann entscheidend.
- Für „in N Minuten in UTC”:
setUTCMinutes(getUTCMinutes() + N). - Die Methode mutiert das Original.