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

JavaScript Syntax
date.setUTCMinutes(minutesValue)
date.setUTCMinutes(minutesValue, secondsValue)
date.setUTCMinutes(minutesValue, secondsValue, msValue)
Parameter
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

JavaScript Beispiel
const date = new Date("2026-05-01T10:00:00Z");
date.setUTCMinutes(45);
console.log(date.toISOString());
Output
2026-05-01T10:45:00.000Z

Stundenüberlauf in UTC

JavaScript Beispiel
const date = new Date("2026-05-01T10:00:00Z");
date.setUTCMinutes(75);
console.log(date.toISOString());
Output
2026-05-01T11:15:00.000Z

Minuten und Sekunden zusammen setzen

JavaScript Beispiel
const date = new Date("2026-05-01T10:00:00Z");
date.setUTCMinutes(30, 45);
console.log(date.toISOString());
Output
2026-05-01T10:30:45.000Z

Stunden-Anfang in UTC

JavaScript Beispiel
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());
Output
2026-05-01T10:00:00.000Z

Hinweise & 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.
/ Weiter

Zurück zu Date

Zur Übersicht