Temporal.PlainDateTime : propriété eraYear

Disponibilité limitée

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

La propriété d'accesseur eraYear des instances de Temporal.PlainDateTime retourne un entier non négatif représentant l'année de cette date dans l'ère, ou undefined si le calendrier n'utilise pas d'ères (par exemple, ISO 8601). L'index de l'année commence généralement à 1 (plus courant) ou 0, et les années dans une ère peuvent diminuer avec le temps (par exemple, avant notre ère dans le calendrier grégorien). era et eraYear identifient ensemble de manière unique une année dans un calendrier, de la même manière que year. Elle dépend du calendrier utilisé.

Le mutateur d'accesseur de eraYear est undefined. Vous ne pouvez pas modifier cette propriété directement. Utilisez la méthode with() pour créer un nouvel objet Temporal.PlainDateTime avec la nouvelle valeur souhaitée.

Pour des informations générales et plus d'exemples, voir Temporal.PlainDate.prototype.eraYear.

Exemples

Utiliser la propriété `eraYear`

const dt = Temporal.PlainDateTime.from("2021-07-01"); // calendrier ISO 8601
console.log(dt.eraYear); // undefined

const dt2 = Temporal.PlainDateTime.from("2021-07-01[u-ca=gregory]");
console.log(dt2.eraYear); // 2021

const dt3 = Temporal.PlainDateTime.from("-002021-07-01[u-ca=gregory]");
console.log(dt3.eraYear); // 2022 ; 0000 est utilisé pour l'année 1 avant notre ère

const dt4 = Temporal.PlainDateTime.from("2021-07-01[u-ca=japanese]");
console.log(dt4.eraYear); // 3