Constructeur Temporal.PlainYearMonth()

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

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

Syntaxe

new Temporal.PlainYearMonth(year, month)
new Temporal.PlainYearMonth(year, month, calendar)
new Temporal.PlainYearMonth(year, month, calendar, referenceDay)

Note : Temporal.PlainYearMonth() ne peut être construit qu'avec new. Tenter de l'appeler sans new déclenche une TypeError.

Attention : Évitez d'utiliser les paramètres calendar et referenceDay, car equals() et compare() prendront en compte le jour de référence pour la comparaison, ce qui peut entraîner que deux mois et années équivalentes soient considérées comme différentes si elles ont des jours de référence différents. Pour créer un objet Temporal.PlainYearMonth avec un calendrier non ISO, utilisez la méthode statique Temporal.PlainYearMonth.from().

Paramètres

year Facultatif: 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.
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, year, month et referenceDay doivent être dans le système de calendrier ISO 8601.
referenceDay: Un nombre, tronqué à un entier, représentant le jour du mois dans le système de calendrier ISO. Par défaut, 1. Le même mois son année ISO peut représenter des mois différents selon les jours dans des calendriers non ISO. Par exemple, les jours 2021-07-01 et 2021-07-31 peuvent tomber dans des mois différents dans un calendrier non grégorien, et définir simplement "2021-07" est insuffisant pour déterminer de manière non ambiguë un mois dans le calendrier cible. Par conséquent, vous devez presque toujours définir un referenceDay lorsque vous utilisez un calendrier non ISO.

Valeur de retour

Un nouvel objet Temporal.PlainYearMonth, représentant le mois et son année de la date définie par year, month et referenceDay (dans le calendrier ISO), interprété 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 referenceDay n'est pas un nombre fini.
La combinaison year, month et referenceDay 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.PlainYearMonth()`

const ym = new Temporal.PlainYearMonth(2021, 7);
console.log(ym.toString()); // 2021-07

const ym2 = new Temporal.PlainYearMonth(2021, 7, "chinese");
console.log(ym2.toString()); // 2021-07-01[u-ca=chinese]

const ym3 = new Temporal.PlainYearMonth(2021, 7, "chinese", 31);
console.log(ym3.toString()); // 2021-07-31[u-ca=chinese]

Utilisation inappropriée

Vous devriez éviter d'utiliser les paramètres calendar et referenceDay, sauf si vous savez que le referenceDay est le jour de référence canonique qui serait sélectionné par Temporal.PlainYearMonth.from() pour la même année-mois.

const ym = new Temporal.PlainYearMonth(2021, 7, "chinese", 1);
const ym2 = Temporal.PlainYearMonth.from("2021-07-01[u-ca=chinese]");
console.log(ym.equals(ym2)); // false
console.log(ym.toString()); // 2021-07-01[u-ca=chinese]
console.log(ym2.toString()); // 2021-06-10[u-ca=chinese]

Spécifications

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

Compatibilité des navigateurs

Voir aussi

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

Aider à améliorer MDN

Apprendre à contribuer

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

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