MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/d6d7ff2e2f9c

La méthode getTime() renvoie la valeur numérique correspondant au temps pour la date renseignée, d'après le temps universel (c'est-à-dire relative à UTC, une mesure donnée par getTime() sera indépendante du fuseau horaire sur lequel on se trouve).

Vous pouvez utiliser cette méthode pour vous affecter une date et un temps à une autre instance de Date. Cette méthode est fonctionnellement équivalente à la méthode valueOf().

Syntaxe

dateObj.getTime()

Valeur de retour

La valeur renvoyée par la méthode getTime() est le nombre de millièmes de secondes entre le 1 janvier 1970 à 00:00:00 UTC et la date indiquée.

Exemples

Utiliser getTime()

L'exemple qui suit assigne la valeur de anniversaire à copie :

var anniversaire = new Date(1994 , 11, 10); // 10 décembre 1994
var copie = new Date();
copie.setTime(anniversaire.getTime());

Mesurer un temps d'exécution

Effectuer une soustration entre deux appels à getTime() donne la durée écoulée entre ces appels. On peut donc utiliser cette méthode afin de connaître la durée d'exécution de certaines opérations (voir également la méthode Date.now() qui peut permettre d'éviter d'instancier des objets intermédiaires).

var fin, début;

début = new Date();
for (var i = 0; i < 1000; i++) {
  Math.sqrt(i);
}
fin = new Date();

console.log('Durée de cette opération : ' + (fin.getTime() - début.getTime()) + ' msec');

Spécifications

Spécification État Commentaires
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
La définition de 'Date.prototype.getTime' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Date.prototype.getTime' dans cette spécification.
Standard  
ECMAScript Latest Draft (ECMA-262)
La définition de 'Date.prototype.getTime' dans cette spécification.
Standard évolutif  

Compatibilité des navigateurs

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple(Oui)(Oui)(Oui)(Oui)(Oui)(Oui)
FonctionnalitéAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Support simple(Oui)(Oui)(Oui)(Oui)(Oui)(Oui)(Oui)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, tregagnon, teoli, BenoitL
 Dernière mise à jour par : SphinxKnight,