Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła