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.