Temporal.PlainTime.prototype.round()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die round()-Methode von Temporal.PlainTime-Instanzen gibt ein neues Temporal.PlainTime-Objekt zurück, das diese Zeit auf die angegebene Einheit gerundet darstellt.

Ein String, der die smallestUnit-Option darstellt. Dies ist eine bequeme Überladung, sodass round(smallestUnit) gleichbedeutend mit 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 validiert werden):

roundingIncrement Optional: Eine Zahl (auf eine ganze Zahl gekürzt), die das Rundungsinkrement in der angegebenen smallestUnit darstellt. Standardmäßig 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 der smallestUnit gerundet werden soll. Siehe Intl.NumberFormat(). Standardmäßig "halfExpand".
smallestUnit: Ein String, der die kleinste Einheit darstellt, die in der Ausgabe enthalten sein soll. Der Wert muss einer der folgenden sein: "hour", "minute", "second", "millisecond", "microsecond", "nanosecond", oder deren Pluralformen. Für größere Einheiten als "nanosecond" werden Bruchteile der smallestUnit gemäß den Einstellungen von 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: Wird ausgelöst, wenn eine der Optionen ungültig ist.

Beispiele

Kleine Einheiten abrunden

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