Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Date.prototype.toJSON: data w serializacji JSON

toJSON zwraca tekst ISO dla poprawnej daty, null dla niepoprawnej i jest automatycznie używana przez JSON.stringify.

Wersja: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2

Składnia

date.toJSON(key)

date.toJSON(key) zwykle zwraca to samo co date.toISOString(). JSON.stringify wywołuje tę metodę i przekazuje klucz właściwości, ale standardowy algorytm nie używa argumentu key. Dla niepoprawnego Date konwersja liczbowa daje wartość niekończoną, więc metoda zwraca null zamiast rzucać RangeError.

Metoda jest celowo generyczna: najpierw pobiera prymityw z hintem number. Tylko gdy jest to niekończony Number, zwraca null; w każdym innym przypadku wywołuje właściwość toISOString receivera. Może więc działać na obiekcie innym niż Date. Rzuca, gdy konwersja rzuci albo toISOString nie jest wywoływalne lub samo rzuca.

W JSON zachowuje chwilę w UTC, ale traci typ Date; po odczycie otrzymujesz string. Metoda jest standardowa od ECMAScript 5 (2009).

Przykłady

const payload = {
  when: new Date("2024-01-02T03:04:05.006Z"),
  missing: new Date(NaN),
};
console.log(JSON.stringify(payload));
console.log(payload.when.toJSON());

const custom = {valueOf: () => 0, toISOString: () => "custom-time"};
console.log(Date.prototype.toJSON.call(custom));

Wynik

{"when":"2024-01-02T03:04:05.006Z","missing":null}
2024-01-02T03:04:05.006Z
custom-time

Źródła