Temporal.Duration : propriété weeks

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 weeks des instances de Temporal.Duration retourne un entier représentant le nombre de semaines 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 semaines, la plage de la valeur absolue de weeks dépend du calendrier (combien de semaines il y a dans un mois ou une année).

Le mutateur d'accesseur de weeks 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é `weeks`

const d1 = Temporal.Duration.from({ weeks: 1, days: 1 });
const d2 = Temporal.Duration.from({ weeks: -1, days: -1 });
const d3 = Temporal.Duration.from({ weeks: 1 });
const d4 = Temporal.Duration.from({ days: 7 });

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

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