Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Date.prototype.toJSON: Date v serializácii JSON

toJSON vracia ISO text pre platný dátum, null pre neplatný a automaticky ju volá JSON.stringify.

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

Syntax

date.toJSON(key)

date.toJSON(key) zvyčajne vracia rovnaký reťazec ako date.toISOString(). JSON.stringify ju volá s kľúčom vlastnosti, ale štandardný algoritmus argument key nepoužíva. Pri neplatnom Date nie je číselný prevod konečný, takže metóda vráti null namiesto RangeError z toISOString().

Metóda je zámerne generická: najprv získa primitívum s hintom number. Len ak ide o Number, ktorý nie je konečný, vráti null; inak vyvolá vlastnosť toISOString receivera. Môže teda fungovať aj na objekte inom než Date. Vyhodí, ak prevod vyhodí alebo toISOString nie je volateľné či vyhodí.

JSON zachová okamih ako text UTC, ale stratí typ Date; po načítaní vznikne reťazec. Metóda je štandardná od ECMAScript 5 (2009).

Prí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ýsledok

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

Zdroje