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
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. SieheIntl.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 zufractionalSecondDigits
-Werten von0
,3
,6
,9
sind. Wenn angegeben, wirdfractionalSecondDigits
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 oderundefined
ist.
Beispiele
Verwendung 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 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