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-Uhrzeit-Paar im RFC 9557 Format darstellt.

Syntax

js
toString()
toString(options)

Parameter

options Optional

Ein Objekt, das die folgende Eigenschaft enthält:

calendarName Optional

Gibt an, ob die Kalenderannotation ([u-ca=calendar_id]) im Rückgabewert angezeigt werden soll. Mögliche Werte sind:

"auto" (Standard)

Die Kalenderannotation wird einbezogen, wenn der Kalender nicht "iso8601" ist.

"always"

Die Kalenderannotation wird immer einbezogen.

"never"

Die Kalenderannotation wird nie einbezogen. Dies macht den zurückgegebenen String nicht rekonstruierbar zur gleichen Temporal.PlainDateTime Instanz, obwohl der Datumwert gleich bleibt.

"critical"

Die Kalenderannotation wird immer einbezogen und ein kritisches Flag hinzugefügt: [!u-ca=calendar_id]. Nützlich, wenn der String an bestimmte Systeme gesendet wird, aber nicht für Temporal selbst.

fractionalSecondDigits Optional

Entweder eine ganze Zahl von 0 bis 9 oder der String "auto". Der Standardwert ist "auto". Wenn "auto", werden nachfolgende Nullen von den Bruchteilen der Sekunde entfernt. Andernfalls enthält der Bruchteil der Sekunde so viele Ziffern, wie notwendig mit Nullen aufgefüllt oder gerundet werden.

roundingMode Optional

Ein String, der angibt, wie Bruchteile von Sekunden jenseits von fractionalSecondDigits gerundet werden. Siehe Intl.NumberFormat(). Standardmäßig auf "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-Uhrzeit-Paar darstellt. Die Kalenderannotation ist wie angegeben enthalten.

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()

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

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch