Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Date.prototype.getFullYear: lokalny pełny rok

getFullYear zwraca pełny numer roku obliczony w lokalnej strefie czasowej, bez historycznego offsetu 1900.

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

Składnia

date.getFullYear()

date.getFullYear() zwraca lokalny rok jako Number, na przykład 2024. W przeciwieństwie do przestarzałego getYear() nie odejmuje 1900. Strefa czasowa ma znaczenie blisko granicy roku; do roku w UTC użyj getUTCFullYear(). Rok 0 i lata ujemne są dozwolone w modelu czasu ECMAScript.

Metoda nie przyjmuje argumentów, nie zmienia daty i ignoruje dodatkowe argumenty. Dla niepoprawnego Date zwraca NaN. Receiver bez wewnętrznego stanu Date, na przykład Date.prototype.getFullYear.call({}), powoduje TypeError.

Używaj jej do grupowania i wyświetlania lokalnego roku, pamiętając, że sam numer roku bez miesiąca, dnia i strefy nie identyfikuje chwili. Metoda istnieje od ECMAScript 1.

Przykłady

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

Wynik

1999
2000 11 31
true

Źródła