Date.prototype.setMilliseconds()
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 setMilliseconds() 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 Ganzzahl zwischen 0 und 999, die die Millisekunden angibt.
Rückgabewert
Ändert das Date-Objekt direkt und gibt seinen neuen Zeitstempel zurück. Wenn millisecondsValue NaN ist (oder ein anderer Wert, der zu NaN umgewandelt wird, etwa undefined), wird das Datum auf Invalid Date gesetzt und NaN zurückgegeben.
Beschreibung
Wenn Sie eine Zahl außerhalb des erwarteten Bereichs angeben, werden die Datumsinformationen im Date-Objekt entsprechend aktualisiert. Wenn Sie beispielsweise 1005 angeben, erhöht sich die Anzahl der Sekunden um 1, und für die Millisekunden wird 5 verwendet.
Da setMilliseconds() mit der lokalen Zeit arbeitet, kann das Überschreiten einer Grenze zwischen Sommer- und Winterzeit zu einer anderen verstrichenen Zeit führen als erwartet. Wenn das Setzen der Millisekunden beispielsweise einen Wechsel zur Sommerzeit überschreitet (bei dem eine Stunde entfällt), ist die Differenz zwischen den Zeitstempeln des neuen und des alten Datums eine Stunde kleiner als die nominelle Zeitdifferenz. Umgekehrt führt das Überschreiten eines Wechsels zur Winterzeit (bei dem eine Stunde hinzukommt) zu einer zusätzlichen Stunde. Wenn Sie das Datum um eine feste Zeitspanne ändern müssen, sollten Sie setUTCMilliseconds() oder setTime() verwenden.
Wenn die neue lokale Zeit in einen Übergang des UTC-Offsets fällt, wird der genaue Zeitpunkt nach demselben Verfahren bestimmt wie bei der Option disambiguation: "compatible" von Temporal. Das heißt: Entspricht die lokale Zeit zwei Zeitpunkten, wird der frühere gewählt. Existiert die lokale Zeit nicht (weil eine Lücke entsteht), wird sie um die Dauer der Lücke nach vorne verschoben.
Beispiele
>Verwendung von setMilliseconds()
const theBigDay = new Date();
theBigDay.setMilliseconds(100);
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-date.prototype.setmilliseconds> |