Temporal.PlainDate.prototype.era

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 era-Zugriffseigenschaft von Instanzen des Temporal.PlainDate gibt einen kalender-spezifischen Kleinbuchstaben-String zurück, der die Ära dieses Datums darstellt, oder undefined, wenn der Kalender keine Ären verwendet (z. B. ISO 8601). era und eraYear identifizieren zusammen ein Jahr in einem Kalender eindeutig, ebenso wie year. Es ist kalenderabhängig. Für den Gregorianischen Kalender ist es entweder "gregory" oder "gregory-inverse".

Der Set-Zugriff von era 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. Beim Setzen von Ären kann jeder Code einige Aliase haben; zum Beispiel sind "ce" und "ad" gleichwertig mit "gregory", und "bce" und "bc" sind gleichwertig mit "gregory-inverse".

Hinweis: Dieser String ist nicht für die Anzeige an Benutzer gedacht. Verwenden Sie toLocaleString() mit den entsprechenden Optionen, um einen lokalisierten String zu erhalten.

Beispiele

Verwendung von era

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

const date2 = Temporal.PlainDate.from("2021-07-01[u-ca=gregory]");
console.log(date2.era); // gregory

const date3 = Temporal.PlainDate.from("-002021-07-01[u-ca=gregory]");
console.log(date3.era); // gregory-inverse

const date4 = Temporal.PlainDate.from("2021-07-01[u-ca=japanese]");
console.log(date4.era); // reiwa

Ändern von era

Sie können era nur für Kalender festlegen, die diese unterstützen. Beispielsweise hat der ISO 8601-Kalender keine Ären. Beachten Sie, dass Sie era und eraYear zusammen angeben müssen.

js
const date = Temporal.PlainDate.from("2021-07-01[u-ca=gregory]");
const newDate = date.with({ era: "bc", eraYear: 100 });
console.log(newDate.toString()); // -000099-07-01[u-ca=gregory]

const date2 = Temporal.PlainDate.from("2021-07-01[u-ca=japanese]");
const newDate2 = date2.with({ era: "meiji", eraYear: 1 });
console.log(newDate2.toString()); // 1868-07-01[u-ca=japanese]

Spezifikationen

Specification
Temporal proposal
# sec-get-temporal.plaindate.prototype.era

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch