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 einen String zurück, der dieses Datum im RFC 9557-Format darstellt.

Syntax

toString()
toString(options)

Parameter

options Optional

Ein Objekt mit der folgenden Eigenschaft:

calendarName Optional

Ob die Kalenderanmerkung ([u-ca=calendar_id]) im Rückgabewert angezeigt wird. Mögliche Werte sind:

"auto" (Standard): Schließt die Kalenderanmerkung ein, wenn der Kalender nicht "iso8601" ist.
"always": Schließt immer die Kalenderanmerkung ein.
"never": Schließt die Kalenderanmerkung nie ein. Dadurch wird der zurückgegebene String nicht auf dieselbe Temporal.PlainDate Instanz zurückführbar, obwohl der Datumswert gleich bleibt.
"critical": Schließt immer die Kalenderanmerkung ein und fügt ein kritisches Flag hinzu: [!u-ca=calendar_id]. Nützlich, wenn der String an bestimmte Systeme gesendet wird, aber nicht nützlich für Temporal selbst.

Rückgabewert

Ein String im RFC 9557-Format, der dieses Datum darstellt. Die Kalenderanmerkung wird wie angegeben eingeschlossen.

Ausnahmen

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

Beispiele

Nutzung von toString()

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

Nutzung 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 proposal # sec-temporal.plaindate.prototype.tostring