Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Date.prototype.setMinutes()

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die Methode setMinutes() von Date-Instanzen ändert die Minuten dieses Datums 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

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

Parameter

minutesValue

Eine Ganzzahl zwischen 0 und 59, die die Minuten angibt.

secondsValue Optional

Eine Ganzzahl zwischen 0 und 59, die die Sekunden angibt. Wenn Sie secondsValue angeben, müssen Sie auch minutesValue angeben.

msValue Optional

Eine Ganzzahl zwischen 0 und 999, die die Millisekunden angibt. Wenn Sie msValue angeben, müssen Sie auch minutesValue und secondsValue angeben.

Rückgabewert

Ändert das Date-Objekt direkt und gibt seinen neuen Zeitstempel zurück. Wenn ein Parameter NaN ist oder in NaN umgewandelt wird, wie etwa undefined, wird das Datum auf Invalid Date gesetzt und NaN zurückgegeben.

Beschreibung

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

Wenn ein angegebener Parameter außerhalb des erwarteten Bereichs liegt, werden andere Parameter und die Datumsangaben im Date-Objekt entsprechend angepasst. Wenn Sie beispielsweise für secondsValue den Wert 100 angeben, werden die Minuten um 1 erhöht (minutesValue + 1) und für die Sekunden wird 40 verwendet.

Da setMinutes() mit der Ortszeit arbeitet, kann beim Überschreiten eines Übergangs zur oder von der Sommerzeit (Daylight Saving Time, DST) eine andere Zeitspanne vergehen als erwartet. Wenn das Setzen der Minuten beispielsweise einen Übergang zur Sommerzeit überschreitet, bei dem eine Stunde entfällt, ist die Differenz zwischen dem neuen und dem alten Zeitstempel eine Stunde kleiner als die nominelle Zeitdifferenz. Umgekehrt ergibt sich beim Überschreiten eines Übergangs zurück zur Normalzeit, bei dem eine Stunde hinzukommt, eine zusätzliche Stunde. Wenn Sie das Datum um eine feste Zeitspanne ändern müssen, verwenden Sie stattdessen setUTCMinutes() oder setTime().

Wenn die neue Ortszeit in einen Übergang des UTC-Offsets fällt, wird der genaue Zeitpunkt nach denselben Regeln ermittelt wie bei der Option disambiguation: "compatible" von Temporal. Das bedeutet: Entspricht die Ortszeit zwei Zeitpunkten, wird der frühere gewählt. Existiert die Ortszeit nicht, weil sie in eine Lücke fällt, wird sie um die Dauer der Lücke nach vorne verschoben.

Beispiele

setMinutes() verwenden

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

Spezifikationen

Spezifikation
ECMAScript® 2027 Language Specification
# sec-date.prototype.setminutes

Browser-Kompatibilität

Siehe auch