База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Date.prototype.toJSON: Date в JSON сериализация

toJSON връща ISO текст за валидна дата, null за невалидна и се извиква автоматично от JSON.stringify.

Версия: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2

Синтаксис

date.toJSON(key)

date.toJSON(key) обикновено връща същия низ като date.toISOString(). JSON.stringify го извиква с ключа на свойството, но стандартният алгоритъм не използва key. За невалиден Date числовото преобразуване не е крайно, затова връща null вместо RangeError от toISOString().

Методът нарочно е общ: първо получава примитив с hint number. Само ако той е Number, който не е краен, връща null; иначе извиква свойството toISOString на receiver. Така може да работи върху обект, който не е Date. Хвърля, ако преобразуването хвърли или toISOString не е извикваемо или хвърли.

JSON запазва момента като UTC текст, но губи типа Date; след прочит се получава string. Методът е стандартен от ECMAScript 5 (2009).

Примери

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

Резултат

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

Източници