Date.prototype.toJSON()

Try it

const event = new Date("August 19, 1975 23:15:30 UTC");

const jsonDate = event.toJSON();

console.log(jsonDate);
// Expected output: "1975-08-19T23:15:30.000Z"

console.log(new Date(jsonDate).toUTCString());
// Expected output: "Tue, 19 Aug 1975 23:15:30 GMT"

Cú pháp

toJSON()

Tham số

Không có.

Giá trị trả về

Một chuỗi đại diện cho ngày đã cho theo định dạng chuỗi ngày giờ theo giờ quốc tế, hoặc null khi ngày không hợp lệ. Đối với các ngày hợp lệ, giá trị trả về giống như giá trị của toISOString().

Mô tả

Phương thức toJSON() được tự động gọi bởi JSON.stringify() khi một đối tượng Date được chuyển thành chuỗi. Phương thức này thường nhằm mục đích, theo mặc định, tuần tự hóa hữu ích các đối tượng Date trong quá trình tuần tự hóa JSON, sau đó có thể được giải tuần tự hóa bằng constructor Date() làm reviver của JSON.parse().

Phương thức đầu tiên cố gắng chuyển đổi giá trị this của nó thành giá trị nguyên thủy bằng cách gọi [Symbol.toPrimitive]() (với "number" làm gợi ý), valueOf() và toString() theo thứ tự đó. Nếu kết quả là một số không hữu hạn, null được trả về. (Điều này thường tương ứng với một ngày không hợp lệ, có valueOf() trả về NaN.) Nếu không, nếu giá trị nguyên thủy được chuyển đổi không phải là một số hoặc là một số hữu hạn, giá trị trả về của this.toISOString() được trả về.

Lưu ý rằng phương thức không kiểm tra xem giá trị this có phải là đối tượng Date hợp lệ hay không. Tuy nhiên, việc gọi Date.prototype.toJSON() trên các đối tượng không phải Date sẽ thất bại trừ khi biểu diễn nguyên thủy số của đối tượng là NaN, hoặc đối tượng cũng có phương thức toISOString().

Ví dụ

Sử dụng toJSON()

const jsonDate = new Date(0).toJSON(); // '1970-01-01T00:00:00.000Z'
const backToDate = new Date(jsonDate);

console.log(jsonDate); // 1970-01-01T00:00:00.000Z

Tuần tự hóa khứ hồi

Khi phân tích cú pháp JSON chứa chuỗi ngày, bạn có thể sử dụng constructor Date() để phục hồi chúng thành các đối tượng ngày gốc.

const fileData = {
  author: "Maria",
  title: "Date.prototype.toJSON()",
  createdAt: new Date(2019, 3, 15),
  updatedAt: new Date(2020, 6, 26),
};
const response = JSON.stringify(fileData);

// Imagine transmission through network

const data = JSON.parse(response, (key, value) => {
  if (key === "createdAt" || key === "updatedAt") {
    return new Date(value);
  }
  return value;
});

console.log(data);

Đặc tả kỹ thuật

Tương thích trình duyệt

Xem thêm

• Date.prototype.toLocaleDateString()
• Date.prototype.toTimeString()
• Date.prototype.toUTCString()