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

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.

Sources