Temporal.Duration : propriété years

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 years des instances de Temporal.Duration retourne un entier représentant le nombre d'années dans la durée.

Vous pouvez connaître le signe de years en vérifiant la propriété sign de la durée.

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

Exemples

Utiliser la propriété `years`

const d1 = Temporal.Duration.from({ years: 1, months: 1 });
const d2 = Temporal.Duration.from({ years: -1, months: -1 });
const d3 = Temporal.Duration.from({ years: 1 });
const d4 = Temporal.Duration.from({ months: 12 });

console.log(d1.years); // 1
console.log(d2.years); // -1
console.log(d3.years); // 1
console.log(d4.years); // 0

// Équilibrer d4
const d4Balanced = d4.round({
  largestUnit: "years",
  relativeTo: Temporal.PlainDate.from("2021-01-01"), // calendrier ISO 8601
});
console.log(d4Balanced.years); // 1
console.log(d4Balanced.months); // 0