Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Date.prototype.getFullYear: celý místní rok

getFullYear vrací celé číslo roku vypočtené v místním čase, bez historického posunu 1900.

Verze: ECMAScript 1 onward; example target: Node.js 24.22.2

Syntaxe

date.getFullYear()

date.getFullYear() vrací místní rok jako Number, například 2024. Na rozdíl od zastaralého getYear() neodečítá 1900. U hranice roku záleží na pásmu; pro rok UTC použijte getUTCFullYear(). Rok 0 a záporné roky časový model ECMAScript dovoluje.

Metoda nemá argumenty, datum nemění a další argumenty ignoruje. Pro neplatný Date vrací NaN. Receiver bez interního stavu Date, například Date.prototype.getFullYear.call({}), vyvolá TypeError.

Používejte ji pro seskupení či zobrazení místního roku; rok bez měsíce, dne a pásma neurčuje okamžik. Metoda existuje od ECMAScript 1.

Příklady

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()));

Výsledek

1999
2000 11 31
true

Zdroje