Spec-Zone.ru › JavaScript

Date.prototype.getYear()

Baseline Ограниченная доступность

Эта функция не является Baseline, так как она не работает в некоторых наиболее широко используемых браузерах.

Устарело: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут по-прежнему поддерживать ее, она уже могла быть удалена из соответствующих веб-стандартов, находится в процессе удаления или сохранена только для целей совместимости. Избегайте ее использования и по возможности обновите существующий код; обратитесь к таблице совместимости внизу этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любой момент.

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

Синтаксис

getYear()

Параметры

Нет.

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

Целое число, представляющее год для данной даты в соответствии с местным временем, минус 1900. Возвращает NaN, если дата недействительна.

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

Этот метод по сути возвращает значение getFullYear() минус 1900. Вместо этого следует использовать getFullYear(), чтобы год был указан полностью.

Примеры

Годы между 1900 и 1999

Второе утверждение присваивает значение 95 переменной year.

const xmas = new Date("1995-12-25");
const year = xmas.getYear(); // returns 95

Годы выше 1999

Второе утверждение присваивает значение 100 переменной year.

const xmas = new Date("2000-12-25");
const year = xmas.getYear(); // returns 100

Годы ниже 1900

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

const xmas = new Date("1800-12-25");
const year = xmas.getYear(); // returns -100

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

Третье утверждение присваивает значение 95 переменной year, представляющее 1995 год.

const xmas = new Date("2015-12-25");
xmas.setYear(95);
const year = xmas.getYear(); // returns 95

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

Спецификация
Спецификация языка ECMAScript® 2027
# sec-date.prototype.getyear

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

Настольные Мобильные Сервер
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet WebView Android WebView on iOS Bun Deno Node.js
getYear
1
12
1
3
1
18
4
10.1
1
1.0
4.4
1
1.0.0
1.0
0.10.0

См. также

  • Polyfill Date.prototype.getYear в core-js
  • es-shims polyfill Date.prototype.getYear
  • Date.prototype.getFullYear()
  • Date.prototype.getUTCFullYear()
  • Date.prototype.setYear()

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getYear

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API