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.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

js
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()

js
const theBigDay = new Date();
theBigDay.setMilliseconds(100);

Spezifikationen

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

Browser-Kompatibilität

Siehe auch