Date.prototype.setYear()

Метод setYear() экземпляров Date устанавливает год для указанной даты в соответствии с местным временем.

Однако то, как устаревший метод setYear() устанавливает значения года, отличается от того, как предпочтительный метод setFullYear() устанавливает значения года — а в некоторых случаях также отличается от того, как new Date() и Date.parse() устанавливают значения года. В частности, если даны двузначные числа, такие как 22 и 61:

• setYear() интерпретирует любое двузначное число как смещение относительно 1900; таким образом, date.setYear(22) приводит к установке значения года в 1922, а date.setYear(61) приводит к установке значения года в 1961. (В противоположность этому, хотя new Date(61, 1) также приводит к установке значения года в 1961, new Date("2/1/22") приводит к установке значения года в 2022; аналогично и для Date.parse()).

• setFullYear() не выполняет специальной интерпретации, а вместо этого использует буквальное двузначное значение «как есть» для установки года; таким образом, date.setFullYear(61) приводит к установке значения года в 0061, а date.setFullYear(22) приводит к установке значения года в 0022.

Из-за этих различий в поведении вы больше не должны использовать устаревший метод setYear(), а вместо этого должны использовать предпочтительный метод setFullYear().

Синтаксис

setYear(yearValue)

Параметры

yearValue

Целое число.

Возвращаемое значение

Изменяет объект Date на месте и возвращает его новую метку времени. Если yearValue является NaN (или другими значениями, которые преобразуются в NaN, такими как undefined), дата устанавливается как Неверная дата (Invalid Date) и возвращается NaN.

Описание

Если yearValue — это число от 0 до 99 (включительно), то год для dateObj устанавливается в 1900 + yearValue. В противном случае год для dateObj устанавливается в yearValue.

Примеры

Использование setYear()

Первые две строки устанавливают год равным 1996. Третья устанавливает год равным 2000.

const theBigDay = new Date();

theBigDay.setYear(96);
theBigDay.setYear(1996);
theBigDay.setYear(2000);

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

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

Смотрите также

• Полифил Date.prototype.setYear в core-js
• Date.prototype.getFullYear()
• Date.prototype.getUTCFullYear()
• Date.prototype.setFullYear()
• Date.prototype.setUTCFullYear()