Temporal.PlainDate.prototype.year
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Thuộc tính accessor year của các instance Temporal.PlainDate trả về một số nguyên đại diện cho số năm của ngày này tính từ đầu năm gốc (epoch year) của lịch cụ thể. Thuộc tính này có cùng chức năng với cặp era/eraYear như một định danh duy nhất của một năm trong lịch. Thuộc tính này phụ thuộc vào lịch.
Giá trị
Thông thường năm 1 là năm đầu tiên của kỷ nguyên gần nhất hoặc năm ISO 8601 0001. Vì year là tương đối so với điểm bắt đầu của năm gốc, không phải ngày gốc, nếu gốc nằm ở giữa năm (chỉ biết xảy ra với lịch japanese), thì năm đó sẽ có cùng giá trị year trước và sau ngày bắt đầu kỷ nguyên (đối với lịch japanese, year giống với năm ISO 8601).
Tất cả các lịch được chỉ định đều có năm số học được định nghĩa đầy đủ bởi đặc tả.
- Các lịch sau có cùng năm gốc với ISO 8601:
chinese,dangi,gregory,japanese, trong đóyear: 1tương ứng với năm ISO1. - Lịch
buddhistsử dụng gốc Phật lịch vào năm 543 TCN, vì vậyyear: 1tương ứng với năm ISO-542. - Lịch
copticsử dụng gốc Coptic vào năm 284 CN, vì vậyyear: 1tương ứng với năm ISO284. - Lịch
ethioaasử dụng gốc Anno Mundi vào năm 5493 TCN, vì vậyyear: 1tương ứng với năm ISO-5492. - Lịch
ethiopicsử dụng gốc Ethiopic vào năm 8 CN, vì vậyyear: 1tương ứng với năm ISO8. - Lịch
hebrewsử dụng gốc Anno Mundi vào năm 3761 TCN, vì vậyyear: 1tương ứng với năm ISO-3760. - Lịch
indiansử dụng gốc Śaka vào năm 79 CN, vì vậyyear: 1tương ứng với năm ISO79. - Các lịch sau sử dụng gốc Hijri vào năm 622 CN:
islamic-civil,islamic-tbla,islamic-umalqura,persian, trong đóyear: 1tương ứng với năm ISO622. - Lịch
rocsử dụng gốc Minguo vào năm 1912 CN, vì vậyyear: 1tương ứng với năm ISO1912.
Note:
Đối với các lịch chinese và dangi, dữ liệu CLDR mặc định sử dụng gốc Hoàng Đế vào năm 2637 TCN, nhưng Temporal định nghĩa nó sử dụng gốc ISO 8601 để đơn giản hóa.
Set accessor của year là undefined. Bạn không thể thay đổi thuộc tính này trực tiếp. Sử dụng phương thức with() để tạo một đối tượng Temporal.PlainDate mới với giá trị mới mong muốn.
Ví dụ
>Sử dụng 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
Đặc tả
| Specification |
|---|
| Temporal> # sec-get-temporal.plaindate.prototype.year> |
Tương thích trình duyệt
Xem thêm
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