Temporal.PlainDate.prototype.year

Свойство-аксессор year экземпляров Temporal.PlainDate возвращает целое число, представляющее количество лет этой даты относительно начала эры, специфичной для календаря. Это свойство выполняет ту же функцию, что и пара era/eraYear, являясь уникальным идентификатором года в календаре. Оно зависит от календаря.

Значение

Обычно год 1 — это либо первый год последней эры, либо год ISO 8601 0001. Поскольку year относится к началу эры года, а не к дате эры, если эра находится в середине года (известно, что это происходит только для календаря japanese), этот год будет иметь то же значение year до и после даты начала эры (для календаря japanese, year совпадает с годом ISO 8601).

Все указанные календари имеют арифметические годы, полностью определенные спецификацией.

• Следующие календари имеют тот же начальный год эры, что и ISO 8601: chinese, dangi, gregory, japanese, в которых year: 1 соответствует году ISO 1.
• Календарь buddhist использует буддийскую эру 543 года до н.э., поэтому year: 1 соответствует году ISO -542.
• Календарь coptic использует коптскую эру 284 года н.э., поэтому year: 1 соответствует году ISO 284.
• Календарь ethioaa использует эру Anno Mundi 5493 года до н.э., поэтому year: 1 соответствует году ISO -5492.
• Календарь ethiopic использует эфиопскую эру 8 года н.э., поэтому year: 1 соответствует году ISO 8.
• Календарь hebrew использует эру Anno Mundi 3761 года до н.э., поэтому year: 1 соответствует году ISO -3760.
• Календарь indian использует эру Шака 79 года н.э., поэтому year: 1 соответствует году ISO 79.
• Следующие календари используют эру Хиджры 622 года н.э.: islamic-civil, islamic-tbla, islamic-umalqura, persian, в которых year: 1 соответствует году ISO 622.
• Календарь roc использует эру Минго 1912 года н.э., поэтому year: 1 соответствует году ISO 1912.

Сет-аксессор year — это undefined. Вы не можете изменить это свойство напрямую. Используйте метод with(), чтобы создать новый объект Temporal.PlainDate с желаемым новым значением.

Примеры

Использование 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

Спецификации

Совместимость с браузерами

См. также

• Temporal.PlainDate
• Temporal.PlainDate.prototype.with()
• Temporal.PlainDate.prototype.add()
• Temporal.PlainDate.prototype.subtract()
• Temporal.PlainDate.prototype.era
• Temporal.PlainDate.prototype.eraYear
• Temporal.PlainDate.prototype.yearOfWeek
• Temporal.PlainDate.prototype.month
• Temporal.PlainDate.prototype.day