Temporal.PlainDateTime.prototype.round()

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

Синтаксис

round(smallestUnit)
round(options)

Параметры

smallestUnit

Строка, представляющая опцию smallestUnit. Это удобная перегрузка, поэтому round(smallestUnit) эквивалентно round({ smallestUnit }), где smallestUnit является строкой.

options

Объект, содержащий некоторые или все из следующих свойств (в порядке их получения и проверки):

roundingIncrement Необязательный

Число (усеченное до целого), представляющее приращение округления в заданной smallestUnit. По умолчанию используется 1. Для всех значений smallestUnit, кроме "day", приращение должно быть делителем максимального значения единицы; например, если единица — часы, приращение должно быть делителем 24 и не должно быть самим 24, что означает, что оно может быть 1, 2, 3, 4, 6, 8 или 12. Для "day" приращение должно быть равно 1.

roundingMode Необязательный

Строка, указывающая, как округлять дробную часть smallestUnit. См. Intl.NumberFormat(). По умолчанию используется "halfExpand".

smallestUnit

Строка, представляющая наименьшую единицу, которую следует включить в результат. Значение должно быть одним из следующих: "day", "hour", "minute", "second", "millisecond", "microsecond", "nanosecond" или их формы множественного числа. Для единиц, больших чем "nanosecond", дробные части smallestUnit будут округлены в соответствии с настройками roundingIncrement и roundingMode.

Возвращаемое значение

Новый объект Temporal.PlainDateTime, представляющий эту дату-время, округленную до заданной единицы, где все единицы, меньшие, чем smallestUnit, обнулены.

Исключения

RangeError

Выбрасывается, если любая из опций недействительна.

Примеры

Округление малых единиц

const dt = Temporal.PlainDateTime.from("2021-07-01T12:34:56.123456789");
const nearestMillisecond = dt.round("millisecond");
console.log(nearestMillisecond.toString()); // 2021-07-01T12:34:56.123

const nearestHalfHour = dt.round({
  smallestUnit: "minute",
  roundingIncrement: 30,
});
console.log(nearestHalfHour.toString()); // 2021-07-01T12:30:00

const nextDay = dt.round({ smallestUnit: "day", roundingMode: "ceil" });
console.log(nextDay.toString()); // 2021-07-02T00:00:00

Спецификации

Совместимость с браузерами

См. также

• Temporal.PlainDateTime