Visit Mozilla.org

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

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


Spis treści

[edytuj] Podsumowanie

Ustawia kompletny rok dla określonej daty stosownie do czasu lokalnego.

Metoda obiektu: Date
Zaimplementowana w: JavaScript 1.3
Wersja ECMA: ECMA-262

[edytuj] Składnia

setFullYear(yearValue[, monthValue[, dayValue]])

[edytuj] Parametry

yearValue 
Liczba całkowita określająca wartość numeryczną roku, na przykład; 1995.
monthValue 
Liczba całkowita z przedziału od 0 do 11 (reprezentująca miesiące od stycznia do grudnia).
dayValue 
Liczba całkowita z przedziału od 1 do 31, reprezentująca dzień miesiąca. Jeśli określimy parametr dayValue, to musimy także określić monthValue.

[edytuj] Opis

Jeśli nie określimy parametrów monthValue i dayValue, są używane wartości zwracane przez metody getMonth i getDate.

Jeżeli określony parametr jest poza oczekiwanym zakresem, setFullYear próbuje zaktualizować informacje o dacie w obiekcie Date. Przykładowo, jeśli określimy wartość 15 dla monthValue, rok zostanie zwiększony o 1 (rok+1) i 3 3 zostanie użyta dla miesięcy.

[edytuj] Przykłady

[edytuj] Przykład: Zastosowanie setFullYear

theBigDay = new Date();
theBigDay.setFullYear(1997);

[edytuj] Zobacz także

getUTCFullYear, setUTCFullYear, setYear