Temporal.Duration.prototype.months

Die months Accessor-Eigenschaft von Temporal.Duration Instanzen gibt eine ganze Zahl zurück, die die Anzahl der Monate in der Dauer darstellt.

Sofern die Dauer nicht ausgeglichen ist, können Sie nicht vom Wertebereich ausgehen, aber Sie können das Vorzeichen ermitteln, indem Sie die sign Eigenschaft der Dauer überprüfen. Wenn sie auf eine Einheit über den Monaten ausgeglichen ist, hängt der Wertebereich des absoluten months-Wertes vom Kalender ab (wie viele Monate sich in einem Jahr befinden).

Der Set-Accessor von months ist undefined. Sie können diese Eigenschaft nicht direkt ändern. Verwenden Sie die with() Methode, um ein neues Temporal.Duration Objekt mit dem gewünschten neuen Wert zu erstellen.

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

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