Die Methode Date.prototype.getUTCMilliseconds() gibt die Millisekunden-Komponente eines Date-Objekts in der koordinierten Weltzeit (UTC) zurück. Der Wert liegt zwischen 0 und 999. Da Zeitzonen praktisch nie im Millisekundenbereich variieren, ist das Ergebnis in der Praxis stets identisch zu getMilliseconds(). Die UTC-Variante existiert primär aus Konsistenzgründen mit den übrigen UTC-Gettern und sollte in UTC-orientiertem Code aus Stilsicherheit dennoch konsequent verwendet werden.

Funktionsweise

getUTCMilliseconds() liest den Bruchteil-Sekunden-Anteil des Datums aus. Da kein Zeitzonen-Offset im Bereich von Millisekunden definiert ist, liefert die Methode für jeden Zeitpunkt denselben Wert wie getMilliseconds().

Wichtige Hinweise:

  • Browser-Präzision: Aus Sicherheitsgründen reduzieren moderne Browser die Auflösung von Date-basierten Zeitabfragen oft auf 1–2 ms. Für hochpräzise Messungen ist performance.now() die bessere Wahl.
  • Schaltsekunden: JavaScript-Date-Objekte modellieren keine Schaltsekunden – die Sekundenzählung läuft kontinuierlich auf Basis des POSIX-Zeitmodells.

Syntax

JavaScript Syntax
date.getUTCMilliseconds()

Die Methode erwartet keine Parameter.

Rückgabewert

Eine Ganzzahl zwischen 0 und 999. Bei einem ungültigen Datum wird NaN zurückgegeben.

Beispiele

Millisekunden in UTC auslesen

JavaScript Beispiel
const date = new Date("2026-05-01T14:30:00.250Z");
console.log(date.getUTCMilliseconds());
Output
250

ISO-Zeit mit Millisekunden formatieren

JavaScript Beispiel
function formatUtcZeit(date) {
    const hh = String(date.getUTCHours()).padStart(2, "0");
    const mm = String(date.getUTCMinutes()).padStart(2, "0");
    const ss = String(date.getUTCSeconds()).padStart(2, "0");
    const ms = String(date.getUTCMilliseconds()).padStart(3, "0");
    return `${hh}:${mm}:${ss}.${ms}Z`;
}

console.log(formatUtcZeit(new Date("2026-05-01T14:30:00.007Z")));
Output
14:30:00.007Z

Eindeutige IDs mit Millisekunden-Genauigkeit

JavaScript Beispiel
function eventId(date) {
    const ts = String(date.getTime());
    const ms = String(date.getUTCMilliseconds()).padStart(3, "0");
    return `evt-${ts}-${ms}`;
}

const date = new Date("2026-05-01T14:30:00.123Z");
console.log(eventId(date));
Output
evt-1777689000123-123

Vergleich mit getMilliseconds()

JavaScript Beispiel
const date = new Date("2026-05-01T14:30:00.500Z");
console.log(date.getMilliseconds() === date.getUTCMilliseconds());
Output
true

Hinweise & verwandte Methoden

  • Für die lokale Variante: Date.prototype.getMilliseconds() – liefert in der Praxis denselben Wert.
  • Zum Setzen: Date.prototype.setUTCMilliseconds(). Werte über 999 oder unter 0 führen zu einem Sekundenüberlauf.
  • Für hochpräzise Performance-Messungen ist performance.now() die bessere Wahl.
  • Bei Logging und JSON-Serialisierung sollte die Zeit konsequent in UTC ausgegeben werden – toISOString() erledigt das automatisch und enthält die Millisekunden bereits.
/ Weiter

Zurück zu Date

Zur Übersicht