Temporal.PlainDateTime.prototype.toString()

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)

Schließt die Kalenderannotation ein, wenn der Kalender nicht "iso8601" ist.

"always"

Schließt immer die Kalenderannotation ein.

"never"

Schließt die Kalenderannotation niemals ein. Dadurch kann der zurückgegebene String nicht in dieselbe Temporal.PlainDateTime Instanz zurückverwandelt werden, obwohl der Datumswert gleich bleibt.

"critical"

Schließt immer die Kalenderannotation ein und fügt ein kritisches Flag hinzu: [!u-ca=calendar_id]. Nützlich beim Senden des Strings an bestimmte Systeme, aber nicht nützlich für Temporal selbst.

fractionalSecondDigits Optional

Entweder ein Integer von 0 bis 9 oder der String "auto". Standard ist "auto". Wenn "auto", werden nachfolgende Nullen aus den Bruchteilen der Sekunden entfernt. Andernfalls enthält der Bruchteil der Sekundenkomponente so viele Ziffern, aufgefüllt oder gerundet, wie erforderlich.

roundingMode Optional

Ein String, der angibt, wie Bruchteile von Sekundenziffern über fractionalSecondDigits hinaus gerundet werden sollen. Siehe Intl.NumberFormat(). Standard ist "trunc".

smallestUnit Optional

Ein String, der die kleinste Einheit angibt, die in der Ausgabe enthalten sein 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 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()

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

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

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