Temporal.PlainMonthDay.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.PlainMonthDay
-Instanzen gibt einen String zurück, der diesen Monat-Tag im RFC 9557 Format darstellt.
Syntax
toString()
toString(options)
Parameter
options
Optional-
Ein Objekt, das die folgende Eigenschaft enthält:
calendarName
Optional-
Gibt an, ob die Kalender-Anmerkung (
[u-ca=calendar_id]
) im Rückgabewert angezeigt werden soll. Mögliche Werte sind:"auto"
(Standard)-
Schließen Sie die Kalender-Anmerkung ein, wenn der Kalender nicht
"iso8601"
ist. Das Referenzjahr wird einbezogen, wenn der Kalender nicht"iso8601"
ist. "always"
-
Immer die Kalender-Anmerkung einfügen. Das Referenzjahr wird ebenfalls immer einbezogen.
"never"
-
Die Kalender-Anmerkung nie einfügen. Dadurch kann der zurückgegebene String nicht in die gleiche
Temporal.PlainMonthDay
-Instanz zurückverwandelt werden, obwohl der Monat-Tag-Wert gleich bleibt. Das Referenzjahr wird einbezogen, wenn der Kalender nicht"iso8601"
ist. "critical"
-
Immer die Kalender-Anmerkung einfügen und eine kritische Kennzeichnung hinzufügen:
[!u-ca=calendar_id]
. Nützlich beim Senden des Strings an bestimmte Systeme, jedoch nicht für Temporal selbst. Das Referenzjahr wird ebenfalls immer einbezogen.
Rückgabewert
Ein String im RFC 9557 Format, der diesen Monat-Tag darstellt. Die Kalender-Anmerkung ist wie angegeben enthalten. Das Referenzjahr wird einbezogen, wenn eine Kalender-Anmerkung enthalten ist oder wenn der Kalender nicht "iso8601"
ist.
Ausnahmen
RangeError
-
Wird ausgelöst, wenn eine der Optionen ungültig ist.
TypeError
-
Wird ausgelöst, wenn
options
kein Objekt oderundefined
ist.
Beispiele
Verwendung von toString()
const md = Temporal.PlainMonthDay.from({ month: 8, day: 1 });
console.log(md.toString()); // '08-01'
const md2 = Temporal.PlainMonthDay.from({
monthCode: "M08",
day: 1,
calendar: "chinese",
});
console.log(md2.toString()); // '1972-09-08[u-ca=chinese]'
Verwendung von Optionen
const isoMD = Temporal.PlainMonthDay.from({ month: 8, day: 1 });
const md = Temporal.PlainMonthDay.from({
monthCode: "M08",
day: 1,
calendar: "chinese",
});
console.log(isoMD.toString({ calendarName: "auto" })); // '08-01'
console.log(md.toString({ calendarName: "auto" })); // '1972-09-08[u-ca=chinese]'
console.log(isoMD.toString({ calendarName: "always" })); // '1972-08-01[u-ca=iso8601]'
console.log(md.toString({ calendarName: "always" })); // '1972-09-08[u-ca=chinese]'
console.log(isoMD.toString({ calendarName: "never" })); // '08-01'
console.log(md.toString({ calendarName: "never" })); // '1972-09-08'
console.log(isoMD.toString({ calendarName: "critical" })); // '1972-08-01[!u-ca=iso8601]'
console.log(md.toString({ calendarName: "critical" })); // '1972-09-08[!u-ca=chinese]'
Spezifikationen
Specification |
---|
Temporal # sec-temporal.plainmonthday.prototype.tostring |