Die Methode Date.prototype.setMinutes() setzt die Minuten eines Date-Objekts in der lokalen Zeitzone. Optional können Sekunden und Millisekunden in einem einzigen Aufruf festgelegt werden – ideal, um eine vollständige Sub-Stunden-Zeit atomar zu setzen. Werte außerhalb von 0–59 werden automatisch in Stunden umgerechnet, sodass das Date-Objekt konsistent bleibt – ein eleganter Weg für Minutenarithmetik.
Funktionsweise
Werte außerhalb von 0–59 führen zu einem Stunden- oder Tagesüberlauf. Die Methode mutiert die Date-Instanz und gibt zusätzlich den neuen Zeitstempel zurück.
setMinutes(60): +1 Stunde, 0 Minuten.setMinutes(-15): Stunde davor, 45 Minuten.setMinutes(75, 30): +1 Stunde, 15 Minuten, 30 Sekunden.
Syntax
date.setMinutes(minutesValue)
date.setMinutes(minutesValue, secondsValue)
date.setMinutes(minutesValue, secondsValue, msValue)minutesValue Eine Ganzzahl von 0 bis 59, die die neue Minute angibt.
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
Minuten setzen
const date = new Date("2026-05-01T10:00:00");
date.setMinutes(45);
console.log(date.toLocaleTimeString("de-DE"));10:45:00Stundenüberlauf
const date = new Date("2026-05-01T10:00:00");
date.setMinutes(75);
console.log(date.toLocaleTimeString("de-DE"));11:15:00Minuten und Sekunden zusammen setzen
const date = new Date("2026-05-01T10:00:00");
date.setMinutes(30, 45);
console.log(date.toLocaleTimeString("de-DE"));10:30:45Auf nächste Viertelstunde aufrunden
function rundeAufViertelstundeAuf(date) {
const result = new Date(date);
const min = result.getMinutes();
const restanteil = min % 15;
const aufrunden = restanteil === 0 ? 0 : 15 - restanteil;
result.setMinutes(min + aufrunden, 0, 0);
return result;
}
console.log(rundeAufViertelstundeAuf(new Date("2026-05-01T10:08:00")).toLocaleTimeString("de-DE"));
console.log(rundeAufViertelstundeAuf(new Date("2026-05-01T10:00:00")).toLocaleTimeString("de-DE"));10:15:00
10:00:00Minuten subtrahieren
const date = new Date("2026-05-01T10:30:00");
date.setMinutes(date.getMinutes() - 45);
console.log(date.toLocaleTimeString("de-DE"));09:45:00Hinweise & verwandte Methoden
- Für die UTC-Variante:
Date.prototype.setUTCMinutes(). - Bei der Berechnung „in N Minuten” ist
setMinutes(getMinutes() + N)das idiomatische Muster und behandelt Stunden- und Tagesüberläufe korrekt. - Sommerzeit-Übergänge können in seltenen Fällen zu unerwartetem Verhalten führen – für solche Fälle ist UTC sicherer.
- Die Methode mutiert das Original.