MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

Date.prototype.getYear()

Устарело
Эта возможность была удалена из веб-стандартов. Хотя некоторые браузеры по-прежнему могут поддерживать её, она находится в процессе удаления. Не используйте её ни в старых, ни в новых проектах. Страницы или веб-приложения, использующие её, могут в любой момент сломаться.

Сводка

Метод getYear() возвращает год указанной даты по местному времени. Поскольку метод getYear() не возвращает полный год («проблема 2000 года»), он больше не используется и был заменён методом getFullYear().

Синтаксис

dateObj.getYear()

Параметры

Нет.

Возвращаемое значение

Метод getYear() возвращает год минус 1900; таким образом:

  • Для годов, больших, либо равных 2000, значение, возвращённое методом getYear(), будет равно 100 или выше. Например, если год равен 2026, метод getYear() вернёт 126.
  • Для годов между 1900 и 1999 включительно, значение, возвращённое методом getYear(), лежит между 0 и 99. Например, если год равен 1976, метод getYear() вернёт 76.
  • Для годов, меньших 1900, значение, возвращённое методом getYear(), будем меньше 0. Например, если год равен 1800, метод getYear() вернёт -100.

Чтобы учесть года до и после 2000, вы должны вместо метода getYear() использовать метод getFullYear(), который возвращает полный год.

Обратная совместимость

Поведение в JavaScript 1.2 и ранее

Метод getYear() возвращал 2-х или 4-х значный год:

  • Для годов между 1900 и 1999 включительно, значение, возвращаемое методом getYear(), было годом минус 1900. Например, если год равнялся 1976, возвращаемое значение равнялось 76.
  • Для годов, меньших 1900, либо больших 1999, значение, возвращаемое методом getYear() было четырёхзначным годом. Например, если год равнялся 1856, возвращаемое значение равнялось 1856. Если год равнялся 2026, возвращаемое значение равнялось 2026.

Примеры

Пример: года между 1900 и 1999

Вторая инструкция присваивает значение 95 переменной year.

var Xmas = new Date('December 25, 1995 23:15:00');
var year = Xmas.getYear(); // вернёт 95

Пример: года после 1999

Вторая инструкция присваивает значение 100 переменной year.

var Xmas = new Date('December 25, 2000 23:15:00');
var year = Xmas.getYear(); // вернёт 100

Пример: года до 1900

Вторая инструкция присваивает значение -100 переменной year.

var Xmas = new Date('December 25, 1800 23:15:00');
var year = Xmas.getYear(); // вернёт -100

Пример: установка и получение года между 1900 и 1999

Вторая инструкция присваивает значение 95 переменной year, которое представляет 1995 год.

var Xmas.setYear(95);
var year = Xmas.getYear(); // вернёт 95

Спецификации

Спецификация Статус Комментарии
ECMAScript 1-е издание. Стандарт Изначальное определение. Реализовано в JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
Определение 'Date.prototype.getYear' в этой спецификации.
Стандарт Определён в (информативном) приложении по совместимости.
ECMAScript 6 (ECMA-262)
Определение 'Date.prototype.getYear' в этой спецификации.
Кандидат в рекомендации Определён в (нормативном) приложении по дополнительным возможностям веб-браузеров.

Совместимость с браузерами

Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка (Да) (Да) (Да) (Да) (Да)
Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка (Да) (Да) (Да) (Да) (Да) (Да)

Смотрите также

Метки документа и участники

 Внесли вклад в эту страницу: Mingun
 Обновлялась последний раз: Mingun,