Функции округления

floor

Возвращает наибольшее округленное число, меньшее или равное x. Округленное число является кратным 1 / 10 * N, или ближайшим числом соответствующего типа данных, если 1 / 10 * N не является точным.

Целочисленные аргументы могут быть округлены с отрицательным аргументом N, при этом при неотрицательном N функция возвращает x, т.е. ничего не делает.

Если округление вызывает переполнение (например, floor(-128, -1)), результат не определен.

Синтаксис

Параметры

• x - Значение для округления. Float*, Decimal* или (U)Int*.
• N . (U)Int*. По умолчанию равно нулю, что означает округление до целого числа. Может быть отрицательным.

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

Округленное число того же типа, что и x.

Примеры

Запрос:

Результат:

Запрос:

Результат:

ceiling

Как floor, но возвращает наименьшее округленное число, большее или равное x.

Синтаксис

Псевдоним: ceil

truncate

Как floor, но возвращает округленное число с наибольшим абсолютным значением, которое имеет абсолютное значение, меньшее или равное абсолютному значению x.

Синтаксис

Псевдоним: trunc.

Пример

Запрос:

round

Округляет значение до заданного числа десятичных знаков.

Функция возвращает ближайшее число заданного порядка. Если входное значение находится на равном расстоянии от двух соседних чисел, функция использует банковское округление для Float* и округляет от нуля для других типов чисел (Decimal*).

Синтаксис

Аргументы

• x — Число для округления. Float*, Decimal* или (U)Int*.
• N — Число десятичных знаков для округления. Целое. По умолчанию равно 0.
  • Если N > 0, функция округляет вправо от десятичной точки.
  • Если N < 0, функция округляет влево от десятичной точки.
  • Если N = 0, функция округляет до ближайшего целого числа.

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

Округленное число того же типа, что и x.

Примеры

Пример с входными данными типа Float:

Пример с входными данными типа Decimal:

Чтобы сохранить конечные нули, включите настройку output_format_decimal_trailing_zeros:

Примеры округления до ближайшего числа:

Банковское округление.

Смотрите также

• roundBankers

roundBankers

Округляет число до заданного десятичного разряда.

Если число округления находится на половине между двумя числами, функция использует банковское округление. Банковское округление — это метод округления дробных чисел. Когда число округления находится на половине между двумя числами, оно округляется до ближайшей четной цифры на заданной десятичной позиции. Например: 3.5 округляется до 4, 2.5 округляется до 2. Это метод округления по умолчанию для чисел с плавающей запятой, определенный в IEEE 754. Функция round выполняет то же округление для чисел с плавающей запятой. Функция roundBankers также округляет целые числа тем же образом, например, roundBankers(45, -1) = 40.

В других случаях функция округляет числа до ближайшего целого.

Используя банковское округление, вы можете уменьшить влияние, которое округление чисел оказывает на результаты сложения или вычитания этих чисел.

Например, сумма чисел 1.5, 2.5, 3.5, 4.5 с различным округлением:

• Без округления: 1.5 + 2.5 + 3.5 + 4.5 = 12.
• Банковское округление: 2 + 2 + 4 + 4 = 12.
• Округление до ближайшего целого числа: 2 + 3 + 4 + 5 = 14.

Синтаксис

Аргументы

• N > 0 — Функция округляет число до заданной позиции вправо от десятичной точки. Пример: roundBankers(3.55, 1) = 3.6.

• N < 0 — Функция округляет число до заданной позиции влево от десятичной точки. Пример: roundBankers(24.55, -1) = 20.

• N = 0 — Функция округляет число до целого. В этом случае аргумент можно опустить. Пример: roundBankers(2.5) = 2.

• x — Число для округления. Float*, Decimal* или (U)Int*.

• N — Число десятичных знаков для округления. Целое. По умолчанию равно 0.

  • Если N > 0, функция округляет вправо от десятичной точки.
  • Если N < 0, функция округляет влево от десятичной точки.
  • Если N = 0, функция округляет до ближайшего целого числа.

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

Значение, округленное методом банковского округления.

Примеры

Запрос:

Результат:

Примеры банковского округления:

Смотрите также

• round

roundToExp2

Принимает число. Если число меньше одного, возвращает 0. В противном случае округляет число вниз до ближайшей (целой неположительной) степени двойки.

Синтаксис

Параметры

• num: Число для округления. UInt/Float.

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

• 0, для num $\lt 1$. UInt8.
• num, округленный вниз до ближайшей (целой неположительной) степени двойки. UInt/Float, эквивалентный входному типу.

Пример

Запрос:

Результат:

roundDuration

Принимает число. Если число меньше одного, возвращает 0. В противном случае округляет число вниз до чисел из набора распространенных длительностей: 1, 10, 30, 60, 120, 180, 240, 300, 600, 1200, 1800, 3600, 7200, 18000, 36000.

Синтаксис

Параметры

• num: Число для округления до одного из чисел в наборе распространенных длительностей. UInt/Float.

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

• 0, для num $\lt 1$.
• В противном случае одно из: 1, 10, 30, 60, 120, 180, 240, 300, 600, 1200, 1800, 3600, 7200, 18000, 36000. UInt16.

Пример

Запрос:

Результат:

roundAge

Принимает число в рамках различных распространенных диапазонов человеческого возраста и возвращает максимум или минимум в этом диапазоне.

Синтаксис

Параметры

• age: Число, представляющее возраст в годах. UInt/Float.

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

• Возвращает 0, для $age \lt 1$.
• Возвращает 17, для $1 \leq age \leq 17$.
• Возвращает 18, для $18 \leq age \leq 24$.
• Возвращает 25, для $25 \leq age \leq 34$.
• Возвращает 35, для $35 \leq age \leq 44$.
• Возвращает 45, для $45 \leq age \leq 54$.
• Возвращает 55, для $age \geq 55$.

Тип: UInt8.

Пример

Запрос:

Результат:

roundDown

Принимает число и округляет его вниз до элемента в указанном массиве. Если значение меньше нижнего предела, возвращается нижний предел.

Синтаксис

Параметры

• num: Число для округления вниз. Numeric.
• arr: Массив элементов, до которых округляется age. Array типа UInt/Float.

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

• Число, округленное вниз до элемента в arr. Если значение меньше нижнего предела, возвращается нижний предел. UInt/Float тип, выведенный из типа arr.

Пример

Запрос:

Результат: