Temporal.PlainDate.prototype.year

Die year Zugriffs-Eigenschaft von Temporal.PlainDate-Instanzen gibt eine ganze Zahl zurück, die die Anzahl der Jahre dieses Datums relativ zum Beginn eines kalenderbezogenen Epochjahres darstellt. Sie ist vom Kalender abhängig.

Diese Eigenschaft hat dieselbe Funktion wie das Paar era/eraYear, als eindeutiger Bezeichner eines Jahres in einem Kalender. Gewöhnlich ist das Jahr 1 entweder das erste Jahr der neuesten Ära oder das ISO 8601 Jahr 0001. Da year relativ zum Beginn des Epochjahres und nicht zum Epoche-Datum ist, wird, wenn die Epoche in der Mitte des Jahres liegt, dieses Jahr denselben Wert vor und nach dem Startdatum der Ära haben.

Der Set-Zugriff von year ist undefined. Diese Eigenschaft kann nicht direkt geändert werden. Verwenden Sie die with() Methode, um ein neues Temporal.PlainDate-Objekt mit dem gewünschten neuen Wert zu erstellen.

const date = Temporal.PlainDate.from("2021-07-01"); // ISO 8601 calendar
console.log(date.year); // 2021

const date2 = Temporal.PlainDate.from("-002021-07-01");
console.log(date2.year); // -2021

const date3 = Temporal.PlainDate.from("2021-07-01[u-ca=japanese]");
console.log(date3.year); // 2021; although the Japanese calendar uses eras,
// there's no obvious "default era", so the year is the same as the ISO year

const date4 = Temporal.PlainDate.from("2021-07-01[u-ca=hebrew]");
console.log(date4.year); // 5781; the Hebrew calendar uses the Anno Mundi epoch, which starts in 3761 BC