Constructeur Temporal.PlainDate()

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

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

Syntaxe

new Temporal.PlainDate(year, month, day)
new Temporal.PlainDate(year, month, day, calendar)

Note : Temporal.PlainDate() ne peut être construit 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.
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 calendar, year, month et day doivent être dans le système de calendrier ISO 8601.

Valeur de retour

Un nouvel objet Temporal.PlainDate, représentant la date définie par year, month, day (dans le calendrier ISO), interprétée dans le système de calendrier défini par calendar.

Exceptions

TypeError

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

RangeError

Levée dans l'un des cas suivants :

year, month ou day n'est pas un nombre fini.
La combinaison year, month et day 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.PlainDate()`

const plainDate = new Temporal.PlainDate(2021, 7, 1);
console.log(plainDate.toString()); // 2021-07-01

// Notez que la date est stockée en interne au format ISO 8601, même
// lorsqu'elle est interprétée dans un système de calendrier différent.
// Par exemple, bien que 2021-07-01 ISO soit 5781-10-21 dans le
// calendrier hébraïque, vous passez toujours la date ISO au
// constructeur.
const plainDate2 = new Temporal.PlainDate(2021, 7, 1, "hebrew");
console.log(plainDate2.toString()); // 2021-07-01[u-ca=hebrew]
console.log(plainDate2.year); // 5781
console.log(plainDate2.month); // 10
console.log(plainDate2.day); // 21

Spécifications

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

Compatibilité des navigateurs

Voir aussi

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

Aider à améliorer MDN

Apprendre à contribuer

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

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