Skip to main content

Visit Mozilla.org

Dokumentacja języka JavaScript 1.5:Obiekty:Date:getYear

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

Wycofywany

Spis treści

[edytuj] Podsumowanie

Zwraca rok określonej daty stosownie do czasu lokalnego.

Metoda obiektu: Date
Zaimplementowana w: JavaScript 1.0, NES 2.0

JavaScript 1.3: wycofany; także getYear zwracał rok, będący różnicą odejmowania aktualnego roku minus 1900 określając datę w sposób niedbały.

Wersja ECMA: ECMA-262

[edytuj] Składnia

getYear()

[edytuj] Parametry

Brak.

[edytuj] Opis

Metoda getYear nie była długo używana, ponieważ zastąpiono ją metodą getFullYear.

Metoda getYear zwraca rok minus 1900; tak więc:

  • Dla roczników powyżej roku 2000, wartość zwracana przez getYear wynosi 100 lub więcej. przykładowo, jeśli mamy rok 2026, getYear zwróci 126.
  • Dla lat pomiędzy i włącznie z rokiem 1900 i 1999, wartość zwracana przez getYear jest pomiędzy 0 a 99. Na przykład, jeśli mamy rok 1976, getYear zwróci 76.
  • Dla lat przed 1900 lub powyżej 1999, wartość zwracana przez getYear jest mniejsza niż 0. Na przykład, jeśli mamy rok 1800, getYear zwróci -100.

Aby móc korzystać z lat przed i po roku 2000, powinieneś użyć metody getFullYear zawierającej getYear, która rok potrafi określić w pełni.

[edytuj] Kompatybilność wsteczna

[edytuj] JavaScript 1.2 i wersje wcześniejsze

Metoda getYear zwraca jeden z dwóch formatów określających rok daty, 2-cyfrowy lub 4-cyfrowy:

  • Dla roczników pomiędzy i włącznie rokiem 1900 a 1999, wartość zwracana przez getYear jest pomiędzy 0 a 99. Na przykład, jeśli mamy rok 1976, getYear zwróci 76.
  • Dla roczników przed 1900 lub powyżej 1999, wartość zwracana przez getYear jest cztero-cyfrowa. Na przykład, jeśli mamy rok 1856, wartość zwraca wynosi 1856. Jeśli mamy rok 2026, wartość zwracana wynosi 2026.

[edytuj] Przykłady

[edytuj] Przykład: Lata pomiędzy 1900 i 1999

Druga instrukcja przydziela wartość 95 do zmiennej year. 

Xmas = new Date("December 25, 1995 23:15:00")
year = Xmas.getYear() // zwraca 95

[edytuj] Przykład: Lata powyżej 1999

Druga instrukcja przydziela wartość 100 do zmiennej year. 

Xmas = new Date("December 25, 2000 23:15:00")
year = Xmas.getYear() // zwraca 100

[edytuj] Przykład: Lata powyżej 1900

Druga instrukcja przydziela wartość -100 do zmiennej year. 

Xmas = new Date("December 25, 1800 23:15:00")
year = Xmas.getYear() // zwraca -100

[edytuj] Przykład: Ustawienie i pobieranie lat pomiędzy 1900 i 1999

Druga instrukcja przydziela wartość 95 do zmiennej year, reprezentując rok 1995. 

Xmas.setYear(95)
year = Xmas.getYear() // zwraca 95

[edytuj] Zobacz także

getFullYear, getUTCFullYear, setYear

Źródło: "http://developer.mozilla.org/pl/docs/Dokumentacja_j%C4%99zyka_JavaScript_1.5:Obiekty:Date:getYear"