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

js
toString()
toString(options)

Parameter

options Optional

Ein Objekt, das die folgende Eigenschaft enthält:

calendarName Optional

Gibt an, ob die Kalenderanmerkung ([u-ca=calendar_id]) im Rückgabewert angezeigt werden soll. 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 niemals ein. Dadurch kann der zurückgegebene String nicht auf dieselbe Temporal.PlainDate-Instanz zurückgeführt werden, obwohl der Datumswert gleich bleibt.

"critical"

Schließt immer die Kalenderanmerkung ein und fügt ein kritisches Kennzeichen hinzu: [!u-ca=calendar_id]. Nützlich beim Senden des Strings an bestimmte Systeme, 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 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()

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

Verwendung von Optionen

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch