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 kalenderbezogenen Epoche-Jahres darstellt. Diese Eigenschaft hat die gleiche Funktion wie das Paar era/eraYear als eindeutiger Bezeichner eines Jahres in einem Kalender. Sie ist von Kalendern abhängig.
Wert
Normalerweise ist das Jahr 1 entweder das erste Jahr der letzten Ära oder das ISO 8601 Jahr 0001. Da year relativ zum Beginn des Epoche-Jahres und nicht zum Epoche-Datum ist, hat dieses Jahr, wenn die Epoche zur Mitte des Jahres liegt (nur bekannt bei dem japanischen Kalender), denselben year Wert vor und nach dem Startdatum der Ära (bei dem japanischen Kalender ist year das gleiche wie das ISO 8601 Jahr).
Alle spezifizierten Kalender haben arithmetische Jahre, die vollständig durch die Spezifikation definiert sind.
- Die folgenden Kalender haben dasselbe Epoche-Jahr wie ISO 8601:
chinese,dangi,gregory,japanese, bei denenyear: 1dem ISO-Jahr1entspricht. - Der
buddhistKalender verwendet die Buddhistische Epoche von 543 v. Chr., sodassyear: 1dem ISO-Jahr-542entspricht. - Der
copticKalender verwendet die Koptische Epoche von 284 n. Chr., sodassyear: 1dem ISO-Jahr284entspricht. - Der
ethioaaKalender verwendet die Anno Mundi Epoche von 5493 v. Chr., sodassyear: 1dem ISO-Jahr-5492entspricht. - Der
ethiopicKalender verwendet die Äthiopische Epoche von 8 n. Chr., sodassyear: 1dem ISO-Jahr8entspricht. - Der
hebrewKalender verwendet die Anno Mundi Epoche von 3761 v. Chr., sodassyear: 1dem ISO-Jahr-3760entspricht. - Der
indianKalender verwendet die Śaka Epoche von 79 n. Chr., sodassyear: 1dem ISO-Jahr79entspricht. - Die folgenden Kalender verwenden die Hijri Epoche von 622 n. Chr.:
islamic-civil,islamic-tbla,islamic-umalqura,persian, bei denenyear: 1dem ISO-Jahr622entspricht. - Der
rocKalender verwendet die Minguo Epoche von 1912 n. Chr., sodassyear: 1dem ISO-Jahr1912entspricht.
Hinweis:
Für die chinese und dangi Kalender verwendet das CLDR Datenmaterial standardmäßig die Huangdi Epoche von 2637 v. Chr., aber Temporal hat sie aus Einfachheitsgründen auf die ISO 8601 Epoche definiert.
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