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