Поделиться через


Метод setUTCFullYear

Устанавливает значение года в объекте Date, используя время в формате UTC.

function setUTCFullYear(numYear : Number [, numMonth : Number [, numDate : Number]])

Аргументы

  • numYear
    Обязательный. Числовое значение, представляющее год.

  • numMonth
    Необязательный. Числовое значение, представляющее месяц. Значение для января равно 0, значения других месяцев увеличиваются в соответствующем порядке. Необходимо задавать, если задается значение numDate.

  • numDate
    Необязательный. Числовое значение, обозначающее день месяца.

Заметки

Все методы set, принимающие необязательные аргументы, в случае, когда такой аргумент не задан, используют значение, возвращенное соответствующим методом get. Например, если аргумент numMonth является необязательным и не указывается, JScript использует значение, возвращенное методом getUTCMonth.

Кроме того, если значение аргумента превышает верхнюю границу его диапазона или является отрицательным числом, остальные хранящиеся значения изменяются соответственно.

Чтобы установить год с помощью локального времени, используйте метод setFullYear.

Диапазон лет, поддерживаемых в объекте Date, равен приблизительно 285 616 годам в каждую сторону от 1970 года.

Пример

В следующем примере показано использование метода setUTCFullYear.

var dtFirst = new Date();
dtFirst.setUTCFullYear(2007);

var dtSecond = new Date();
// 10 is the value for November. 
dtSecond.setUTCFullYear(2008, 10, 3); 

print (dtFirst.toUTCString());
print (dtSecond.toUTCString());

Требования

Версия 3

Применение:

Объект Date

См. также

Ссылки

Метод getFullYear

Метод getUTCFullYear

Метод setFullYear