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

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

JavaScript Beispiel
const date = new Date("2026-05-01T10:00:00");
date.setMinutes(45);
console.log(date.toLocaleTimeString("de-DE"));
Output
10:45:00

Stundenüberlauf

JavaScript Beispiel
const date = new Date("2026-05-01T10:00:00");
date.setMinutes(75);
console.log(date.toLocaleTimeString("de-DE"));
Output
11:15:00

Minuten und Sekunden zusammen setzen

JavaScript Beispiel
const date = new Date("2026-05-01T10:00:00");
date.setMinutes(30, 45);
console.log(date.toLocaleTimeString("de-DE"));
Output
10:30:45

Auf nächste Viertelstunde aufrunden

JavaScript Beispiel
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"));
Output
10:15:00
10:00:00

Minuten subtrahieren

JavaScript Beispiel
const date = new Date("2026-05-01T10:30:00");
date.setMinutes(date.getMinutes() - 45);
console.log(date.toLocaleTimeString("de-DE"));
Output
09:45:00

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

Zurück zu Date

Zur Übersicht