Date.prototype.setUTCFullYear()

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

Попробуйте

const event = new Date("December 31, 1975 23:15:30 GMT-3:00");

console.log(event.getUTCFullYear());
// Expected output: 1976

console.log(event.toUTCString());
// Expected output: "Thu, 01 Jan 1976 02:15:30 GMT"

event.setUTCFullYear(1975);

console.log(event.toUTCString());
// Expected output: "Wed, 01 Jan 1975 02:15:30 GMT"

Синтаксис

setUTCFullYear(yearValue)
setUTCFullYear(yearValue, monthValue)
setUTCFullYear(yearValue, monthValue, dateValue)

Параметры

yearValue

Целое число, представляющее год. Например, 1995.

monthValue Необязательный

Целое число, представляющее месяц: 0 для января, 1 для февраля и так далее.

dateValue Необязательный

Целое число от 1 до 31, представляющее день месяца. Если вы указываете dateValue, вы также должны указать monthValue.

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

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

Описание

Если вы не указываете параметры monthValue и dateValue, используются значения, возвращаемые методами getUTCMonth() и getUTCDate().

Если указанный вами параметр выходит за пределы ожидаемого диапазона, setUTCFullYear() пытается обновить другие параметры и информацию о дате в объекте Date соответствующим образом. Например, если вы указываете 15 для monthValue, год увеличивается на 1 (yearValue + 1), а для месяца используется 3.

Примеры

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

const theBigDay = new Date();
theBigDay.setUTCFullYear(1997);

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

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

См. также

• Date.prototype.getUTCFullYear()
• Date.prototype.setFullYear()