Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
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()

js
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.

js
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

Browser-Kompatibilität

Siehe auch