Die Methode Date.prototype.setUTCMilliseconds() setzt den Millisekundenanteil eines Date-Objekts in der koordinierten Weltzeit (UTC). Werte außerhalb von 0–999 werden in Sekunden überrollt – das ermöglicht eine elegante Sub-Sekunden-Arithmetik. Da Zeitzonen praktisch nie im Millisekundenbereich variieren, ist das Verhalten praktisch identisch zu setMilliseconds(). Die UTC-Variante existiert primär aus Konsistenzgründen mit den übrigen UTC-Settern und sollte in UTC-orientiertem Code aus Stilsicherheit verwendet werden.

01 · Abschnitt

Funktionsweise

Da Millisekunden zeitzonen-unabhängig sind, ist das Verhalten praktisch identisch zu setMilliseconds(). Werte über 999 oder unter 0 führen zu einem Sekunden-Überlauf bzw. -Unterlauf:

  • setUTCMilliseconds(2500): +2 Sekunden, 500 ms.
  • setUTCMilliseconds(-500): Sekunde davor, 500 ms.
  • setUTCMilliseconds(NaN): Invalidiert das Date-Objekt.
02 · Abschnitt

Syntax

JavaScript Syntax 
date.setUTCMilliseconds(msValue)
Parameter
msValue

Eine Ganzzahl, die den neuen Millisekundenwert angibt. Idealerweise zwischen 0 und 999.

Rückgabewert

Die Anzahl der Millisekunden seit dem 1. Januar 1970 UTC nach der Aktualisierung.

03 · Abschnitt

Beispiele

Millisekunden in UTC setzen

JavaScript Beispiel 
const date = new Date("2026-05-01T10:00:00.000Z");
date.setUTCMilliseconds(750);
console.log(date.toISOString());
Output 
2026-05-01T10:00:00.750Z

Sekundenüberlauf

JavaScript Beispiel 
const date = new Date("2026-05-01T10:00:00.000Z");
date.setUTCMilliseconds(2500);
console.log(date.toISOString());
Output 
2026-05-01T10:00:02.500Z

Millisekunden auf 0 zurücksetzen

JavaScript Beispiel 
const date = new Date("2026-05-01T10:00:00.873Z");
date.setUTCMilliseconds(0);
console.log(date.toISOString());
Output 
2026-05-01T10:00:00.000Z

Negative Millisekunden

JavaScript Beispiel 
const date = new Date("2026-05-01T10:00:01.000Z");
date.setUTCMilliseconds(-100);
console.log(date.toISOString());
Output 
2026-05-01T10:00:00.900Z
04 · Abschnitt

Hinweise & verwandte Methoden

  • Für die lokale Variante: Date.prototype.setMilliseconds() – verhält sich praktisch identisch.
  • Für hochpräzise Animationen oder Performance-Messungen ist performance.now() die bessere Wahl.
  • setUTCMilliseconds(NaN) invalidiert das Date-Objekt.
  • Die Methode mutiert das Original.
/ Weiter

Zurück zu Date

Zur Übersicht