JavaScript метод Date.setFullYear()

Определение и применение

JavaScript метод setFullYear() объекта Date устанавливает полный год для указанной даты по местному времени. Метод возвращает количество миллисекунд между 1 января 1970 00:00: 00 UTC и обновленной датой.

Поддержка браузерами

Метод	Chrome	Firefox	Opera	Safari	IExplorer	Edge
`setFullYear()`	Да	Да	Да	Да	Да	Да

JavaScript синтаксис:

dateObj.setFullYear(yearValue);
dateObj.setFullYear(yearValue, monthValue);
dateObj.setFullYear(yearValue, monthValue, dateValue);

yearValue - Integer
monthValue - Integer
dateValue - Integer

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

ECMAScript 1st Edition (ECMA-262). Реализовано в JavaScript 1.0.

Значения параметров

Параметр	Описание
yearValue	Целое число, определяющее числовое значение года, например, 2019. Обязательный параметр.
monthValue	Целое число от 0 до 11, представляющее месяцы с января по декабрь. Необязательный параметр.
dateValue	Целое число от 1 до 31, представляющее день месяца. Если вы указываете значение этого параметра, убедитесь в том, что значение параметра, определяющего месяц тоже указано. Необязательный параметр.

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

Если указанный параметр находится за пределами ожидаемого диапазона, то метод setFullYear() пытается соответствующим образом обновить другие параметры и информацию о дате в объекте Date. Например, если для значения месяца указано значение 12, то в этом случае значение года будет увеличено на 1, а для месяца будет использовано значение 0.

Пример использования

let someDay = new Date("February 14, 2019 12:00:00"); // создаем объект Date (передаем строковый аргумент, определяющий дату)
console.log(someDay); // Thu Feb 14 2019 12:00:00 GMT+0300 (Москва, стандартное время)

!!! вызовы в примере происходят к первоначальному значению, а не поочередно

someDay.setFullYear(2020); // устанавливает полный год для указанной даты по местному времени
console.log(someDay); // Fri Feb 14 2020 12:00:00 GMT+0300 (Москва, стандартное время)

someDay.setFullYear(2020, 6); // устанавливает полный год для указанной даты по местному времени
console.log(someDay); // Tue Jul 14 2020 12:00:00 GMT+0300 (Москва, стандартное время)

someDay.setFullYear(2020, 7, 15); // устанавливает полный год для указанной даты по местному времени
console.log(someDay); // Sat Aug 15 2020 12:00:00 GMT+0300 (Москва, стандартное время)

someDay.setFullYear(2020, 12); // устанавливает полный год для указанной даты по местному времени
console.log(someDay); // Thu Jan 14 2021 12:00:00 GMT+0300 (Москва, стандартное время)

JavaScript Date