Date.prototype.setFullYear()

Сводка

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

Синтаксис

dateObj.setFullYear(yearValue[, monthValue[, dayValue]])

Параметры

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

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

Текущее время в миллисекундах для нового значения даты — такое же значение как и у метода getTime() для текущего объекта после вызова setFullYear().

Описание

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

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

Примеры

Пример: использование метода setFullYear()

var theBigDay = new Date();
theBigDay.setFullYear(1997);

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

Спецификация Статус Комментарии
ECMAScript 1-е издание. Стандарт Изначальное определение. Реализована в JavaScript 1.3.
ECMAScript 5.1 (ECMA-262)
Определение 'Date.prototype.setFullYear' в этой спецификации.
Стандарт  
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'Date.prototype.setFullYear' в этой спецификации.
Стандарт  

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

BCD tables only load in the browser

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