Temporal.PlainTime.prototype.toString()

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", dann werden abschließende Nullen von den Bruchteilen der Sekunden entfernt. Andernfalls enthält der Bruchteil der Sekundenkomponente so viele Stellen, gepolstert mit Nullen oder gerundet, wie notwendig.

roundingMode Optional

Ein String, der angibt, wie Bruchteile von Sekundenziffern über fractionalSecondDigits hinaus gerundet werden sollen. Siehe Intl.NumberFormat(). Standardmäßig "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") equivalent 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

Ausgelöst, wenn eine der Optionen ungültig ist.

TypeError

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

Browser-Kompatibilität

Siehe auch

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