Метод setFullYear

Статья
11/05/2008

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

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

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

Аргументы

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

Заметки

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

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

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

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

Пример

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

function SetFullYearDemo(newyear){
   var d, s;                 //Declare variables.
   d = new Date();           //Create Date object.
   d.setFullYear(newyear);   //Set year.
   s = "Current setting is ";
   s += d.toLocaleString(); 
   return(s);                //Return new date setting.
}