Temporal.PlainDate.prototype.year
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die year-Accessor-Eigenschaft von Temporal.PlainDate Instanzen gibt eine Ganzzahl zurück, die die Anzahl der Jahre dieses Datums relativ zum Beginn eines kalenderspezifischen Epoche-Jahres darstellt. Sie ist kalender-abhängig.
Diese Eigenschaft hat die gleiche Funktion wie das era/eraYear Paar als eindeutiger Bezeichner eines Jahres in einem Kalender. Normalerweise ist Jahr 1 entweder das erste Jahr der neuesten Epoche oder das ISO 8601 Jahr 0001. Da year relativ zum Beginn des Epoche-Jahres ist, nicht zum Epoche-Datum, hat dieses Jahr denselben Wert vor und nach dem Startdatum der Epoche, wenn die Epoche mitten im Jahr beginnt.
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
Temporal.PlainDateTemporal.PlainDate.prototype.with()Temporal.PlainDate.prototype.add()Temporal.PlainDate.prototype.subtract()Temporal.PlainDate.prototype.eraTemporal.PlainDate.prototype.eraYearTemporal.PlainDate.prototype.yearOfWeekTemporal.PlainDate.prototype.monthTemporal.PlainDate.prototype.day