Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Dates et heures

Un objet Date représente un instant sous forme de millisecondes écoulées depuis le début de 1970 en UTC. Distinguez un instant, une représentation calendaire locale et une durée afin d’éviter les erreurs liées aux fuseaux horaires.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new Date(milliseconds)
new Date("YYYY-MM-DDTHH:mm:ss.sssZ")
date.getTime()
date.toISOString()

Date stocke un instant sous forme d’un nombre entier de millisecondes écoulées depuis 1970-01-01T00:00:00.000Z ; les valeurs négatives représentent des instants antérieurs. Il ne stocke pas de fuseau horaire. getTime() renvoie ce nombre, tandis que toISOString() représente l’instant en UTC avec un Z final.

Un instant, une date et une heure locales, et une durée sont des notions différentes. Les méthodes locales interprètent un instant dans le fuseau horaire de l’environnement, tandis que les méthodes UTC utilisent UTC. Les changements d’heure peuvent faire qu’une journée locale ne dure pas 24 heures. Ajouter 86400000 millisecondes signifie donc 24 heures, pas nécessairement la même heure locale le lendemain.

Pour analyser du texte, utilisez le format standard avec un Z ou un décalage explicite. Sans décalage, YYYY-MM-DD est interprété en UTC, mais une date-heure est interprétée comme une heure locale. D’autres formats peuvent dépendre de l’implémentation. Un Date invalide a pour valeur temporelle NaN ; vérifiez-le avec Number.isNaN(date.getTime()). Appeler toISOString() sur cet objet déclenche une RangeError.

L’exemple ajoute 90 minutes à un instant fixe et calcule la différence en secondes. Les opérations présentées relèvent d’ECMAScript, et non des API Web des navigateurs.

Exemples

const start = new Date("2024-01-01T00:00:00.000Z");
const end = new Date(start.getTime() + 90 * 60 * 1000);
console.log(end.toISOString());
console.log((end.getTime() - start.getTime()) / 1000);

Résultat

2024-01-01T01:30:00.000Z
5400

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources