Temporal.PlainDateTime.prototype.toString()

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)

Fügen Sie die Kalenderanmerkung hinzu, wenn der Kalender nicht "iso8601" ist.

"always"

Immer die Kalenderanmerkung hinzufügen.

"never"

Niemals die Kalenderanmerkung hinzufügen. Dies führt dazu, dass der zurückgegebene String nicht auf die gleiche Temporal.PlainDateTime Instanz zurückgesetzt werden kann, obwohl der Datumswert derselbe bleibt.

"critical"

Immer die Kalenderanmerkung hinzufügen und ein kritisches Flag hinzufügen: [!u-ca=calendar_id]. Nützlich beim Senden des Strings an bestimmte Systeme, jedoch 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 von Sekunden entfernt. Andernfalls enthält der Bruchteil der Sekundenkomponente so viele Stellen, die bei Bedarf mit Nullen aufgefüllt oder gerundet werden.

roundingMode Optional

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

smallestUnit Optional

Ein String, der die kleinste Einheit angibt, die in die Ausgabe aufgenommen 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 darstellt. Die Kalenderanmerkung wird wie angegeben eingebunden.

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