CKTIS / JavaScript
Date — horodatages et année UTC
Date stocke un horodatage. Découvrez comment lire et modifier l’année UTC, comprendre la mutation de l’objet et gérer la normalisation des dates, notamment le passage du 29 février à une année non bissextile.
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(isoString)
date.getUTCFullYear()
date.setUTCFullYear(year[, month[, day]])Date est un objet intégré d’ECMAScript qui stocke le nombre de millisecondes écoulées depuis 1970-01-01T00:00:00.000Z, ou NaN pour une date invalide. Il ne stocke pas de fuseau horaire. Les méthodes locales interprètent le même horodatage selon le fuseau horaire de l’environnement ; les méthodes UTC utilisent UTC.
Date.prototype.getUTCFullYear() renvoie l’année UTC complète, ou NaN pour une date invalide. Date.prototype.setUTCFullYear(year[, month[, day]]) modifie l’objet et renvoie l’horodatage obtenu, et non un objet Date. Les mois utilisent les indices 0–11, tandis que les jours du mois commencent à 1. Si la date d’origine est valide, pour chaque argument de mois ou de jour omis, la méthode utilise la valeur UTC d’origine comme donnée d’entrée. La normalisation peut modifier le mois et le jour dans le résultat. Si le résultat est valide, l’heure en UTC reste inchangée.
Le setter normalise les valeurs : remplacer l’année du 29 février par une année non bissextile donne le 1er mars. Une année comprise entre 0–99 est interprétée littéralement, contrairement au constructeur Date à plusieurs arguments. Pour une date invalide, le setter utilise l’horodatage 0 comme point de départ ; des arguments numériques invalides peuvent toutefois produire NaN.
L’exemple utilise un Z explicite et des méthodes UTC afin que le résultat ne dépende pas du fuseau horaire local. Il vérifie également que l’horodatage renvoyé correspond à l’objet modifié.
Exemples
const date = new Date("2024-02-29T12:00:00.000Z");
console.log(date.getUTCFullYear());
const timestamp = date.setUTCFullYear(2025);
console.log(date.toISOString());
console.log(timestamp === date.getTime());Résultat
2024 2025-03-01T12:00:00.000Z true
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.