Метод setUTCFullYear

Статья
11/05/2008

Обновлен: Ноябрь 2007

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

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

Аргументы

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

Заметки

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

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

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

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

Пример

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

function SetUTCFullYearDemo(newyear){
   var d, s;                   //Declare variables.
   d = new Date();             //Create Date object.
   d.setUTCFullYear(newyear);  //Set UTC full year.
   s = "Current setting is ";
   s += d.toUTCString(); 
   return(s);                  //Return new setting.
}