Temporal.PlainTime.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.PlainTime Instanzen gibt einen String zurück, der diese Zeit im RFC 9557 Format darstellt.

Syntax

toString()
toString(options)

Parameter

options Optional

Ein Objekt, das einige oder alle der folgenden Eigenschaften enthält (in der Reihenfolge, in der sie abgerufen und validiert werden):

fractionalSecondDigits Optional: Entweder eine Ganzzahl von 0 bis 9 oder der String "auto". Der Standardwert ist "auto". Wenn "auto", werden die nachfolgenden Nullen in den Bruchteilen von Sekunden entfernt. Andernfalls enthält der Bruchteil der Sekunde so viele Stellen, die bei Bedarf mit Nullen aufgefüllt oder gerundet werden.
roundingMode Optional: Ein String, der angibt, wie die Bruchteile von Sekunden, die über fractionalSecondDigits hinausgehen, gerundet werden sollen. Siehe Intl.NumberFormat(). Der 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 (mit Ausnahme von "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 diese Zeit darstellt.

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 time = Temporal.PlainTime.from("12:34:56");
console.log(time.toString()); // '12:34:56'

Verwendung von Optionen

const time1 = Temporal.PlainTime.from("12:00:00");
console.log(time1.toString()); // '12:00:00'
console.log(time1.toString({ fractionalSecondDigits: 1 })); // '12:00:00.0'
console.log(time1.toString({ smallestUnit: "minute" })); // '12:00'
console.log(time1.toString({ smallestUnit: "nanosecond" })); // '12:00:00.000000000'

const time2 = Temporal.PlainTime.from("12:34:56.123456789");
console.log(time2.toString({ fractionalSecondDigits: 4 })); // '12:34:56.1234'
console.log(
  time2.toString({ fractionalSecondDigits: 4, roundingMode: "halfExpand" }),
); // '12:34:56.1235'

Spezifikationen

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