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