Date.prototype.setMilliseconds()
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 setMilliseconds()-Methode von Date-Instanzen ändert die Millisekunden dieses Datums gemäß der lokalen Zeit.
Probieren Sie es aus
const event = new Date("August 19, 1975 23:15:30");
console.log(event.getMilliseconds());
// Expected output: 0
event.setMilliseconds(456);
console.log(event.getMilliseconds());
// Expected output: 456
Syntax
setMilliseconds(millisecondsValue)
Parameter
millisecondsValue-
Eine ganze Zahl zwischen 0 und 999, die die Millisekunden darstellt.
Rückgabewert
Ändert das Date-Objekt vor Ort und gibt seinen neuen Zeitstempel zurück. Wenn millisecondsValue 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 eine Zahl außerhalb des erwarteten Bereichs angeben, werden die Datumsinformationen im Date-Objekt entsprechend aktualisiert. Zum Beispiel, wenn Sie 1005 angeben, wird die Anzahl der Sekunden um 1 erhöht und 5 wird für die Millisekunden verwendet.
Da setMilliseconds() auf der lokalen Zeit arbeitet, kann das Überqueren einer Sommerzeitgrenze (DST) zu einer anderen verstrichenen Zeit führen als erwartet. Zum Beispiel, wenn das Setzen der Millisekunden eine Vorwärtsverschiebung im Frühling (eine Stunde weniger) überquert, ist der Unterschied in den Zeitstempeln zwischen dem neuen und alten Datum eine Stunde weniger als der nominelle Zeitunterschied. Umgekehrt führt das Überqueren einer Rückverschiebung im Herbst (eine Stunde mehr) zu einer zusätzlichen Stunde. Wenn Sie das Datum um einen festen Zeitraum anpassen müssen, sollten Sie setUTCMilliseconds() oder setTime() verwenden.
Wenn die neue lokale Zeit in eine Offset-Übergangsphase fällt, wird die genaue Zeit unter Verwendung desselben Verhaltens wie die disambiguation: "compatible"-Option von Temporal's disambiguation: "compatible" abgeleitet. Das heißt, wenn die lokale Zeit zwei Momenten entspricht, wird der frühere gewählt; existiert die lokale Zeit nicht (es gibt eine Lücke), gehen wir um die Dauer der Lücke vorwärts.
Beispiele
Verwendung von setMilliseconds()
const theBigDay = new Date();
theBigDay.setMilliseconds(100);
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.setmilliseconds |