Temporal.ZonedDateTime.prototype.eraYear

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

Temporal.ZonedDateTime 例項的 eraYear 訪問器屬性返回一個非負整數,表示此日期在紀元內的年份,如果日曆不使用紀元(例如 ISO 8601),則返回 undefined。年份索引通常從 1(更常見)或 0 開始,紀元中的年份可能會隨時間減少(例如,公曆 BCE)。eraeraYear 共同唯一標識日曆中的一個年份,其方式與 year 相同。它取決於日曆

eraYear 的設定訪問器是 undefined。你不能直接更改此屬性。使用 with() 方法建立一個帶有所需新值的新的 Temporal.ZonedDateTime 物件。

有關一般資訊和更多示例,請參閱 Temporal.PlainDate.prototype.eraYear

示例

使用 eraYear

js
const dt = Temporal.ZonedDateTime.from("2021-07-01[America/New_York]"); // ISO 8601 calendar
console.log(dt.eraYear); // undefined

const dt2 = Temporal.ZonedDateTime.from(
  "2021-07-01[America/New_York][u-ca=gregory]",
);
console.log(dt2.eraYear); // 2021

const dt3 = Temporal.ZonedDateTime.from(
  "-002021-07-01[America/New_York][u-ca=gregory]",
);
console.log(dt3.eraYear); // 2022; 0000 is used for the year 1 BC

const dt4 = Temporal.ZonedDateTime.from(
  "2021-07-01[America/New_York][u-ca=japanese]",
);
console.log(dt4.eraYear); // 3

規範

規範
Temporal
# sec-get-temporal.zoneddatetime.prototype.erayear

瀏覽器相容性

另見