Date.now()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die statische Methode Date.now() gibt die Anzahl der Millisekunden zurück, die seit dem Epoch vergangen sind. Diese ist als Mitternacht zu Beginn des 1. Januar 1970, UTC, definiert.
Probieren Sie es aus
// This example takes 2 seconds to run
const start = Date.now();
console.log("starting timer...");
// Expected output: "starting timer..."
setTimeout(() => {
const ms = Date.now() - start;
console.log(`seconds elapsed = ${Math.floor(ms / 1000)}`);
// Expected output: "seconds elapsed = 2"
}, 2000);
Syntax
Date.now()
Parameter
Keine.
Rückgabewert
Eine Zahl, die den Zeitstempel, in Millisekunden, der aktuellen Uhrzeit darstellt.
Beschreibung
Reduzierte Zeitpräzision
Um Schutz gegen Timing-Angriffe und Fingerprinting zu bieten, kann die Präzision von Date.now() je nach Browsereinstellungen gerundet werden. In Firefox ist die Einstellung privacy.reduceTimerPrecision standardmäßig aktiviert und beträgt standardmäßig 2 ms. Sie können auch privacy.resistFingerprinting aktivieren; in diesem Fall beträgt die Präzision 100 ms oder der Wert von privacy.resistFingerprinting.reduceTimerPrecision.microseconds, je nachdem, welcher größer ist.
Zum Beispiel wird das Ergebnis von Date.now() bei reduzierter Zeitpräzision immer ein Vielfaches von 2 sein oder ein Vielfaches von 100 (oder privacy.resistFingerprinting.reduceTimerPrecision.microseconds) mit aktiviertem privacy.resistFingerprinting.
// reduced time precision (2ms) in Firefox 60
Date.now();
// Might be:
// 1519211809934
// 1519211810362
// 1519211811670
// …
// reduced time precision with `privacy.resistFingerprinting` enabled
Date.now();
// Might be:
// 1519129853500
// 1519129858900
// 1519129864400
// …
Beispiele
Messung der verstrichenen Zeit
Sie können Date.now() verwenden, um die aktuelle Zeit in Millisekunden zu erhalten, und dann eine frühere Zeit subtrahieren, um herauszufinden, wie viel Zeit zwischen den beiden Aufrufen vergangen ist.
const start = Date.now();
doSomeLongRunningProcess();
console.log(`Time elapsed: ${Date.now() - start} ms`);
Für komplexere Szenarien sollten Sie stattdessen die Performance API verwenden.
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.now |