Сводка

Метод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);

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

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

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

• Date.prototype.getUTCFullYear()
• Date.prototype.setUTCFullYear()
• Date.prototype.setYear()