Temporal.Instant.prototype.round()

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

Синтаксис

round(smallestUnit)
round(options)

Параметры

smallestUnit

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

options

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

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

Число (усеченное до целого), представляющее шаг округления в данной smallestUnit. По умолчанию 1. Шаг и smallestUnit должны делить 24 часа без остатка; например, 45 секунд являются делителем 86400 секунд, а 100 минут — делителем 3600 минут. Это немного менее строго, чем в методе round() других классов, которые требуют, чтобы шаг был делителем максимального значения единицы измерения.

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

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

smallestUnit

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

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

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

Исключения

RangeError

Выбрасывается, если какой-либо из параметров недопустим.

Примеры

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

const instant = Temporal.Instant.fromEpochMilliseconds(1000);
const roundedInstant = instant.round("second");
console.log(roundedInstant.epochMilliseconds); // 1000

const instant2 = instant.round("minute");
console.log(instant2.epochMilliseconds); // 0

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

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

См. также

• Temporal.Instant