База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Date.prototype.getFullYear: пълна местна година

getFullYear връща пълния номер на годината, изчислен в местно време, без историческото отместване 1900.

Версия: ECMAScript 1 onward; example target: Node.js 24.22.2

Синтаксис

date.getFullYear()

date.getFullYear() връща местната година като Number, например 2024. За разлика от остарелия getYear(), не изважда 1900. Близо до границата на година зоната има значение; за UTC използвайте getUTCFullYear(). Година 0 и отрицателни години са позволени от модела ECMAScript.

Методът няма аргументи, не променя датата и игнорира допълнителни аргументи. За невалиден Date връща NaN. Receiver без вътрешно състояние Date, като Date.prototype.getFullYear.call({}), хвърля TypeError.

Използвайте го за групиране или показване на местна година; година без месец, ден и зона не определя момент. Методът съществува от ECMAScript 1.

Примери

const date = new Date(1999, 11, 31, 12);
console.log(date.getFullYear());

date.setFullYear(2000);
console.log(date.getFullYear(), date.getMonth(), date.getDate());
console.log(Number.isNaN(new Date(NaN).getFullYear()));

Резултат

1999
2000 11 31
true

Източници