Date.prototype.toJSON()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die Methode toJSON() von Date-Instanzen gibt eine Zeichenfolge zurück, die das Datum im selben ISO-Format wie toISOString() darstellt.
Probieren Sie es aus
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"
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Eine Zeichenfolge, die das angegebene Datum gemäß der Weltzeit im Datums- und Uhrzeitzeichenfolgenformat darstellt, oder null, wenn das Datum ungültig ist. Für gültige Datumswerte entspricht der Rückgabewert dem von toISOString().
Beschreibung
Die Methode wird automatisch von JSON.stringify() aufgerufen, wenn bei der JSON-Serialisierung ein Date-Objekt gefunden wird. Der serialisierte Wert kann anschließend mit dem Konstruktor Date() innerhalb der Reviver-Funktion von JSON.parse() deserialisiert werden.
Die Methode versucht zunächst, ihren this-Wert in einen primitiven Wert umzuwandeln. Dazu ruft sie nacheinander die Methoden [Symbol.toPrimitive]() (mit "number" als Hinweis), valueOf() und toString() auf. Ist das Ergebnis eine nicht endliche Zahl, wird null zurückgegeben. (Dies entspricht im Allgemeinen einem ungültigen Datum, dessen valueOf() den Wert NaN zurückgibt.) Andernfalls wird, wenn der umgewandelte primitive Wert keine Zahl oder eine endliche Zahl ist, der Rückgabewert von this.toISOString() zurückgegeben.
Beachten Sie, dass die Methode nicht prüft, ob der this-Wert ein gültiges Date-Objekt ist. Der Aufruf von Date.prototype.toJSON() für Objekte, die keine Date-Objekte sind, schlägt jedoch fehl, sofern die primitive Zahlendarstellung des Objekts nicht endlich ist oder das Objekt nicht auch eine toISOString()-Methode besitzt.
Beispiele
>Verwendung von 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
Serialisierung und anschließende Deserialisierung
Wenn Sie JSON mit Datumszeichenfolgen parsen, können Sie den Konstruktor Date() verwenden, um daraus wieder die ursprünglichen Datumsobjekte zu erzeugen.
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);
Hinweis:
Die Reviver-Funktion von JSON.parse() muss auf die erwartete Struktur der Daten abgestimmt sein, da die Serialisierung unumkehrbar ist: Eine Zeichenfolge, die ein Datum darstellt, lässt sich nicht von einer gewöhnlichen Zeichenfolge unterscheiden.
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-date.prototype.tojson> |