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

CKTIS / JavaScript

Date.UTC : composants UTC vers horodatage

Date.UTC interprète des composants numériques en UTC, les normalise et renvoie des millisecondes depuis l’époque sans créer de Date.

Version : ECMAScript 1 onward; example target: Node.js 24.22.2

Syntaxe

Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, milliseconds?)

Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, ms?) renvoie un Number de millisecondes depuis l’époque. monthIndex part de zéro ; par défaut le mois vaut 0, le jour 1 et les champs horaires 0. Les années 0–99 sont spécialement converties en 1900–1999. Créez un objet avec new Date(Date.UTC(...)).

Les valeurs hors plage naturelle sont normalisées : le mois 12 devient janvier suivant et le jour 0 la fin du mois précédent. Après ToNumber et TimeClip, valeur non finie, année requise absente ou résultat hors de ±8.64e15 donne NaN. BigInt et Symbol lèvent TypeError.

Méthode statique, Date.UTC n’utilise pas le fuseau local. Les arguments supplémentaires sont ignorés et la fonction n’est pas un constructeur. Elle existe depuis ECMAScript 1.

Exemples

const timestamp = Date.UTC(2024, 1, 29, 12, 30);
console.log(timestamp, new Date(timestamp).toISOString());
console.log(Date.UTC(2024, 12, 1) === Date.UTC(2025, 0, 1));
console.log(new Date(Date.UTC(99, 0, 1)).toISOString());
console.log(Number.isNaN(Date.UTC()));

Résultat

1709209800000 2024-02-29T12:30:00.000Z
true
1999-01-01T00:00:00.000Z
true

Sources