Temporal.PlainDateTime.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.PlainDateTime-Instanzen gibt einen String zurück, der dieses Datum und diese Uhrzeit 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): Die Kalenderanmerkung wird einbezogen, wenn der Kalender nicht "iso8601" ist.
"always": Die Kalenderanmerkung wird immer einbezogen.
"never": Die Kalenderanmerkung wird niemals einbezogen. Dies macht den zurückgegebenen String nicht wiederherstellbar zur selben Temporal.PlainDateTime-Instanz, obwohl das Datumswert immer noch gleich bleibt.
"critical": Die Kalenderanmerkung wird immer einbezogen und ein kritisches Flag wird hinzugefügt: [!u-ca=calendar_id]. Nützlich, wenn der String an bestimmte Systeme gesendet wird, jedoch nicht für Temporal selbst.

fractionalSecondDigits Optional

Entweder eine ganze Zahl von 0 bis 9 oder der String "auto". Der Standardwert ist "auto". Ist der Wert "auto", werden die nachfolgenden Nullen von den Bruchteilen der Sekunden entfernt. Andernfalls enthält der Bruchteil der Sekundenkomponente so viele Ziffern, vervollständigt mit Nullen oder gerundet, wie nötig.

roundingMode Optional

Ein String, der angibt, wie Bruchteile von Sekunden, die über fractionalSecondDigits hinausgehen, gerundet werden sollen. Siehe Intl.NumberFormat(). Standardmäßig "trunc".

smallestUnit Optional

Ein String, der die kleinste Einheit angibt, die in die Ausgabe einbezogen werden soll. Mögliche Werte sind "minute", "second", "millisecond", "microsecond" und "nanosecond", oder deren Pluralformen, die (außer "minute") äquivalent zu fractionalSecondDigits-Werten von 0, 3, 6, 9 sind. Wenn angegeben, wird fractionalSecondDigits ignoriert.

Rückgabewert

Ein String im RFC 9557-Format, der dieses Datum und diese Uhrzeit darstellt. Die Kalenderanmerkung wird wie angegeben einbezogen.

Ausnahmen

RangeError: Wird ausgelöst, wenn eine der Optionen ungültig ist.
TypeError: Wird ausgelöst, wenn options kein Objekt oder undefined ist.

Beispiele

Nutzung von toString()

const dt = Temporal.PlainDateTime.from("2021-08-01T12:34:56");
console.log(dt.toString()); // '2021-08-01T12:34:56'

Für Beispiele mit gerundeten Zeiten siehe Temporal.PlainTime.prototype.toString(). Für Beispiele zur Anzeige von Kalendern siehe Temporal.PlainDate.prototype.toString().

Spezifikationen

Specification
Temporal # sec-temporal.plaindatetime.prototype.tostring