Dokumentacja języka JavaScript 1.5:Obiekty:Date:setUTCFullYear
z Mozilla Developer Center, polskiego centrum programistów Mozilli.
Spis treści |
[edytuj] Podsumowanie
Ustawia pełen rok dla określonej daty stosownie do czasu uniwersalnego.
| Metoda obiektu: Date | |
| Zaimplementowane w: | JavaScript 1.3 |
| Wersja ECMA: | ECMA-262 |
[edytuj] Składnia
setUTCFullYear(yearValue[, monthValue[, dayValue]])
[edytuj] Parametry
-
yearValue - Liczba całkowita określająca numerycznie wartość roku, na przykład: 1995.
-
monthValue - Liczba całkowita pomiędzy 0 a 11, reprezentuje nazwy miesięcy, od stycznia do grudnia.
-
dayValue - Liczba całkowita pomiędzy 1 a 31, reprezentuje dzień miesiąca. Jeśli określimy parametr
dayValue, to musimy także sprecyzowaćmonthValue.
[edytuj] Opis
Jeśli nie określisz parametrów monthValue i dayValue, wartość zwracana metod getMonth i getDate jest w użyciu.
Jeśli Twój parametr jest określony z poza szeregu, setUTCFullYear próbuje zaktualizować informacje o dacie w obiekcie Date. Na przykład, jeśli użyjesz wartości 15 dla monthValue, lata będą wzrastać o 1 (rok + 1), i 3 jest użyta jako miesiąc.
[edytuj] Przykłady
[edytuj] Przykład: Zastosowanie setUTCFullYear
theBigDay = new Date(); theBigDay.setUTCFullYear(1997);