Temporal.PlainMonthDay.prototype.toString()

Syntax

toString()
toString(options)

Parameter

options Optional

Ein Objekt, das die folgende Eigenschaft enthält:

calendarName Optional

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

"auto" (Standard)

Die Kalenderanmerkung wird hinzugefügt, wenn der Kalender nicht "iso8601" ist. Das Referenzjahr wird einbezogen, wenn der Kalender nicht "iso8601" ist.

"always"

Die Kalenderanmerkung wird immer hinzugefügt. Das Referenzjahr wird ebenfalls immer berücksichtigt.

"never"

Die Kalenderanmerkung wird nie hinzugefügt. Dies macht den zurückgegebenen String nicht auf die gleiche Temporal.PlainMonthDay Instanz rekonstruierbar, obwohl der Monat-Tag-Wert derselbe bleibt. Das Referenzjahr wird einbezogen, wenn der Kalender nicht "iso8601" ist.

"critical"

Die Kalenderanmerkung wird immer hinzugefügt, und es wird ein kritisches Flag hinzugefügt: [!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 berücksichtigt.

Rückgabewert

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

Browser-Kompatibilität

Siehe auch

• Temporal.PlainMonthDay
• Temporal.PlainMonthDay.from()
• Temporal.PlainMonthDay.prototype.toJSON()
• Temporal.PlainMonthDay.prototype.toLocaleString()