Temporal.Duration.prototype.years

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die years Zugriffs-Eigenschaft von Temporal.Duration Instanzen gibt eine Ganzzahl zurück, die die Anzahl der Jahre in der Dauer darstellt.

Sie können das Vorzeichen von years erkennen, indem Sie die sign-Eigenschaft der Dauer überprüfen.

Der Set-Accessor von years 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.

Beispiele

Verwendung von years

js
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

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

Spezifikationen

Specification
Temporal
# sec-get-temporal.duration.prototype.years

Browser-Kompatibilität

Siehe auch