Temporal.PlainTime.prototype.round()

Метод round() экземпляров Temporal.PlainTime возвращает новый объект Temporal.PlainTime, представляющий это время, округленное до заданной единицы.

Синтаксис

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