Date.now()
La méthode Date.now()
renvoie le nombre de millisecondes écoulées depuis le 1er Janvier 1970 00:00:00 UTC.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Syntaxe
var tempsEnMs = Date.now();
Valeur de retour
Le nombre de millisecondes écoulées depuis le premier janvier 1970 à minuit UTC.
Description
La méthode now()
renvoie le nombre de millisecondes écoulées depuis le 1er janvier 1970 00:00:00 UTC sous forme d'un Number
(nombre).
now()
étant une méthode statique de Date
, on utilisera toujours la forme Date.now()
.
Prothèse d'émulation (polyfill)
Cette méthode a été standardisée dans la 5e édition d'ECMA-262. Les moteurs JavaScript ne la supportant pas peuvent l'émuler de la façon suivante :
if (!Date.now) {
Date.now = function now() {
return new Date().getTime();
};
}
Précision temporelle réduite
Afin de protéger contre les attaques de minutage et d'identification, la précision de new Date.now()
peut être arrondie en fonction des paramètres du navigateur. Pour Firefox, la préférence privacy.reduceTimerPrecision
est activée par défaut et vaut, par défaut 20ms pour Firefox 59 et 2ms pour Firefox 60.
// Précision temporelle réduite (2ms) pour Firefox 60
new Date().getTime();
// 1519211809934
// 1519211810362
// 1519211811670
// ...
// précision temporelle avec `privacy.resistFingerprinting` activé
new Date().getTime();
// 1519129853500
// 1519129858900
// 1519129864400
// ...
Pour Firefox, il est également possible d'activer privacy.resistFingerprinting
auquel cas la précision sera 100ms ou la valeur de privacy.resistFingerprinting.reduceTimerPrecision.microseconds
selon laquelle est plus grande.
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript 5.1 (ECMA-262) La définition de 'Date.now' dans cette spécification. |
Standard | Définition initiale. Implémentée avec JavaScript 1.5. |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Date.now' dans cette spécification. |
Standard | |
ECMAScript (ECMA-262) La définition de 'Date.now' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser
Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.
Voir aussi
window.performance.now
- renvoie des timestamps (horodatages) avec une précision supérieure à la milliseconde pour mesurer la performance des pages web.console.time
/console.timeEnd