Temporal.PlainMonthDay : méthode toPlainDate()

Syntaxe

toPlainDate(yearInfo)

Paramètres

yearInfo

Un objet représentant le composant année de l'objet PlainDate résultant, contenant les propriétés suivantes (dans l'ordre où elles sont récupérées et validées) :

era et eraYear

Une chaîne de caractères et un entier correspondant aux propriétés era et eraYear. Sont utilisés uniquement si le système de calendrier possède des ères. era et eraYear doivent être fournis simultanément. S'ils ne sont pas fournis, alors year doit être fourni. Si era, eraYear et year sont tous fournis, ils doivent être cohérents.

year

Correspond à la propriété year.

Valeur de retour

Un nouvel objet Temporal.PlainDate représentant la date définie par ce mois et ce jour et l'année dans yearInfo, interprété dans le système de calendrier de ce mois et ce jour.

Exceptions

RangeError

Levée si l'une des options est invalide.

TypeError

Levée si yearInfo n'est pas un objet.

Exemples

Utiliser la méthode toPlainDate()

const md = Temporal.PlainMonthDay.from("07-01");
const date = md.toPlainDate({ year: 2021 });
console.log(date.toString()); // 2021-07-01

const md2 = Temporal.PlainMonthDay.from("2021-07-01[u-ca=japanese]");
const date2 = md2.toPlainDate({ era: "reiwa", eraYear: 1 });
console.log(date2.toString()); // 2019-07-01[u-ca=japanese]

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet Temporal.PlainMonthDay
• L'objet Temporal.PlainDate
• La méthode Temporal.PlainDate.prototype.toPlainMonthDay()