MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

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 6 (ECMA-262)
Определение 'Date.prototype.setFullYear' в этой спецификации.
Кандидат в рекомендации  

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

Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка (Да) (Да) (Да) (Да) (Да)
Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка (Да) (Да) (Да) (Да) (Да) (Да)

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

Метки документа и участники

 Внесли вклад в эту страницу: kirilloid, Mingun
 Обновлялась последний раз: kirilloid,