Date.prototype.setMinutes()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die Methode setMinutes() von Date-Instanzen ändert die Minuten für dieses Datum entsprechend der Ortszeit.

Probieren Sie es aus

const event = new Date("August 19, 1975 23:15:30");

event.setMinutes(45);

console.log(event.getMinutes());
// Expected output: 45

console.log(event);
// Expected output: "Tue Aug 19 1975 23:45:30 GMT+0200 (CEST)"
// Note: your timezone may vary

Syntax

setMinutes(minutesValue)
setMinutes(minutesValue, secondsValue)
setMinutes(minutesValue, secondsValue, msValue)

Parameter

minutesValue: Ein ganzzahliger Wert zwischen 0 und 59, der die Minuten darstellt.
secondsValue Optional: Ein ganzzahliger Wert zwischen 0 und 59, der die Sekunden darstellt. Wenn Sie secondsValue angeben, müssen Sie auch minutesValue angeben.
msValue Optional: Ein ganzzahliger Wert zwischen 0 und 999, der die Millisekunden darstellt. Wenn Sie msValue angeben, müssen Sie auch minutesValue und secondsValue angeben.

Ändert das Date-Objekt an Ort und Stelle und gibt dessen neuen Zeitstempel zurück. Wenn ein Parameter NaN ist (oder andere Werte, die zu NaN umgewandelt werden, wie undefined), wird das Datum auf Invalid Date gesetzt und NaN wird zurückgegeben.

Beschreibung

Wenn Sie die Parameter secondsValue und msValue nicht angeben, werden dieselben Werte wie die, die von getSeconds() und getMilliseconds() zurückgegeben werden, verwendet.

Wenn ein von Ihnen angegebener Parameter außerhalb des erwarteten Bereichs liegt, werden andere Parameter und die Datumsinformationen im Date-Objekt entsprechend aktualisiert. Wenn Sie zum Beispiel 100 für secondsValue angeben, wird die Minute um 1 erhöht (minutesValue + 1), und 40 wird für die Sekunden verwendet.

Da setMinutes() auf die Ortszeit wirkt, kann das Überqueren einer Sommerzeitgrenze (DST) zu einer anderen verstrichenen Zeit als erwartet führen. Zum Beispiel, wenn durch das Setzen der Minuten ein „Vorstellen“ im Frühling (eine Stunde verloren) überquert wird, ist die Differenz in den Zeitstempeln zwischen dem neuen und dem alten Datum um eine Stunde weniger als der nominale Zeitunterschied. Umgekehrt führt das Überqueren eines „Zurück“-Übergangs im Herbst (eine Stunde gewonnen) zu einer zusätzlichen Stunde. Wenn Sie das Datum um einen festen Zeitbetrag anpassen müssen, sollten Sie setUTCMinutes() oder setTime() verwenden.

Wenn die neue Ortszeit innerhalb eines Offset-Übergangs liegt, wird die genaue Zeit mit demselben Verhalten wie die Option disambiguation: "compatible" von Temporal abgeleitet. Das heißt, wenn die Ortszeit zwei Zeitpunkte entspricht, wird der frühere gewählt; wenn die Ortszeit nicht existiert (es gibt eine Lücke), springen wir um die Dauer der Lücke vor.

Beispiele

Verwendung von setMinutes()

const theBigDay = new Date();
theBigDay.setMinutes(45);

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-date.prototype.setminutes