Temporal.PlainDate.prototype.year

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 year Zugriffseigenschaft von Temporal.PlainDate Instanzen gibt eine ganze Zahl zurück, die die Anzahl der Jahre dieses Datums relativ zum Beginn eines kalenderspezifischen Epochenjahres darstellt. Sie ist abhängig vom Kalender.

Diese Eigenschaft hat die gleiche Funktion wie das Paar era/eraYear als eindeutiger Bezeichner eines Jahres in einem Kalender. Üblicherweise ist das Jahr 1 entweder das erste Jahr der jüngsten Ära oder das ISO 8601 Jahr 0001. Da year relativ zum Beginn des Epochenjahres und nicht zum Epochendatum ist, hat dieses Jahr den gleichen Wert vor und nach dem Startdatum der Ära, falls die Epoche mitten im Jahr liegt.

Der set-Accessor 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.

Beispiele

Verwendung von year

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

Spezifikationen

Specification
Temporal # sec-get-temporal.plaindate.prototype.year

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden