Temporal.PlainDate.prototype.toString()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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
optionsOptional-
Ein Objekt mit folgender Eigenschaft:
calendarNameOptional-
Ob die Kalenderannotation (
[u-ca=calendar_id]) im Rückgabewert angezeigt wird. Mögliche Werte sind:"auto"(Standard)-
Schließen Sie die Kalenderannotation ein, wenn der Kalender nicht
"iso8601"ist. "always"-
Immer die Kalenderannotation einfügen.
"never"-
Niemals die Kalenderannotation einfügen. Dadurch wird der zurückgegebene String nicht auf dieselbe
Temporal.PlainDateInstanz wiederherstellbar, obwohl der Datumswert gleich bleibt. "critical"-
Immer die Kalenderannotation einfügen und ein kritisches Flag hinzufügen:
[!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 Kalenderannotation wird wie angegeben eingefügt.
Ausnahmen
RangeError-
Wird ausgelöst, wenn eine der Optionen ungültig ist.
TypeError-
Wird ausgelöst, wenn
optionskein Objekt oderundefinedist.
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 |