Temporal.PlainTime.prototype.round()

語法

round(smallestUnit)
round(options)

引數

smallestUnit（最小單位）

表示 smallestUnit 選項的字串。這是一個便捷的過載，因此 round(smallestUnit) 等價於 round({ smallestUnit })，其中 smallestUnit 是一個字串。

options

一個包含以下部分或全部屬性的物件（按檢索和驗證的順序）：

roundingIncrement 可選

一個數字（截斷為整數），表示給定 smallestUnit 的舍入增量。預設為 1。增量必須是 smallestUnit 最大值的除數；例如，如果單位是小時，增量必須是 24 的除數，並且不能是 24 本身，這意味著它可以是 1、2、3、4、6、8 或 12。

roundingMode 可選

一個字串，指定如何對 smallestUnit 的小數部分進行四捨五入。參見 Intl.NumberFormat()。預設為 "halfExpand"。

smallestUnit（最小單位）

一個字串，表示輸出中包含的最小單位。該值必須是以下之一："hour"、"minute"、"second"、"millisecond"、"microsecond"、"nanosecond" 或它們的複數形式。對於大於 "nanosecond" 的單位，smallestUnit 的小數部分將根據 roundingIncrement 和 roundingMode 設定進行四捨五入。

返回值

一個新的 Temporal.PlainTime 物件，表示將此時間四捨五入到給定單位，其中所有小於 smallestUnit 的單位都將歸零。

異常

RangeError

如果任何選項無效，則丟擲。

示例

小單位的四捨五入

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

規範

瀏覽器相容性

另見

• Temporal.PlainTime