Temporal.PlainDate.prototype.toString()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die toString()-Methode von Temporal.PlainDate-Instanzen gibt eine Zeichenkette zurück, die dieses Datum im RFC 9557-Format darstellt.

Syntax

toString()
toString(options)

Parameter

options Optional

Ein Objekt mit der folgenden Eigenschaft:

calendarName Optional

Gibt an, ob die Kalenderanmerkung ([u-ca=calendar_id]) im Rückgabewert angezeigt werden soll. Mögliche Werte sind:

"auto" (Standard): Enthält die Kalenderanmerkung, wenn der Kalender nicht "iso8601" ist.
"always": Enthält immer die Kalenderanmerkung.
"never": Enthält niemals die Kalenderanmerkung. Dies macht die zurückgegebene Zeichenkette nicht auf die gleiche Temporal.PlainDate-Instanz wiederherstellbar, obwohl der Datumswert gleich bleibt.
"critical": Enthält immer die Kalenderanmerkung und fügt ein kritisches Kennzeichen hinzu: [!u-ca=calendar_id]. Nützlich beim Senden der Zeichenkette an bestimmte Systeme, aber nicht nützlich für Temporal selbst.

Rückgabewert

Eine Zeichenkette im RFC 9557-Format, die dieses Datum darstellt. Die Kalenderanmerkung wird wie angegeben einbezogen.

Ausnahmen

RangeError: Wird ausgelöst, wenn eine der Optionen ungültig ist.
TypeError: Wird ausgelöst, wenn options kein Objekt oder undefined ist.

Beispiele

Verwendung von toString()

const date = Temporal.PlainDate.from("2021-08-01");
console.log(date.toString()); // '2021-08-01'

Verwendung von Optionen

const isoDate = Temporal.PlainDate.from({ year: 2021, month: 8, day: 1 });
const date = Temporal.PlainDate.from({
  year: 2021,
  month: 8,
  day: 1,
  calendar: "islamic-umalqura",
});
console.log(isoDate.toString({ calendarName: "auto" })); // '2021-08-01'
console.log(date.toString({ calendarName: "auto" })); // '2582-12-17[u-ca=islamic-umalqura]'
console.log(isoDate.toString({ calendarName: "always" })); // '2021-08-01[u-ca=iso8601]'
console.log(date.toString({ calendarName: "always" })); // '2582-12-17[u-ca=islamic-umalqura]'
console.log(date.toString({ calendarName: "never" })); // '2582-12-17'
console.log(isoDate.toString({ calendarName: "critical" })); // '2021-08-01[!u-ca=iso8601]'
console.log(date.toString({ calendarName: "critical" })); // '2582-12-17[!u-ca=islamic-umalqura]'

Spezifikationen

Specification
Temporal # sec-temporal.plaindate.prototype.tostring