Obiekt Date

Składnia:

zmienna = new Date();

lub

zmienna = new Date(rok,miesiac,dzien,godz,min,sek,milisek);

lub

zmienna = new Date(liczba);

Obiekt Date służy do przechowywania informacji dotyczących daty i godziny oraz pozwala na manipulacje tymi informacjami.



Metody obiektu Date:


Metody obiektu Date

zmiennaDate.getDate();
zmiennaDate.getUTCDate();

Zwraca numer dnia w miesiącu zawarty w zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC).

zmiennaDate.getDay();
zmiennaDate.getUTCDay();

Zwraca numer dnia w tygodniu zawarty w zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC).
Wartość zwrotna mieści się w zakresie od 0 do 6, gdzie:


zmiennaDate.getMonth();
zmiennaDate.getUTCMonth();

Zwraca numer miesiąca zawarty w zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC).

zmiennaDate.getYear();
zmiennaDate.getFullYear();
zmiennaDate.getUTCFullYear();

Zwraca rok zawarty w zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC).
W przeglądarce Internet Explorer metoda getYear zwraca rok w formacie dwucyfrowym dla XX wieku, natomiast w pozostałych przypadkach (również rok 2000) w formacie czterocyfrowym.

W przeglądrce Netscape metoda ta zwraca rok minus 1900 czyli:
Metoda getYear jest przestarzała, pochodząca z zamierzchłych czasów XX wieku, a my przecież żyjemy w XXI wieku.
Z tego powodu, jak również ze względu na różnice pomiędzy przeglądarkami zdecydowanie zalecam stosowanie dwóch pozostałych metod (getFullYear, getUTCFullYear), które zwracają rok w formacie czterocyfrowym i są interpretowane tak samo przez wszystkie przeglądarki.

zmiennaDate.getHours();
zmiennaDate.getUTCHours();

Zwraca godzinę zawartą w zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC). Wartość zwrotna mieści się w zakresie od 0 do 23.

zmiennaDate.getMinutes();
zmiennaDate.getUTCMinutes();

Zwraca minuty zawarte w zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC). Wartość zwrotna mieści się w zakresie od 0 do 59.

zmiennaDate.getSeconds();
zmiennaDate.getUTCSeconds();

Zwraca sekundy zawarte w zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC). Wartość zwrotna mieści się w zakresie od 0 do 59.

zmiennaDate.getMilliseconds();
zmiennaDate.getUTCMilliseconds();

Zwraca milisekundy zawarte w zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC). Wartość zwrotna mieści się w zakresie od 0 do 999.

zmiennaDate.getTime();

Zwraca liczbę milisekund pomiędzy datą i godziną zawartą w zmiennejDate, a datą 1 styczeń 1970 godz 00:00:00.

zmiennaDate.getTimezoneOffset();

Zwraca przesunięcie czasowe pomiędzy czasem uniwersalnym (UTC lub GMT), a czasem lokalnym.
Wartość zwrotna stanowi ilość minut w przesunięciu czasowym.
Przesunięcie czasowe zależy od ustawienia strefy czasowej na komputerze użytkownika. Przesunięcie to zależy również od tego, czy data przechowywana w zmiennejDate zawiera się w okresie letnim czy zimowym.

Na przykład:
Dla komputera z ustawioną strefą czasową dla Warszawy wartość zwrotna wyniesie
w okresie letnim -120
w okresie zimowym -60

Dla komputera z ustawioną strefą czasową dla Nowego Jorku wartość zwrotna wyniesie
w okresie letnim 240
w okresie zimowym 300

zmiennaDate.setTime(liczba);

Ustawia datę i czas zawarty w zmiennejDate, gdzie liczba stanowi ilość milisekund pomiędzy ustawianą datą i godziną, a datą 1 styczeń 1970 godz 00:00:00.

zmiennaDate.setDate(liczba);
zmiennaDate.setUTCDate(liczba);

Ustawia numer dnia w miesiącu dla zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC).

zmiennaDate.setMonth(liczba);
zmiennaDate.setUTCMonth(liczba);

Ustawia numer miesiąca dla zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC).

zmiennaDate.setYear(liczba);
zmiennaDate.setFullYear(liczba);
zmiennaDate.setUTCFullYear(liczba);

Ustawia rok dla zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC).
W przypadku metody setYear liczba jest to rok ustawiany minus 1900. Ze względu na przyczyny omawiane w metodzie getYear, zdecydowanie zalecam używanie pozostałych dwóch metod, gdzie jako argument podstawia się rok w formacie czterocyfrowym.

zmiennaDate.setHours(liczba);
zmiennaDate.setUTCHours(liczba);

Ustawia godzinę dla zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC).

zmiennaDate.setMinutes(liczba);
zmiennaDate.setUTCMinutes(liczba);

Ustawia minuty dla zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC).

zmiennaDate.setSeconds(liczba);
zmiennaDate.setUTCSeconds(liczba);

Ustawia sekundy dla zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC).

zmiennaDate.setMilliseconds(liczba);
zmiennaDate.setUTCMilliseconds(liczba);

Ustawia milisekundy dla zmiennejDate, używając czasu lokalnego lub uniwersalnego (UTC).

zmiennaDate.toLocaleString();
zmiennaDate.toGMTString();
zmiennaDate.toUTCString();

Zwraca zmiennąDate przekonwertowaną do łańcucha znakowego, używając czasu lokalnego lub uniwersalnego (UTC).
Metody toGMTString i toUTCString zwracają tą samą wartość.