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
Спецификации
Совместимость с браузерами
| Настольные | Мобильные | Сервер | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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