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
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
const date = new Date("2026-05-01T14:30:00.250Z");
console.log(date.getUTCMilliseconds());250ISO-Zeit mit Millisekunden formatieren
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")));14:30:00.007ZEindeutige IDs mit Millisekunden-Genauigkeit
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));evt-1777689000123-123Vergleich mit getMilliseconds()
const date = new Date("2026-05-01T14:30:00.500Z");
console.log(date.getMilliseconds() === date.getUTCMilliseconds());trueHinweise & 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.