Temporal.PlainYearMonth.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 Instanzen des Objekts Temporal.PlainYearMonth
gibt einen Zeichenfolgenwert zurück, der diesen Jahr-Monat im RFC 9557-Format darstellt.
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)-
Einschließen der Kalenderanmerkung, wenn der Kalender nicht
"iso8601"
ist. Der Referenztag ist eingeschlossen, wenn der Kalender nicht"iso8601"
ist. "always"
-
Immer die Kalenderanmerkung einschließen. Der Referenztag ist ebenfalls immer eingeschlossen.
"never"
-
Die Kalenderanmerkung niemals einschließen. Dadurch ist die zurückgegebene Zeichenkette nicht auf dieselbe
Temporal.PlainYearMonth
-Instanz zurückführbar, obwohl der Jahr-Monat-Wert gleich bleibt. Der Referenztag ist 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 die Zeichenfolge an bestimmte Systeme gesendet wird, aber nicht nützlich für Temporal selbst. Der Referenztag ist ebenfalls immer eingeschlossen.
Rückgabewert
Eine Zeichenfolge im RFC 9557-Format, die diesen Jahr-Monat darstellt. Die Kalenderanmerkung wird wie angegeben eingefügt. Der Referenztag ist 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
nicht ein Objekt oderundefined
ist.
Beispiele
Verwendung von toString()
const ym = Temporal.PlainYearMonth.from({ year: 2021, month: 8 });
console.log(ym.toString()); // '2021-08'
const ym2 = Temporal.PlainYearMonth.from({
year: 4658,
monthCode: "M08",
calendar: "chinese",
});
console.log(ym2.toString()); // '2021-09-07[u-ca=chinese]'
Verwendung von Optionen
const isoYM = Temporal.PlainYearMonth.from({ year: 2021, month: 8 });
const ym = Temporal.PlainYearMonth.from({
year: 4658,
monthCode: "M08",
calendar: "chinese",
});
console.log(isoYM.toString({ calendarName: "auto" })); // '2021-08'
console.log(ym.toString({ calendarName: "auto" })); // '2021-09-07[u-ca=chinese]'
console.log(isoYM.toString({ calendarName: "always" })); // '2021-08-01[u-ca=iso8601]'
console.log(ym.toString({ calendarName: "always" })); // '2021-09-07[u-ca=chinese]'
console.log(isoYM.toString({ calendarName: "never" })); // '2021-08'
console.log(ym.toString({ calendarName: "never" })); // '2021-09-07'
console.log(isoYM.toString({ calendarName: "critical" })); // '2021-08-01[!u-ca=iso8601]'
console.log(ym.toString({ calendarName: "critical" })); // '2021-09-07[!u-ca=chinese]'
Spezifikationen
Specification |
---|
Temporal proposal # sec-temporal.plainyearmonth.prototype.tostring |
Browser-Kompatibilität
Loading BCD table