Date.prototype.setUTCFullYear()
Сводка
Метод setUTCFullYear()
устанавливает полный год указанной даты по всемирному координированному времени.
Синтаксис
dateObj.setUTCFullYear(yearValue[, monthValue[, dayValue]])
Параметры
yearValue
-
Целое число, определяющее значение года, например, 1995.
monthValue
-
Необязательный параметр. Целое число от 0 до 11, представляющее месяцы от января до декабря.
dayValue
-
Необязательный параметр. Целое число от 1 до 31, представляющее день месяца. Если вы определите параметр
dayValue
, вы также должны определить параметрmonthValue
.
Описание
Если вы не определите значения параметров monthValue
и dayValue
, будут использоваться значения, возвращаемые методами getUTCMonth()
и getUTCDate()
.
Если значение определяемого параметра будет выходить за пределы ожидаемого диапазона, метод setUTCFullYear()
попытается соответственно обновить другие параметры и информацию о дате в объекте Date
. Например, если в качестве monthValue
передать значение 15, год увеличится на 1 (yearValue + 1
), а в качестве месяца будет использоваться значение 3.
Примеры
Пример: использование метода setUTCFullYear()
js
var theBigDay = new Date();
theBigDay.setUTCFullYear(1997);
Спецификации
Спецификация | Статус | Комментарии |
---|---|---|
ECMAScript 1-е издание. | Стандарт | Изначальное определение. Реализована в JavaScript 1.3. |
ECMAScript 5.1 (ECMA-262) Определение 'Date.prototype.setUTCFullYear' в этой спецификации. |
Стандарт | |
ECMAScript 2015 (6th Edition, ECMA-262) Определение 'Date.prototype.setUTCFullYear' в этой спецификации. |
Стандарт |
Совместимость с браузерами
BCD tables only load in the browser