Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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 Juli 2015.
Die MethodesetMinutes() vonDate-Instanzen ändert die Minuten für dieses Datum entsprechend der Ortszeit.
In diesem Artikel
Probieren Sie es aus
const event = new Date("August 19, 1975 23:15:30");event.setMinutes(45);console.log(event.getMinutes());// Expected output: 45console.log(event);// Expected output: "Tue Aug 19 1975 23:45:30 GMT+0200 (CEST)"// Note: your timezone may varySyntax
setMinutes(minutesValue)setMinutes(minutesValue, secondsValue)setMinutes(minutesValue, secondsValue, msValue)Parameter
minutesValueEin ganzzahliger Wert zwischen 0 und 59, der die Minuten darstellt.
secondsValueOptionalEin ganzzahliger Wert zwischen 0 und 59, der die Sekunden darstellt. Wenn Sie
secondsValueangeben, müssen Sie auchminutesValueangeben.msValueOptionalEin ganzzahliger Wert zwischen 0 und 999, der die Millisekunden darstellt. Wenn Sie
msValueangeben, müssen Sie auchminutesValueundsecondsValueangeben.
Rückgabewert
Ändert dasDate-Objekt an Ort und Stelle und gibt dessen neuenZeitstempel zurück. Wenn ein ParameterNaN ist (oder andere Werte, die zuNaNumgewandelt werden, wieundefined), wird das Datum aufInvalid Date gesetzt undNaN wird zurückgegeben.
Beschreibung
Wenn Sie die ParametersecondsValue undmsValue nicht angeben, werden dieselben Werte wie die, die vongetSeconds() undgetMilliseconds() zurückgegeben werden, verwendet.
Wenn ein von Ihnen angegebener Parameter außerhalb des erwarteten Bereichs liegt, werden andere Parameter und die Datumsinformationen imDate-Objekt entsprechend aktualisiert. Wenn Sie zum Beispiel 100 fürsecondsValue angeben, wird die Minute um 1 erhöht (minutesValue + 1), und 40 wird für die Sekunden verwendet.
DasetMinutes() 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 SiesetUTCMinutes() odersetTime() verwenden.
Wenn die neue Ortszeit innerhalb eines Offset-Übergangs liegt, wird die genaue Zeit mit demselben Verhalten wie die Optiondisambiguation: "compatible" vonTemporal 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> |