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
setMinutes(minutesValue)
setMinutes(minutesValue, secondsValue)
setMinutes(minutesValue, secondsValue, msValue)
Parameter
minutesValue-
Eine Ganzzahl zwischen 0 und 59, die die Minuten angibt.
secondsValueOptional-
Eine Ganzzahl zwischen 0 und 59, die die Sekunden angibt. Wenn Sie
secondsValueangeben, müssen Sie auchminutesValueangeben. msValueOptional-
Eine Ganzzahl zwischen 0 und 999, die die Millisekunden angibt. Wenn Sie
msValueangeben, müssen Sie auchminutesValueundsecondsValueangeben.
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
const theBigDay = new Date();
theBigDay.setMinutes(45);
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-date.prototype.setminutes> |