Перейти к основному содержанию

Обзор

Арифметические функции применимы к любым двум операндам типа 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 или UInt32 * UInt32 = UInt64.
Эти правила гарантируют, что тип результата будет наименьшим типом, способным представить все возможные результаты. Хотя это создает риск переполнения на границах диапазона значений, такой подход обеспечивает быстрое выполнение вычислений с использованием максимальной нативной разрядности целых чисел — 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.0 Вычисляет абсолютное значение x. Не имеет эффекта, если x имеет беззнаковый тип. Если x имеет знаковый тип, возвращает беззнаковое число. Синтаксис
abs(x)
Аргументы
  • x — Значение, для которого вычисляется абсолютное значение
Возвращаемое значение Абсолютное значение x Примеры Пример использования
Query
SELECT abs(-0.5)
Response
0.5

avg2

Добавленный в: v25.11.0 Вычисляет и возвращает среднее значение указанных аргументов. Поддерживает числовые и временные типы. Синтаксис
avg2(x1, x2])
Аргументы
  • x1, x2] — Принимает два значения для вычисления среднего.
Возвращаемое значение Возвращает среднее значение переданных аргументов с приведением к наиболее широкому совместимому типу. Примеры Числовые типы
Query
SELECT avg2(toUInt8(3), 1.0) AS result, toTypeName(result) AS type;
-- Возвращаемый тип — Float64, так как UInt8 необходимо расширить до 64 бит для выполнения сравнения.
Response
┌─result─┬─type────┐
│      2 │ Float64 │
└────────┴─────────┘
Типы Decimal
Query
SELECT avg2(toDecimal32(1, 2), 2) AS result, toTypeName(result) AS type;
Response
┌─result─┬─type──────────┐
│    1.5 │ Decimal(9, 2) │
└────────┴───────────────┘
Типы дат
Query
SELECT avg2(toDate('2025-01-01'), toDate('2025-01-05')) AS result, toTypeName(result) AS type;
Response
┌─────result─┬─type─┐
│ 2025-01-03 │ Date │
└────────────┴──────┘
Типы DateTime
Query
SELECT avg2(toDateTime('2025-01-01 00:00:00'), toDateTime('2025-01-03 12:00:00')) AS result, toTypeName(result) AS type;
Response
┌──────────────result─┬─type─────┐
│ 2025-01-02 06:00:00 │ DateTime │
└─────────────────────┴──────────┘
Типы Time64
Query
SELECT avg2(toTime64('12:00:00', 0), toTime64('14:00:00', 0)) AS result, toTypeName(result) AS type;
Response
┌───result─┬─type──────┐
│ 13:00:00 │ Time64(0) │
└──────────┴───────────┘

byteSwap

Добавленный в: v23.10.0 Меняет порядок байтов целого числа на обратный, то есть изменяет его порядок байтов. Приведённый ниже пример можно разобрать следующим образом:
  1. Преобразуйте целое число из десятичной системы в эквивалентное шестнадцатеричное представление в формате big-endian, то есть 3351772109 -> C7 C7 FB CD (4 байта)
  2. Переставьте байты в обратном порядке, то есть C7 C7 FB CD -> CD FB C7 C7
  3. Преобразуйте результат обратно в целое число, предполагая формат 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* Примеры Пример использования
Query
SELECT byteSwap(3351772109)
Response
3455829959
8-битный
Query
SELECT byteSwap(54)
Response
54
16-битный
Query
SELECT byteSwap(4135)
Response
10000
32-разрядный
Query
SELECT byteSwap(3351772109)
Response
3455829959
64-разрядная
Query
SELECT byteSwap(123294967295)
Response
18439412204227788800

divide

Добавленный в: v1.1.0 Вычисляет частное двух значений a и b. Тип результата всегда — Float64. Для целочисленного деления используется функция intDiv.
При делении на 0 возвращается inf, -inf или nan.
Синтаксис
divide(x, y)
Аргументы
  • x — Делимое - y — Делитель
Возвращаемое значение Частное от деления x на y Примеры Деление двух чисел
Query
SELECT divide(25,5) AS quotient, toTypeName(quotient)
Response
5 Float64
Деление на ноль
Query
SELECT divide(25,0)
Response
inf

divideDecimal

Добавленный в: v22.12.0 Выполняет деление двух десятичных чисел. Результирующее значение имеет тип Decimal256. Масштаб результата можно явно задать с помощью аргумента result_scale (константный Integer в диапазоне [0, 76]). Если он не указан, масштаб результата будет равен максимальному масштабу среди переданных аргументов.
Эта функция работает значительно медленнее, чем обычная divide. Если вам не требуется контролируемая точность и/или нужны быстрые вычисления, используйте divide.
Синтаксис
divideDecimal(x, y[, result_scale])
Аргументы
  • x — Первое значение: Decimal. - y — Второе значение: Decimal. - result_scale — Указанный масштаб результата. Тип: Int/UInt.
Возвращаемое значение Результат деления с указанным масштабом. Decimal256 Примеры Пример 1
Query
divideDecimal(toDecimal256(-12, 0), toDecimal32(2.1, 1), 10)
Response
┌─divideDecimal(toDecimal256(-12, 0), toDecimal32(2.1, 1), 10)─┐
│                                                -5.7142857142 │
└──────────────────────────────────────────────────────────────┘
Пример 2
Query
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);
Response
┌─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.0 Аналогично divide, но при делении на ноль возвращает NULL. Синтаксис
divideOrNull(x, y)
Аргументы
  • x — делимое - y — делитель
Возвращаемое значение Результат деления x на y, или NULL. Примеры Деление на ноль
Query
SELECT divideOrNull(25, 0)
Response
\N

gcd

Добавленный в: v1.1.0 Возвращает наибольший общий делитель двух значений a и b. Исключение генерируется при делении на ноль или при делении минимального отрицательного числа на -1. Синтаксис
gcd(x, y)
Аргументы
  • x — Первое целое число - y — Второе целое число
Возвращаемое значение Наибольший общий делитель чисел x и y. Примеры Пример использования
Query
SELECT gcd(12, 18)
Response
6

ifNotFinite

Добавленный в: v20.3.0 Проверяет, является ли число с плавающей запятой конечным. Аналогичный результат можно получить с помощью тернарного оператора: isFinite(x) ? x : y. Синтаксис
ifNotFinite(x,y)
Аргументы
  • x — Значение, которое нужно проверить на бесконечность. Float*
  • y — Резервное значение. Float*
Возвращаемое значение
  • x, если x является конечным.
  • y, если x не является конечным.
Примеры Пример использования
Query
SELECT 1/0 AS infimum, ifNotFinite(infimum,42)
Response
inf  42

intDiv

Добавленный в: v1.1.0 Выполняет целочисленное деление значения x на y. Иными словами, вычисляет частное, округлённое вниз до ближайшего меньшего целого числа. Результат имеет ту же разрядность, что и делимое (первый параметр). Исключение генерируется при делении на ноль, если частное не помещается в диапазон делимого, или при делении минимального отрицательного числа на минус один. Синтаксис
intDiv(x, y)
Аргументы
  • x — Левый операнд. - y — Правый операнд.
Возвращаемое значение Результат целочисленного деления x на y Примеры Целочисленное деление двух чисел с плавающей точкой
Query
SELECT intDiv(toFloat64(1), 0.001) AS res, toTypeName(res)
Response
┌──res─┬─toTypeName(intDiv(toFloat64(1), 0.001))─┐
│ 1000 │ Int64                                   │
└──────┴─────────────────────────────────────────┘
Частное выходит за диапазон значений делимого
Query
SELECT
intDiv(1, 0.001) AS res,
toTypeName(res)
Response
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.0 То же, что и intDiv, но возвращает NULL при делении на ноль или при делении наименьшего отрицательного числа на минус единицу. Синтаксис
intDivOrNull(x, y)
Аргументы
  • x — Левый операнд. (U)Int*
  • y — Правый операнд. (U)Int*
Возвращаемое значение Результат целочисленного деления x на y или NULL. Примеры Целочисленное деление на ноль
Query
SELECT intDivOrNull(1, 0)
Response
\N
Деление наименьшего отрицательного числа на -1
Query
SELECT intDivOrNull(-9223372036854775808, -1)
Response
\N

intDivOrZero

Добавленный в: v1.1.0 То же, что и intDiv, но возвращает ноль при делении на ноль или при делении наименьшего отрицательного числа на минус единицу. Синтаксис
intDivOrZero(a, b)
Аргументы
  • a — Левый операнд. (U)Int*
  • b — Правый операнд. (U)Int*
Возвращаемое значение Результат целочисленного деления a на b, либо ноль. Примеры Целочисленное деление на ноль
Query
SELECT intDivOrZero(1, 0)
Response
0
Деление минимального отрицательного числа на -1
Query
SELECT intDivOrZero(0.05, -1)
Response
0

isFinite

Добавленный в: v1.1.0 Возвращает 1, если аргумент Float32 или Float64 не является бесконечным и не равен NaN, в противном случае возвращает 0. Синтаксис
isFinite(x)
Аргументы
  • x — Число для проверки на конечность. Float*
Возвращаемое значение 1, если x не является бесконечным и не равно NaN, иначе 0. Примеры Проверка, является ли число конечным
Query
SELECT isFinite(inf)
Response
0

isInfinite

Добавленный в: v1.1.0 Возвращает 1, если аргумент типа Float32 или Float64 является бесконечностью; в противном случае возвращает 0. Обратите внимание, что для NaN также возвращается 0. Синтаксис
isInfinite(x)
Аргументы
  • x — число, которое нужно проверить на бесконечность. Float*
Возвращаемое значение 1, если x бесконечно, иначе — 0 (в том числе для NaN). Примеры Проверка, является ли число бесконечным
Query
SELECT isInfinite(inf), isInfinite(NaN), isInfinite(10))
Response
1 0 0

isNaN

Добавленный в: v1.1.0 Возвращает 1, если аргумент типа Float32 или Float64 имеет значение NaN, в противном случае возвращает 0. Синтаксис
isNaN(x)
Аргументы
  • x — аргумент, для которого проверяется, является ли он NaN. Float*
Возвращаемое значение 1, если значение равно NaN, иначе 0 Примеры Пример использования
Query
SELECT isNaN(NaN)
Response
1

lcm

Добавленный в: v1.1.0 Возвращает наименьшее общее кратное двух значений x и y. Генерируется исключение при делении на ноль или при делении минимального отрицательного числа на минус один. Синтаксис
lcm(x, y)
Аргументы
  • x — Первое целое число. (U)Int*
  • y — Второе целое число. (U)Int*
Возвращаемое значение Возвращает наименьшее общее кратное чисел x и y. (U)Int* Примеры Пример использования
Query
SELECT lcm(6, 8)
Response
24

max2

Добавленный в: v21.11.0 Возвращает большее из двух чисел x и y. Синтаксис
max2(x, y)
Аргументы Возвращаемое значение Возвращает большее из значений x и y. Float64 Примеры Пример использования
Query
SELECT max2(-1, 2)
Response
2

midpoint

Добавленный в: v25.11.0 Вычисляет и возвращает среднее значение переданных аргументов. Поддерживает числовые и временные типы. Синтаксис
midpoint(x1[, x2, ...])
Аргументы
  • x1[, x2, ...] — Принимает одно или несколько значений для вычисления среднего.
Возвращаемое значение Возвращает среднее значение переданных аргументов с приведением к наибольшему совместимому типу. Примеры Числовые типы
Query
SELECT midpoint(1, toUInt8(3), 0.5) AS result, toTypeName(result) AS type;
-- Возвращаемый тип — Float64, так как UInt8 необходимо расширить до 64 бит для выполнения сравнения.
Response
┌─result─┬─type────┐
│    1.5 │ Float64 │
└────────┴─────────┘
Десятичные типы
Query
SELECT midpoint(toDecimal32(1.5, 2), toDecimal32(1, 1), 2) AS result, toTypeName(result) AS type;
Response
┌─result─┬─type──────────┐
│    1.5 │ Decimal(9, 2) │
└────────┴───────────────┘
Типы данных даты
Query
SELECT midpoint(toDate('2025-01-01'), toDate('2025-01-05')) AS result, toTypeName(result) AS type;
Response
┌─────result─┬─type─┐
│ 2025-01-03 │ Date │
└────────────┴──────┘
Типы DateTime
Query
SELECT midpoint(toDateTime('2025-01-01 00:00:00'), toDateTime('2025-01-03 12:00:00')) AS result, toTypeName(result) AS type;
Response
┌──────────────result─┬─type─────┐
│ 2025-01-02 06:00:00 │ DateTime │
└─────────────────────┴──────────┘
Типы Time64
Query
SELECT midpoint(toTime64('12:00:00', 0), toTime64('14:00:00', 0)) AS result, toTypeName(result) AS type;
Response
┌───result─┬─type──────┐
│ 13:00:00 │ Time64(0) │
└──────────┴───────────┘

min2

Добавленный в: v21.11.0 Возвращает меньшее из двух числовых значений x и y. Синтаксис
min2(x, y)
Аргументы Возвращаемое значение Возвращает меньшее из значений x и y. Float64 Примеры Пример использования
Query
SELECT min2(-1, 2)
Response
-1

minus

Добавленный в: v1.1.0 Вычисляет разность двух значений a и b. Результат всегда знаковый. Как и в случае с plus, из значения типа дата или дата и время можно вычитать целое число. Кроме того, поддерживается вычитание между значениями типа дата и время, в результате которого получается разница во времени между ними. Синтаксис
minus(x, y)
Аргументы
  • x — Уменьшаемое. - y — Вычитаемое.
Возвращаемое значение Разность x и y Примеры Вычитание двух чисел
Query
SELECT minus(10, 5)
Response
5
Вычитание целого числа из даты
Query
SELECT minus(toDate('2025-01-01'),5)
Response
2024-12-27

modulo

Добавленный в: v1.1.0 Вычисляет остаток от деления значения a на значение b. Тип результата — целое число, если оба входных значения целые. Если одно из входных значений — число с плавающей точкой, тип результата — Float64. Остаток вычисляется так же, как в C++. Для отрицательных чисел используется усечённое деление. При делении на ноль или при делении минимального отрицательного числа на минус единицу генерируется исключение. Синтаксис
modulo(a, b)
Псевдонимы: mod Аргументы
  • a — Делимое - b — Делитель (модуль)
Возвращаемое значение Остаток от деления a на b Примеры Пример использования
Query
SELECT modulo(5, 2)
Response
1

moduloLegacy

Добавленный в: v1.1.0 Вычисляет остаток от деления. Это устаревшая реализация modulo, использующая оператор % из C++, который может возвращать отрицательные результаты для отрицательных аргументов. Эта функция существует для обратной совместимости со старой логикой партиционирования таблиц. Для стандартного поведения используйте modulo или positiveModulo. Синтаксис
moduloLegacy(a, b)
Аргументы Возвращаемое значение Возвращает остаток от деления. (U)Int* или Float* Примеры Базовое использование
Query
SELECT moduloLegacy(10, 3)
Response
1

moduloOrNull

Добавленный в: v25.5.0 Вычисляет остаток при делении a на b. Аналогична функции modulo, но moduloOrNull возвращает NULL, если правый аргумент равен 0. Синтаксис
moduloOrNull(x, y)
Псевдонимы: modOrNull Аргументы Возвращаемое значение Возвращает остаток от деления x на y или NULL, если делитель равен нулю. Примеры moduloOrNull при делении на ноль
Query
SELECT moduloOrNull(5, 0)
Response
\N

moduloOrZero

Добавленный в: v20.3.0 Как modulo, но возвращает ноль, если делитель равен нулю, вместо исключения, которое возникает в функции modulo. Синтаксис
moduloOrZero(a, b)
Аргументы Возвращаемое значение Возвращает остаток от деления a % b или 0, если делитель равен 0. Примеры Пример использования
Query
SELECT moduloOrZero(5, 0)
Response
0

multiply

Добавленный в: v1.1.0 Вычисляет произведение двух значений x и y. Синтаксис
multiply(x, y)
Аргументы Возвращаемое значение Возвращает произведение x и y Примеры Умножение двух чисел
Query
SELECT multiply(5,5)
Response
25

multiplyDecimal

Добавленный в: v22.12.0 Выполняет умножение двух десятичных чисел. Результирующее значение будет иметь тип Decimal256. Масштаб результата можно явно задать аргументом result_scale (константный Integer в диапазоне [0, 76]). Если он не указан, масштаб результата будет равен максимальному масштабу переданных аргументов.
Эти функции работают значительно медленнее, чем обычная multiply. Если вам не нужна контролируемая точность и/или важна высокая скорость вычислений, рассмотрите использование multiply
Синтаксис
multiplyDecimal(a, b[, result_scale])
Аргументы
  • a — Первое значение. Decimal
  • b — Второе значение. Decimal
  • result_scale — Масштаб результата. (U)Int*
Возвращаемое значение Результат умножения с указанным масштабом. Тип: Decimal256 Примеры Пример использования
Query
SELECT multiplyDecimal(toDecimal256(-12, 0), toDecimal32(-2.1, 1), 1)
Response
25.2
Отличие от обычного умножения
Query
SELECT multiplyDecimal(toDecimal256(-12, 0), toDecimal32(-2.1, 1), 1)
Response
┌─multiply(toDecimal64(-12.647, 3), toDecimal32(2.1239, 4))─┐
│                                               -26.8609633 │
└───────────────────────────────────────────────────────────┘
┌─multiplyDecimal(toDecimal64(-12.647, 3), toDecimal32(2.1239, 4))─┐
│                                                         -26.8609 │
└──────────────────────────────────────────────────────────────────┘
Переполнение типа Decimal
Query
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;
Response
┌─────────────a─┬─────────────b─┬─multiplyDecimal(toDecimal64(-12.647987876, 9), toDecimal64(123.967645643, 9))─┐
│ -12.647987876 │ 123.967645643 │                                                               -1567.941279108 │
└───────────────┴───────────────┴───────────────────────────────────────────────────────────────────────────────┘
Получено исключение от сервера (версия 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.0 Меняет знак аргумента x на противоположный. Результат всегда знаковый. Синтаксис
negate(x)
Аргументы
  • x — Значение, знак которого нужно изменить на противоположный.
Возвращаемое значение Возвращает -x для значения x Примеры Пример использования
Query
SELECT negate(10)
Response
-10

plus

Добавленный в: v1.1.0 Вычисляет сумму двух значений x и y. Псевдоним: x + y (оператор). Можно складывать целое число и дату или дату и время. В первом случае увеличивается число дней в дате, во втором — число секунд в дате и времени. Также можно складывать дату и время. При сложении Date и Time получается DateTime. При сложении Date и Time64, а также Date32 и Time или Time64, получается DateTime64. Синтаксис
plus(x, y)
Аргументы
  • x — Левый операнд. - y — Правый операнд.
Возвращаемое значение Возвращает сумму x и y Примеры Сложение двух чисел
Query
SELECT plus(5,5)
Response
10
Прибавление целого числа к дате
Query
SELECT plus(toDate('2025-01-01'),5)
Response
2025-01-06
Добавление даты и времени
Query
SELECT toDate('2025-01-01') + CAST('14:30:25', 'Time')
Response
2025-01-01 14:30:25

positiveModulo

Добавленный в: v22.11.0 Вычисляет остаток от деления x на y. Аналогична функции modulo, но positiveModulo всегда возвращает неотрицательное число. Синтаксис
positiveModulo(x, y)
Псевдонимы: positive_modulo, pmod Аргументы Возвращаемое значение Возвращает разность между x и ближайшим к нему целым числом, которое не превышает x и делится на y. Примеры Пример использования
Query
SELECT positiveModulo(-1, 10)
Response
9

positiveModuloOrNull

Добавленный в: v25.5.0 Вычисляет остаток от деления a на b. Аналогична функции positiveModulo, но positiveModuloOrNull возвращает NULL, если правый аргумент равен 0. Синтаксис
positiveModuloOrNull(x, y)
Псевдонимы: positive_modulo_or_null, pmodOrNull Аргументы Возвращаемое значение Возвращает разность между x и ближайшим целым числом, не превышающим x и кратным y; null, если делитель равен нулю. Примеры positiveModuloOrNull
Query
SELECT positiveModuloOrNull(5, 0)
Response
\N
Последнее изменение 10 июня 2026 г.