Temporal.Duration : propriété months

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 months des instances de Temporal.Duration retourne un entier représentant le nombre de mois dans la durée.

Sauf si la durée est équilibrée, vous ne pouvez pas supposer la plage de cette valeur, mais vous pouvez connaître son signe en vérifiant la propriété sign de la durée. Si elle est équilibrée à une unité supérieure aux mois, la valeur absolue de months dépend du calendrier (combien de mois y a-t-il dans une année).

L'accesseur de mutateur de months 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é `months`

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.months); // 1
console.log(d2.months); // -1
console.log(d3.months); // 0
console.log(d4.months); // 12

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