Temporal.Duration.prototype.months

Die months Zugriffsproperty von Temporal.Duration Instanzen liefert eine Ganzzahl, die die Anzahl der Monate in der Dauer darstellt.

Sofern die Dauer nicht ausgeglichen ist, können Sie den Bereich dieses Wertes nicht annehmen, aber Sie können das Vorzeichen durch Überprüfung der sign Property der Dauer ermitteln. Wenn sie zu einer Einheit oberhalb von Monaten ausgeglichen ist, hängt der Wertebereich des absoluten Werts von months vom Kalender ab (wie viele Monate in einem Jahr sind).

Der Set-Zugriff von months ist undefined. Sie können diese Property 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: "year",
  relativeTo: Temporal.PlainDate.from("2021-01-01"), // ISO 8601 calendar
});
console.log(d4Balanced.months); // 0
console.log(d4Balanced.years); // 1