Арифметические функции

Обзор

Арифметические функции работают для любых двух операндов типов UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64, Float32 или Float64.

Перед выполнением операции оба операнда приводятся к типу результата. Тип результата определяется следующим образом (если не указано иначе в документации функций ниже):

Если оба операнда имеют ширину до 32 бит, размер типа результата будет равен размеру следующего более крупного типа, следующего за большим из двух операндов (продвижение размера целого числа). Например, UInt8 + UInt16 = UInt32 или Float32 * Float32 = Float64.
Если один из операндов имеет 64 или более бит, размер типа результата будет таким же, как и у большего из двух операндов. Например, UInt32 + UInt128 = UInt128 или Float32 * Float64 = Float64.
Если один из операндов является знаковым, тип результата также будет знаковым, в противном случае он будет беззнаковым. Например, UInt32 * Int32 = Int64.

Эти правила обеспечивают, что тип результата будет наименьшим типом, который может представить все возможные результаты. Хотя это создает риск переполнений вблизи границы диапазона значений, это обеспечивает быструю обработку расчетов с использованием максимальной нативной ширины целого числа в 64 бита. Это поведение также гарантирует совместимость со многими другими базами данных, которые предоставляют 64-битные целые числа (BIGINT) в качестве наибольшего типа целого числа.

Пример:

SELECT toTypeName(0), toTypeName(0 + 0), toTypeName(0 + 0 + 0), toTypeName(0 + 0 + 0 + 0)

┌─toTypeName(0)─┬─toTypeName(plus(0, 0))─┬─toTypeName(plus(plus(0, 0), 0))─┬─toTypeName(plus(plus(plus(0, 0), 0), 0))─┐
│ UInt8         │ UInt16                 │ UInt32                          │ UInt64                                   │
└───────────────┴────────────────────────┴─────────────────────────────────┴──────────────────────────────────────────┘

Переполнения происходят так же, как и в C++.

abs

Представлено в: v1.1

Выдает абсолютное значение x. Не влияет, если x имеет беззнаковый тип. Если x имеет знаковый тип, возвращает беззнаковое число.

Синтаксис

abs(x)

Аргументы

x — Значение, для которого требуется получить абсолютное значение

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

Абсолютное значение x

Примеры

Пример использования

SELECT abs(-0.5)

0.5

byteSwap

Представлено в: v23.10

Меняет порядок байтов целого числа, т.е. изменяет его эндIANность.

Следующий пример можно разобрать следующим образом:

Преобразовать десятичное целое число в его эквивалентный шестнадцатеричный формат в формате big-endian, т.е. 3351772109 -> C7 C7 FB CD (4 байта)
Обратить порядок байтов, т.е. C7 C7 FB CD -> CD FB C7 C7
Преобразовать результат обратно в целое число, предполагая big-endian, т.е. CD FB C7 C7 -> 3455829959 Одно из применений этой функции заключается в реверсировании IPv4:

┌─toIPv4(byteSwap(toUInt32(toIPv4('205.251.199.199'))))─┐
│ 199.199.251.205                                       │
└───────────────────────────────────────────────────────┘

Синтаксис

byteSwap(x)

Аргументы

x — Целочисленное значение. (U)Int*

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

Возвращает x с измененными байтами. (U)Int*

Примеры

Пример использования

SELECT byteSwap(3351772109)

3455829959

8 бит

SELECT byteSwap(54)

16 бит

SELECT byteSwap(4135)

32 бита

SELECT byteSwap(3351772109)

3455829959

64 бита

SELECT byteSwap(123294967295)

18439412204227788800

divide

Представлено в: v1.1

Вычисляет частное двух значений a и b. Тип результата всегда Float64. Целочисленное деление обеспечивается функцией intDiv.

примечание

Деление на 0 возвращает inf, -inf или nan.

Синтаксис

divide(x, y)

Аргументы

x — Делимое - y — Делитель

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

Частное x и y

Примеры

Деление двух чисел

SELECT divide(25,5) AS quotient, toTypeName(quotient)

5 Float64

Деление на ноль

SELECT divide(25,0)

inf

divideDecimal

Представлено в: v22.12

Выполняет деление двух десятичных чисел. Результирующее значение будет типа Decimal256. Масштаб результата может быть явно указан с помощью аргумента result_scale (константное целое число в диапазоне [0, 76]). Если не указано, масштаб результата равен максимальному масштабу заданных аргументов.

примечание

Эти функции работают значительно медленнее, чем обычное divide. Если вам не нужно контролируемое точное значение и/или нужна быстрая обработка, рассмотрите возможность использования divide.

Синтаксис

divideDecimal(x, y[, result_scale])

Аргументы

x — Первое значение: Decimal. - y — Второе значение: Decimal. - result_scale — Масштаб результата. Тип Int/UInt.

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

Результат деления с заданным масштабом. Decimal256

Примеры

Пример 1

divideDecimal(toDecimal256(-12, 0), toDecimal32(2.1, 1), 10)

┌─divideDecimal(toDecimal256(-12, 0), toDecimal32(2.1, 1), 10)─┐
│                                                -5.7142857142 │
└──────────────────────────────────────────────────────────────┘

Пример 2

SELECT toDecimal64(-12, 1) / toDecimal32(2.1, 1);
SELECT toDecimal64(-12, 1) as a, toDecimal32(2.1, 1) as b, divideDecimal(a, b, 1), divideDecimal(a, b, 5);

┌─divide(toDecimal64(-12, 1), toDecimal32(2.1, 1))─┐
│                                             -5.7 │
└──────────────────────────────────────────────────┘
┌───a─┬───b─┬─divideDecimal(toDecimal64(-12, 1), toDecimal32(2.1, 1), 1)─┬─divideDecimal(toDecimal64(-12, 1), toDecimal32(2.1, 1), 5)─┐
│ -12 │ 2.1 │                                                       -5.7 │                                                   -5.71428 │
└─────┴─────┴────────────────────────────────────────────────────────────┴────────────────────────────────────────────────────────────┘

divideOrNull

Представлено в: v25.5

То же, что и divide, но возвращает NULL при делении на ноль.

Синтаксис

divideOrNull(x, y)

Аргументы

x — Делимое - y — Делитель

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

Частное x и y, или NULL.

Примеры

Деление на ноль

SELECT divideOrNull(25, 0)

\N

gcd

Представлено в: v1.1

Возвращает наибольший общий делитель двух значений a и b.

Исключение выбрасывается при делении на ноль или при делении минимального отрицательного числа на минус один.

Синтаксис

gcd(x, y)

Аргументы

x — Первое целое число - y — Второе целое число

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

Наибольший общий делитель x и y.

Примеры

Пример использования

SELECT gcd(12, 18)

ifNotFinite

Представлено в: v20.3

Проверяет, является ли значение с плавающей запятой конечным.

Вы можете получить аналогичный результат, используя тернарный оператор: isFinite(x) ? x : y.

Синтаксис

ifNotFinite(x,y)

Аргументы

x — Значение для проверки на конечность. Float*
y — Значение по умолчанию. Float*

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

x, если x конечен.
y, если x бесконечно.

Примеры

Пример использования

SELECT 1/0 AS infimum, ifNotFinite(infimum,42)

inf  42

intDiv

Представлено в: v1.1

Выполняет целочисленное деление двух значений x на y. Другими словами, вычисляет частное, округленное вниз до следующего наименьшего целого.

Результат имеет ту же ширину, что и делимое (первый параметр).

Исключение выбрасывается при делении на ноль, если частное не помещается в диапазон делимого или при делении минимального отрицательного числа на минус один.

Синтаксис

intDiv(x, y)

Аргументы

x — Левый операнд. - y — Правый операнд.

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

Результат целочисленного деления x и y

Примеры

Целочисленное деление двух чисел с плавающей запятой

SELECT intDiv(toFloat64(1), 0.001) AS res, toTypeName(res)

┌──res─┬─toTypeName(intDiv(toFloat64(1), 0.001))─┐
│ 1000 │ Int64                                   │
└──────┴─────────────────────────────────────────┘

Частное не помещается в диапазон делимого

SELECT
intDiv(1, 0.001) AS res,
toTypeName(res)

Received exception from server (version 23.2.1):
Code: 153. DB::Exception: Received from localhost:9000. DB::Exception:
Cannot perform integer division, because it will produce infinite or too
large number: While processing intDiv(1, 0.001) AS res, toTypeName(res).
(ILLEGAL_DIVISION)

intDivOrNull

Представлено в: v25.5

То же, что и intDiv, но возвращает NULL при делении на ноль или при делении минимального отрицательного числа на минус один.

Синтаксис

intDivOrNull(x, y)

Аргументы

x — Левый операнд. (U)Int*
y — Правый операнд. (U)Int*

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

Результат целочисленного деления x и y, или NULL.

Примеры

Целочисленное деление на ноль

SELECT intDivOrNull(1, 0)

\N

Деление минимального отрицательного числа на минус 1

SELECT intDivOrNull(-9223372036854775808, -1)

\N

intDivOrZero

Представлено в: v1.1

То же, что и intDiv, но возвращает ноль при делении на ноль или при делении минимального отрицательного числа на минус один.

Синтаксис

intDivOrZero(a, b)

Аргументы

a — Левый операнд. (U)Int*
b — Правый операнд. (U)Int*

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

Результат целочисленного деления a и b, или ноль.

Примеры

Целочисленное деление на ноль

SELECT intDivOrZero(1, 0)

Деление минимального отрицательного числа на минус 1

SELECT intDivOrZero(0.05, -1)

isFinite

Представлено в: v1.1

Возвращает 1, если аргумент Float32 или Float64 не бесконечен и не является NaN, в противном случае эта функция возвращает 0.

Синтаксис

isFinite(x)

Аргументы

x — Число для проверки на конечность. Float*

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

1, если x не бесконечен и не NaN, в противном случае 0.

Примеры

Проверка, является ли число конечным

SELECT isFinite(inf)

isInfinite

Представлено в: v1.1

Возвращает 1, если аргумент Float32 или Float64 бесконечен, в противном случае эта функция возвращает 0. Обратите внимание, что 0 возвращается для NaN.

Синтаксис

isInfinite(x)

Аргументы

x — Число для проверки на бесконечность. Float*

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

1, если x бесконечен, в противном случае 0 (включая для NaN).

Примеры

Проверка, является ли число бесконечным

SELECT isInfinite(inf), isInfinite(NaN), isInfinite(10))

1 0 0

isNaN

Представлено в: v1.1

Возвращает 1, если аргумент Float32 и Float64 является NaN, в противном случае возвращает 0.

Синтаксис

isNaN(x)

Аргументы

x — Аргумент для оценки на предмет NaN. Float*

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

1, если NaN, в противном случае 0

Примеры

Пример использования

SELECT isNaN(NaN)

lcm

Представлено в: v1.1

Возвращает наименьшее общее кратное двух значений x и y.

Синтаксис

lcm(x, y)

Аргументы

x — Первое целое число. (U)Int*
y — Второе целое число. (U)Int*

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

Возвращает наименьшее общее кратное x и y. (U)Int*

Примеры

Пример использования

SELECT lcm(6, 8)

max2

Представлено в: v21.11

Возвращает большее из двух числовых значений x и y.

Синтаксис

max2(x, y)

Аргументы

x — Первое значение (U)Int8/16/32/64 или Float* или Decimal
y — Второе значение (U)Int8/16/32/64 или Float* или Decimal

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

Возвращает большее значение из x и y. Float64

Примеры

Пример использования

SELECT max2(-1, 2)

min2

Представлено в: v21.11

Возвращает меньшее из двух числовых значений x и y.

Синтаксис

min2(x, y)

Аргументы

x — Первое значение (U)Int8/16/32/64 или Float* или Decimal
y — Второе значение (U)Int8/16/32/64 или Float* или Decimal

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

Возвращает меньшее значение из x и y. Float64

Примеры

Пример использования

SELECT min2(-1, 2)

-1

minus

Представлено в: v1.1

Вычисляет разность двух значений a и b. Результат всегда знаковый. Также возможно вычитать целое число из даты или даты с временем. Дополнительно поддерживается вычитание между датами с временем, что приводит к разнице во времени между ними.

Синтаксис

minus(x, y)

Аргументы

x — уменьшаемое. - y — вычитаемое.

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

x минус y

Примеры

Вычитание двух чисел

SELECT minus(10, 5)

Вычитание целого числа и даты

SELECT minus(toDate('2025-01-01'),5)

2024-12-27

modulo

Представлено в: v1.1

Вычисляет остаток от деления двух значений a на b.

Тип результата является целым числом, если оба входных числа являются целыми числами. Если одно из входных чисел является числом с плавающей запятой, тип результата — Float64.

Остаток вычисляется по аналогии с C++. Используется усеченное деление для отрицательных чисел.

Синтаксис

modulo(a, b)

Аргументы

a — Делимое - b — Делитель (модуль)

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

Остаток от a % b

Примеры

Пример использования

SELECT modulo(5, 2)

moduloOrNull

Представлено в: v25.5

Вычисляет остаток при делении a на b. Похоже на функцию modulo, кроме того, что moduloOrNull будет возвращать NULL если правый аргумент равен 0.

Синтаксис

moduloOrNull(x, y)

Аргументы

x — Делимое. (U)Int* или Float*
y — Делитель (модуль). (U)Int* или Float*

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

Возвращает остаток от деления x на y, или null, когда делитель равен нулю.

Примеры

moduloOrNull при делении на ноль

SELECT moduloOrNull(5, 0)

\N

moduloOrZero

Представлено в: v20.3

Похож на modulo, но возвращает ноль, когда делитель равен нулю, в отличие от исключения с функцией modulo.

Синтаксис

moduloOrZero(a, b)

Аргументы

a — Делимое. (U)Int* или Float*
b — Делитель (модуль). (U)Int* или Float*

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

Возвращает остаток от a % b, или 0, когда делитель равен 0.

Примеры

Пример использования

SELECT moduloOrZero(5, 0)

multiply

Представлено в: v1.1

Вычисляет произведение двух значений x и y.

Синтаксис

multiply(x, y)

Аргументы

x — множитель. (U)Int* или Float* или Decimal
y — множитель. (U)Int* или Float* или Decimal

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

Возвращает произведение x и y

Примеры

Умножение двух чисел

SELECT multiply(5,5)

multiplyDecimal

Представлено в: v22.12

Выполняет умножение двух десятичных чисел. Результирующее значение будет типа Decimal256. Масштаб результата может быть явно указан с помощью аргумента result_scale (константное целое число в диапазоне [0, 76]). Если не указано, масштаб результата равен максимальному масштабу заданных аргументов.

примечание

Эти функции работают значительно медленнее, чем обычное multiply. Если вам не нужно контролируемое точное значение и/или нужна быстрая обработка, рассмотрите возможность использования multiply

Синтаксис

multiplyDecimal(a, b[, result_scale])

Аргументы

a — Первое значение. Decimal
b — Второе значение. Decimal
result_scale — Масштаб результата. (U)Int*

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

Результат умножения с заданным масштабом. Тип: Decimal256

Примеры

Пример использования

SELECT multiplyDecimal(toDecimal256(-12, 0), toDecimal32(-2.1, 1), 1)

25.2

Различие с обычным умножением

SELECT multiplyDecimal(toDecimal256(-12, 0), toDecimal32(-2.1, 1), 1)

┌─multiply(toDecimal64(-12.647, 3), toDecimal32(2.1239, 4))─┐
│                                               -26.8609633 │
└───────────────────────────────────────────────────────────┘
┌─multiplyDecimal(toDecimal64(-12.647, 3), toDecimal32(2.1239, 4))─┐
│                                                         -26.8609 │
└──────────────────────────────────────────────────────────────────┘

Переполнение десятичных чисел

SELECT
    toDecimal64(-12.647987876, 9) AS a,
    toDecimal64(123.967645643, 9) AS b,
    multiplyDecimal(a, b);
SELECT
    toDecimal64(-12.647987876, 9) AS a,
    toDecimal64(123.967645643, 9) AS b,
    a * b;

┌─────────────a─┬─────────────b─┬─multiplyDecimal(toDecimal64(-12.647987876, 9), toDecimal64(123.967645643, 9))─┐
│ -12.647987876 │ 123.967645643 │                                                               -1567.941279108 │
└───────────────┴───────────────┴───────────────────────────────────────────────────────────────────────────────┘
Received exception from server (version 22.11.1):
Code: 407. DB::Exception: Received from localhost:9000. DB::Exception: Decimal math overflow:
While processing toDecimal64(-12.647987876, 9) AS a, toDecimal64(123.967645643, 9) AS b, a * b. (DECIMAL_OVERFLOW)

negate

Представлено в: v1.1

Инвертирует аргумент x. Результат всегда знаковый.

Синтаксис

negate(x)

Аргументы

x — Значение для инверсии.

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

Возвращает -x от x

Примеры

Пример использования

SELECT negate(10)

-10

plus

Представлено в: v1.1

Вычисляет сумму двух значений x и y. Псевдоним: x + y (оператор). Можно сложить целое число и дату или дату с временем. Первое операция увеличивает количество дней в дате, второй операция увеличивает количество секунд в дате с временем.

Синтаксис

plus(x, y)

Аргументы

x — Левый операнд. - y — Правый операнд.

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

Возвращает сумму x и y

Примеры

Сложение двух чисел

SELECT plus(5,5)

Сложение целого числа и даты

SELECT plus(toDate('2025-01-01'),5)

2025-01-06

positiveModulo

Представлено в: v22.11

Вычисляет остаток при делении x на y. Похоже на функцию modulo, за исключением того, что positiveModulo всегда возвращает неотрицательное число.

Синтаксис

positiveModulo(x, y)

Аргументы

x — Делимое. (U)Int* или Float* или Decimal
y — Делитель (модуль). (U)Int* или Float* или Decimal

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

Возвращает разность между x и наименьшим целым числом, которое не больше x, делящимся на y.

Примеры

Пример использования

SELECT positiveModulo(-1, 10)

positiveModuloOrNull

Представлено в: v25.5

Вычисляет остаток при делении a на b. Похож на функцию positiveModulo, но positiveModuloOrNull вернет NULL если правый аргумент равен 0.

Синтаксис

positiveModuloOrNull(x, y)

Аргументы

x — Делимое. (U)Int*/Float32/64. - x — Делитель (модуль). (U)Int*/Float32/64.

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

Возвращает разность между x и наименьшим целым числом, которое не больше x, делящимся на y, null, когда делитель равен нулю.

Примеры

positiveModuloOrNull

SELECT positiveModuloOrNull(5, 0)

\N

Обзор​

abs​

byteSwap​

divide​

divideDecimal​

divideOrNull​

gcd​

ifNotFinite​

intDiv​

intDivOrNull​

intDivOrZero​

isFinite​

isInfinite​

isNaN​

lcm​

max2​

min2​

minus​

modulo​

moduloOrNull​

moduloOrZero​

multiply​

multiplyDecimal​

negate​

plus​

positiveModulo​

positiveModuloOrNull​

Обзор

abs

byteSwap

divide

divideDecimal

divideOrNull

gcd

ifNotFinite

intDiv

intDivOrNull

intDivOrZero

isFinite

isInfinite

isNaN

lcm

max2

min2

minus

modulo

moduloOrNull

moduloOrZero

multiply

multiplyDecimal

negate

plus

positiveModulo

positiveModuloOrNull