JavaScript метод Date.getFullYear()
Определение и применение
JavaScript метод getFullYear() объекта
Date
возвращает числовое значение, которое соответствует году из указанной даты по местному времени.
Для дат между 1000 и 9999 годом возвращаемое значение будет четырёхзначным числом.
Поддержка браузерами
Спецификация: ecma262
Поддерживается во всех основных браузерах с 2015 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
 Chrome |  Edge |  Firefox |  Opera |  Safari | Chrome Android | Firefox for Android | Opera Android |  Safari on iOS |  Samsung Browser |  WebView Android | WebView on iOS | |
getFullYear | 1 | 12 | 1 | 4 | 1 | 18 | 4 | 10.1 | 1 | 1.0 | 4.4 | 1 |
поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31
JavaScript синтаксис
dateObj.getFullYear();Возвращаемое значение и особенности
Возвращается полный год, а не число лет после 1900 года. Год может содержать меньше или больше четырёх цифр и быть отрицательным.
Метод не принимает параметров и не изменяет объект. Для недействительной даты (Invalid Date) возвращается
NaN.
Компонент определяется по местному времени. Для одного момента результат в разных часовых поясах может отличаться.
Вариант getUTCFullYear() читает компонент по UTC.
Спецификация
ECMAScript — Date.prototype.getFullYear(). Метод входит в стандарт начиная с ECMAScript 1.
Примеры, попробуйте сами
Date.getFullYear() — пример 1
Измените исходные значения и нажмите ▶. Сравните результат с комментариями; местное время определяется часовым поясом браузера.
index.html
<p>Результат выполнения выводится в консоль.</p>
main.js
// Компоненты конструктора задают местное время; месяцы нумеруются с 0.
const firstDate = new Date(1914, 6, 28)
const secondDate = new Date(1918, 10, 11)
console.log(firstDate.getFullYear()) // 1914
console.log(secondDate.getFullYear()) // 1918
// Для недействительной даты компонент отсутствует.
console.log(new Date(NaN).getFullYear()) // NaN
Годы от 0 до 99
Сравните конструктор с числовыми аргументами и setFullYear(): они по-разному трактуют годы от 0 до 99.
index.html
<p>Результат выполнения выводится в консоль.</p>
main.js
const date = new Date(20, 0, 1)
console.log(date.getFullYear()) // 1920
date.setFullYear(20)
console.log(date.getFullYear()) // 20