Dokumentacja języka JavaScript 1.5:Obiekty:Date:parse
z Mozilla Developer Center, polskiego centrum programistów Mozilli.
Spis treści |
[edytuj] Podsumowanie
Analizuje łańcuch znaków reprezentujący datę i zwraca liczbę milisekund, które upłynęły od 1 stycznia 1970, 00:00:00 czasu lokalnego.
| Metoda obiektu: Date | |
| Statyczna | |
| Zaimplementowana w: | JavaScript 1.0, NEX 2.0 |
| Wersja ECMA: | ECMA-262 |
[edytuj] Składnia
Date.parse(dateString)
[edytuj] Parametry
-
dateString - Łańcuch znaków reprezentujący datę.
[edytuj] Opis
Metoda parse pobiera łańcuch znaków daty (na przykład: "Dec 25, 1995") i zwraca liczbę milisekund, które upłynęły od 1 stycznia 1970, 00:00:00 (czasu lokalnego). Ta funkcja jest przydatna do ustawiania wartości daty w oparciu o wartość łańcucha znaków, przykładowo w połączeniu z metodą setTime oraz obiektem Date.
Dany łańcuch znaków reprezentujący czas, parse zwraca wartość czasu. Akceptuje składnię standardu daty - IETF: "Mon, 25 Dec 1995 13:30:00 GMT". Rozumie on skróty kontynentalnej strefy czasowej US, lecz dla swego głównego zastosowania, używa przesuniętej strefy czasowej, na przykład: "Mon, 25 Dec 1995 13:30:00 GMT+0430" (4 godziny, 30 minut na zachód od południka Greenwich). Jeśli nie określimy strefy czasowej, to jest brana pod uwagę strefa lokalna. GMT i UTC są rozpatrywane równoważnie.
Ponieważ parse jest metodą statyczną obiektu Date, używamy jej stale jako Date.parse(), niż metodę utworzonego przez nas obiektu Date.
[edytuj] Przykłady
[edytuj] Przykład: Zastosowanie parse
Jeśli IPOdate jest istniejącym obiektem Date, możemy ustawić go jako August 9, 1995 w następujący sposób:
IPOdate.setTime(Date.parse("Aug 9, 1995")) ;