Date : méthode getTime()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La méthode getTime() des instances de Date retourne le nombre de millisecondes écoulées depuis l'epoch, défini comme le début du 1er janvier 1970 à minuit UTC.

Exemple interactif

const moonLanding = new Date("July 20, 69 20:17:40 GMT+00:00");

// Millisecondes depuis le 1er janvier 1970, 00:00:00.000 GMT
console.log(moonLanding.getTime());
// Résultat attendu : -14182940000

Syntaxe

getTime()

Valeur de retour

Un nombre représentant le timestamp, en millisecondes, de cette date. Retourne NaN si la date est invalide.

Les objets Date sont fondamentalement représentés par un timestamp, et cette méthode permet de récupérer ce timestamp. Vous pouvez utiliser cette méthode pour affecter une date et une heure à un autre objet Date. Cette méthode est fonctionnellement équivalente à la méthode valueOf().

Exemples

Utiliser la méthode `getTime()` pour copier des dates

Construire un objet date avec la même valeur temporelle.

// Puisque que les mois sont indexés à partir de zéro, l'anniversaire sera le 10 janvier 1995
const anniversaire = new Date(1994, 12, 10);
const copie = new Date();
copie.setTime(anniversaire.getTime());

Mesurer un temps d'exécution

Soustraire deux appels consécutifs à getTime() sur des objets Date nouvellement générés donne la durée écoulée entre ces deux appels. Cela peut être utilisé pour calculer le temps d'exécution de certaines opérations. Voir aussi Date.now() pour éviter d'instancier des objets Date inutiles.

let fin, debut;

debut = new Date();
for (let i = 0; i < 1000; i++) {
  Math.sqrt(i);
}
fin = new Date();

console.log(
  `Durée de cette opération : ${fin.getTime() - debut.getTime()} msec`,
);

Note : Dans les navigateurs qui prennent en charge la fonctionnalité de mesure temporelle haute résolution de l'API Performance, Performance.now() peut fournir des mesures du temps écoulé plus fiables et précises que Date.now().