Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Date.prototype.toJSON: Date v serializaci JSON

toJSON vrací ISO text pro platné datum, null pro neplatné a automaticky ji volá JSON.stringify.

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

Syntaxe

date.toJSON(key)

date.toJSON(key) obvykle vrací stejný řetězec jako date.toISOString(). JSON.stringify ji volá s klíčem vlastnosti, ale standardní algoritmus argument key nepoužívá. U neplatného Date není číselný převod konečný, takže metoda vrátí null místo RangeError z toISOString().

Metoda je záměrně generická: nejprve získá primitivum s hintem number. Jen pokud jde o Number, který není konečný, vrátí null; jinak vyvolá vlastnost toISOString receiveru. Může tedy fungovat i na objektu jiném než Date. Vyhodí, pokud převod vyhodí nebo toISOString není volatelné či vyhodí.

JSON zachová okamžik jako text UTC, ale ztratí typ Date; po načtení vznikne řetězec. Metoda je standardní od ECMAScript 5 (2009).

Příklady

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));

Výsledek

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

Zdroje