Constructeur Temporal.PlainDateTime()

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.PlainDateTime() crée des objets Temporal.PlainDateTime.

Ce constructeur 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 créer des objets Temporal.PlainDateTime en utilisant la méthode statique Temporal.PlainDateTime.from(), qui peut gérer une variété de types d'entrée.

Syntaxe

new Temporal.PlainDateTime(year, month, day)
new Temporal.PlainDateTime(year, month, day, hour)
new Temporal.PlainDateTime(year, month, day, hour, minute)
new Temporal.PlainDateTime(year, month, day, hour, minute, second)
new Temporal.PlainDateTime(year, month, day, hour, minute, second, millisecond)
new Temporal.PlainDateTime(year, month, day, hour, minute, second, millisecond, microsecond)
new Temporal.PlainDateTime(year, month, day, hour, minute, second, millisecond, microsecond, nanosecond)
new Temporal.PlainDateTime(year, month, day, hour, minute, second, millisecond, microsecond, nanosecond, calendar)

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

Paramètres

year: Un nombre, tronqué à un entier, représentant l'année dans le système de calendrier ISO.
month: Un nombre, tronqué à un entier, représentant le mois dans le système de calendrier ISO.
day: Un nombre, tronqué à un entier, représentant le jour du mois dans le système de calendrier ISO.
hour Facultatif: Un nombre, tronqué à un entier, qui représente la composante des heures.
minute Facultatif: Un nombre, tronqué à un entier, qui représente la composante des minutes.
second Facultatif: Un nombre, tronqué à un entier, qui représente la composante des secondes.
millisecond Facultatif: Un nombre, tronqué à un entier, qui représente la composante des millisecondes.
microsecond Facultatif: Un nombre, tronqué à un entier, qui représente la composante des microsecondes.
nanosecond Facultatif: Un nombre, tronqué à un entier, qui représente la composante des nanosecondes.
calendar Facultatif: Une chaîne de caractères représentant le calendrier à utiliser. Voir Intl.supportedValuesOf() pour une liste des types de calendriers couramment pris en charge. Par défaut, "iso8601". Notez que, quel que soit le calendar, les year, month et day doivent être dans le système de calendrier ISO 8601.

Valeur de retour

Un nouvel objet Temporal.PlainDateTime, représentant la date et l'heure définies par les paramètres.

Exceptions

RangeError

Levée dans l'un des cas suivants :

Aucun composant de date et heure n'est un nombre fini.
La combinaison des composants de date et d'heure ne représente pas une date valide dans le système de calendrier ISO, ou n'est pas dans la plage représentable, qui est de ±(10⁸ + 1) jours, soit environ ±273 972,6 ans, à partir de l'époque Unix.
calendar n'est pas un identifiant de calendrier valide.

Exemples

Utiliser `Temporal.PlainDateTime()`

const dt = new Temporal.PlainDateTime(2021, 7, 1);
console.log(dt.toString()); // 2021-07-01T00:00:00

const dt2 = new Temporal.PlainDateTime(2021, 7, 1, 0, 0, 0, 0, 0, 0, "hebrew");
console.log(dt2.toString()); // 2021-07-01T00:00:00[u-ca=hebrew]

Spécifications

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

Compatibilité des navigateurs

Voir aussi

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

Aider à améliorer MDN

Apprendre à contribuer

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

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