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