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

Syntax

js
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 nachgestellte Nullen von den Bruchteilen der Sekunden entfernt. Andernfalls enthält der Bruchteil der Sekundenkomponente so viele Ziffern, aufgefüllt oder abgerundet nach Bedarf.

roundingMode Optional

Ein String, der angibt, wie die Bruchteile der Sekunden über fractionalSecondDigits hinaus gerundet werden sollen. Siehe Intl.NumberFormat(). Der Standardwert 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 ihre 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 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()

js
const time = Temporal.PlainTime.from("12:34:56");
console.log(time.toString()); // '12:34:56'

Verwendung von Optionen

js
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 proposal
# sec-temporal.plaintime.prototype.tostring

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch