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


Метод setFullYear

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

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

Аргументы

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

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

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

Заметки

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

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

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

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

Пример

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

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

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

Требования

Версия 3

Применение:

Объект Date

См. также

Ссылки

Метод getFullYear

Метод getUTCFullYear

Метод setUTCFullYear