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

js
toString()
toString(options)

Parameter

options Optional

Ein Objekt, das die folgende Eigenschaft enthält:

calendarName Optional

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

"auto" (Standard)

Die Kalenderkennung wird eingeschlossen, wenn der Kalender nicht "iso8601" ist. Das Referenzjahr wird eingeschlossen, wenn der Kalender nicht "iso8601" ist.

"always"

Die Kalenderkennung wird immer eingeschlossen. Das Referenzjahr wird ebenfalls immer eingeschlossen.

"never"

Die Kalenderkennung wird niemals eingeschlossen. Dadurch kann der zurückgegebene String nicht wieder in dieselbe Temporal.PlainMonthDay Instanz umgewandelt werden, obwohl der Monat-Tag-Wert unverändert bleibt. Das Referenzjahr wird eingeschlossen, wenn der Kalender nicht "iso8601" ist.

"critical"

Die Kalenderkennung wird immer eingeschlossen, und ein kritischer Hinweis wird hinzugefügt: [!u-ca=calendar_id]. Nützlich beim Versenden des Strings an bestimmte Systeme, aber nicht nützlich für Temporal selbst. Das Referenzjahr wird ebenfalls immer eingeschlossen.

Rückgabewert

Ein String im RFC 9557 Format, der diesen Monat-Tag darstellt. Die Kalenderkennung wird wie angegeben eingeschlossen. Das Referenzjahr wird eingeschlossen, wenn eine Kalenderkennung enthalten ist oder wenn der Kalender nicht "iso8601" ist.

Ausnahmen

RangeError

Ausgelöst, wenn eine der Optionen ungültig ist.

TypeError

Ausgelöst, wenn options kein Objekt oder undefined ist.

Beispiele

Verwendung von toString()

js
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

js
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 proposal
# sec-temporal.plainmonthday.prototype.tostring

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch