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 Kalenderanmerkung ([u-ca=calendar_id]) im Rückgabewert angezeigt werden soll. Mögliche Werte sind:

"auto" (Standard): Fügen Sie die Kalenderanmerkung hinzu, wenn der Kalender nicht "iso8601" ist. Das Referenzjahr wird eingeschlossen, wenn der Kalender nicht "iso8601" ist.
"always": Immer die Kalenderanmerkung einschließen. Das Referenzjahr wird ebenfalls immer eingeschlossen.
"never": Nie die Kalenderanmerkung einschließen. Dadurch kann der zurückgegebene String nicht auf die gleiche Temporal.PlainMonthDay Instanz zurückgeführt werden, obwohl der Monat-Tag-Wert gleich bleibt. Das Referenzjahr wird eingeschlossen, wenn der Kalender nicht "iso8601" ist.
"critical": Immer die Kalenderanmerkung einschließen und ein kritisches Flag hinzufügen: [!u-ca=calendar_id]. Nützlich, wenn der String an bestimmte Systeme gesendet wird, aber nicht nützlich für Temporal selbst. Das Referenzjahr wird ebenfalls immer eingeschlossen.

Ein String im RFC 9557 Format, der diesen Monat-Tag darstellt. Die Kalenderanmerkung wird wie angegeben eingeschlossen. Das Referenzjahr wird eingeschlossen, wenn eine Kalenderanmerkung eingeschlossen 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 oder undefined 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