CKTIS / JavaScript
Date.parse: tekst daty na znacznik czasu
Date.parse konwertuje tekst daty na liczbę milisekund od epoki albo zwraca NaN, gdy tekst nie jest rozpoznany lub jest poza zakresem.
Wersja: ECMAScript 1 onward; current date-time string rules; example target: Node.js 24.22.2
Składnia
Date.parse(dateString)Date.parse(string) najpierw konwertuje argument do tekstu, a następnie zwraca wartość czasu w milisekundach od epoki. Standardowy format date-time to odmiana ISO 8601, na przykład 2024-02-29T12:30:00+02:00. Sama data, jak 2024-02-29, jest interpretowana jako UTC; data z czasem bez offsetu jest interpretowana w lokalnej strefie czasowej.
Niepoprawny tekst lub wartość poza zakresem TimeClip ±8.64e15 daje NaN, a nie wyjątek. Konwersja argumentu do tekstu może jednak rzucić, na przykład dla Symbol. Format generowany przez toISOString() musi być obsługiwany; dla dat z zerowymi milisekundami wymagane są też formaty toString() i toUTCString(). Obsługa innych formatów zależy od implementacji.
Do wymiany danych używaj pełnego formatu ISO z Z lub jawnym offsetem, zamiast niejednoznacznych lokalnych zapisów. Date.parse istnieje od pierwszej edycji ECMAScript; reguły daty bez offsetu zostały doprecyzowane w późniejszych edycjach.
Przykłady
const dateOnly = Date.parse("2024-02-29");
const withOffset = Date.parse("2024-02-29T12:30:00+02:00");
console.log(dateOnly, new Date(dateOnly).toISOString());
console.log(withOffset, new Date(withOffset).toISOString());
console.log(Number.isNaN(Date.parse("not a date")));Wynik
1709164800000 2024-02-29T00:00:00.000Z 1709202600000 2024-02-29T10:30:00.000Z true