Temporal.PlainDate.prototype.year

Die year-Zugriffseigenschaft von Temporal.PlainDate-Instanzen gibt eine ganzzahlige Zahl zurück, die die Anzahl der Jahre dieses Datums relativ zum Beginn eines kalenderspezifischen Epoche-Jahres darstellt. Sie ist kalenderabhängig.

Diese Eigenschaft hat dieselbe Funktion wie das era/eraYear-Paar als einzigartiger Bezeichner eines Jahres in einem Kalender. Normalerweise ist das Jahr 1 entweder das erste Jahr der neuesten Epoche oder das ISO 8601 Jahr 0001. Da year relativ zum Beginn des Epoche-Jahres, nicht zum Epoche-Datum ist, wird für ein Jahr, wenn der Epoche-Beginn in der Mitte des Jahres liegt, der Wert vor und nach dem Startdatum der Epoche gleich sein.

Der Set-Zugriffsmechanismus von year ist undefined. Sie können diese Eigenschaft nicht direkt ändern. 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