Constructeur Temporal.ZonedDateTime()

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

Le constructeur Temporal.ZonedDateTime() crée des objets Temporal.ZonedDateTime.

Ce constructeur vous permet de créer des instances en fournissant directement les données sous-jacentes. Comme pour toutes les autres classes Temporal, vous devriez généralement construire des objets Temporal.ZonedDateTime en utilisant la méthode statique Temporal.ZonedDateTime.from(), qui peut gérer une variété de types d'entrée.

Syntaxe

new Temporal.ZonedDateTime(epochNanoseconds, timeZone)
new Temporal.ZonedDateTime(epochNanoseconds, timeZone, calendar)

Note : Le constructeur Temporal.ZonedDateTime() ne peut être utilisé qu'avec new. Tenter de l'appeler sans new génère une TypeError.

Paramètres

epochNanoseconds: Un grand entier (BigInt) qui correspond à la propriété epochNanoseconds.
timeZone: Une chaîne de caractères qui correspond à la propriété timeZoneId. Contrairement à toutes les autres API Temporal, elle doit être un identifiant de fuseau horaire valide (soit nommé, soit décalé) tel quel, et ne peut pas être une instance de Temporal.ZonedDateTime ou une chaîne de caractères de date et d'heure.
calendar Facultatif: Une chaîne de caractères qui correspond à la propriété calendarId. Voir Intl.supportedValuesOf() pour une liste des types de calendriers couramment pris en charge. Par défaut, "iso8601".

Valeur de retour

Un nouvel objet Temporal.ZonedDateTime, représentant l'instant spécifique défini par les paramètres.

Exceptions

TypeError

Levée si timeZone ou calendar n'est pas une chaîne de caractères.

RangeError

Levée dans l'un des cas suivants :

epochNanoseconds n'est pas dans la plage représentable, qui est de ±10⁸ jours, soit environ ±273 972,6 ans, à partir de l'époque Unix.
timeZone n'est pas un identifiant de fuseau horaire valide.
calendar n'est pas un identifiant de calendrier valide.

Exemples

Utiliser Temporal.ZonedDateTime()

const zdt = new Temporal.ZonedDateTime(0n, "America/New_York");
console.log(zdt.toString()); // '1969-12-31T19:00:00-05:00[America/New_York]'

Spécifications

Spécification
Temporal # sec-temporal-zoneddatetime-constructor

Compatibilité des navigateurs

Voir aussi

L'objet Temporal.ZonedDateTime
La méthode statique Temporal.ZonedDateTime.from()

Aider à améliorer MDN

Apprendre à contribuer

Cette page a été modifiée le 30 mars 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu