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
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
Temporal.Duration
Temporal.Duration.prototype.months
Temporal.Duration.prototype.weeks
Temporal.Duration.prototype.days
Temporal.Duration.prototype.hours
Temporal.Duration.prototype.minutes
Temporal.Duration.prototype.seconds
Temporal.Duration.prototype.milliseconds
Temporal.Duration.prototype.microseconds
Temporal.Duration.prototype.nanoseconds