Temporal.PlainTime.prototype.round()

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 round() Methode von Temporal.PlainTime Instanzen gibt ein neues Temporal.PlainTime-Objekt zurück, das diese Zeit auf die angegebene Einheit gerundet darstellt.

Syntax

round(smallestUnit)
round(options)

Parameter

smallestUnit

Ein String, der die smallestUnit Option darstellt. Dies ist eine Komfortüberladung, sodass round(smallestUnit) äquivalent zu round({ smallestUnit }) ist, wobei smallestUnit ein String ist.

options

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

roundingIncrement Optional: Eine Zahl (auf eine Ganzzahl gekürzt), die den Rundungsinkrement in der angegebenen smallestUnit darstellt. Standard ist 1. Das Inkrement muss ein Teiler des Maximalwerts von smallestUnit sein; zum Beispiel, wenn die Einheit Stunden ist, muss das Inkrement ein Teiler von 24 sein und darf nicht 24 selbst sein, was bedeutet, dass es 1, 2, 3, 4, 6, 8 oder 12 sein kann.
roundingMode Optional: Ein String, der angibt, wie der Bruchteil von smallestUnit gerundet wird. Siehe Intl.NumberFormat(). Standardmäßig "halfExpand".
smallestUnit: Ein String, der die kleinste Einheit darstellt, die in die Ausgabe aufgenommen werden soll. Der Wert muss einer der folgenden sein: "hour", "minute", "second", "millisecond", "microsecond", "nanosecond" oder ihre Pluralformen. Für Einheiten größer als "nanosecond" werden die Bruchteile der smallestUnit gemäß den Einstellungen in roundingIncrement und roundingMode gerundet.

Rückgabewert

Ein neues Temporal.PlainTime-Objekt, das diese Zeit auf die angegebene Einheit gerundet darstellt, wobei alle Einheiten, die kleiner als smallestUnit sind, auf null gesetzt werden.

Ausnahmen

RangeError: Tritt auf, wenn eine der Optionen ungültig ist.

Beispiele

Abrunden von kleinen Einheiten

const time = Temporal.PlainTime.from("12:34:56.123456789");
const nearestMillisecond = time.round("millisecond");
console.log(nearestMillisecond.toString()); // 12:34:56.123

const nearestHalfHour = time.round({
  smallestUnit: "minute",
  roundingIncrement: 30,
});
console.log(nearestHalfHour.toString()); // 12:30:00

const nextHour = time.round({ smallestUnit: "hour", roundingMode: "ceil" });
console.log(nextHour.toString()); // 13:00:00

Spezifikationen

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

Browser-Kompatibilität

Siehe auch

Temporal.PlainTime