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

Документация по арифметическим функциям

​

Обзор

Арифметические функции применимы к любым двум операндам типа 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

SELECT 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(a, b, 1)─┬─divideDecimal(a, b, 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(res)─┐
│ 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 или BFloat16 не является бесконечным и не равен NaN, в противном случае возвращает 0.

Синтаксис

isFinite(x)

Аргументы

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

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

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

Примеры

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

Query

SELECT isFinite(inf)

Response

0

​

isInfinite

Добавленный в: v1.1.0

Возвращает 1, если аргумент типа Float32, Float64 или BFloat16 является бесконечностью; в противном случае возвращает 0. Обратите внимание, что для NaN также возвращается 0.

Синтаксис

isInfinite(x)

Аргументы

• x — число, которое нужно проверить на бесконечность. Float* или BFloat16

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

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

Примеры

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

Query

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

Response

1	0	0

​

isNaN

Добавленный в: v1.1.0

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

Синтаксис

isNaN(x)

Аргументы

• x — аргумент, для которого проверяется, является ли он NaN. Float* или BFloat16

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

1, если значение равно NaN, иначе 0

Примеры

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

Query

SELECT isNaN(NaN)

Response

1

​

kqlBin

Добавлено в: v26.8.0

Округляет значение вниз до величины, кратной roundTo, — так же, как функция bin() в Kusto Query Language.

Правило зависит от типов аргументов: число округляется арифметически, timespan (представляющий собой Interval) округляется по timespan, а дата и время также округляются по timespan. В KQL значение даты и времени — это DateTime64; более узкие типы-носители DateTime и Date отклоняются, так как они не способны представить любой bin, который может вернуть дата и время в KQL.

Эта функция обеспечивает работу bin() при dialect = 'kusto'. Она не предназначена для прямого вызова из SQL.

Синтаксис

kqlBin(value, roundTo)

Аргументы

• value — число, timespan или дата и время (DateTime64). - roundTo — размер бина.

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

value, округлённое вниз до ближайшего кратного roundTo.

Примеры

number

Query

SELECT kqlBin(4.5, 1)

Response

4

timespan

Query

SELECT kqlBin(toIntervalNanosecond(16 * 86400000000000), toIntervalNanosecond(7 * 86400000000000))

Response

1209600000000000

дата и время

Query

SELECT kqlBin(toDateTime64('2026-08-01 12:34:56', 7, 'UTC'), toIntervalHour(1))

Response

2026-08-01 12:00:00.0000000

​

kqlBinAt

Добавлено в: v26.8.0

Округляет значение вниз до кратного binSize, отсчитываемого от fixedPoint, — так же, как это делает bin_at() в Kusto Query Language. Границы бинов могут оказаться как до, так и после фиксированной точки.

Правило зависит от типов аргументов: число округляется арифметически, timespan (то есть Interval) округляется по timespan, отсчитываемому от timespan, а дата и время округляются по timespan, отсчитываемому от фиксированной точки типа дата и время. Дата и время в KQL — это DateTime64; более узкие типы DateTime и Date не принимаются, поскольку они не способны представить все бины, которые может выдать дата и время в KQL.

Эта функция обеспечивает работу bin_at() при dialect = 'kusto'. Она не предназначена для прямого вызова из SQL.

Синтаксис

kqlBinAt(value, binSize, fixedPoint)

Аргументы

• value — число, timespan или дата и время (DateTime64). - binSize — размер бина. - fixedPoint — точка, от которой отсчитываются bins.

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

value, округлённое вниз до ближайшего кратного binSize, отсчитываемого от fixedPoint.

Примеры

число

Query

SELECT kqlBinAt(6.5, 2.5, -0.5)

Response

4.5

дата и время

Query

SELECT kqlBinAt(toDateTime64('2026-08-01 12:34:56', 7, 'UTC'), toIntervalHour(1), toDateTime64('2026-08-01 00:30:00', 7, 'UTC'))

Response

2026-08-01 12:30:00.0000000

​

kqlDateTimeBinAt

Добавлено в: v26.8.0

Округляет значение даты и времени вниз до ближайшего кратного timespan, отсчитываемого от фиксированной точки даты и времени.

Синтаксис

kqlDateTimeBinAt(value, binSize, fixedPoint)

Аргументы

• value — округляемые дата и время. - binSize — размер бина. - fixedPoint — фиксированная точка даты и времени.

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

Округлённые дата и время.

Примеры

​

kqlDivide

Добавлено в: v26.8.0

Деление в том виде, в каком его определяет Kusto Query Language: два целочисленных операнда делятся с целочисленным результатом, поэтому 7 / 2 даёт 3, а два операнда типа timespan (то есть значения Interval) делятся с вещественным результатом, поэтому 15ms / 10ms даёт 1.5. Любые другие сочетания типов операндов делятся так же, как в divide.

Эта функция реализует оператор / при dialect = 'kusto'. Она не предназначена для прямого вызова из SQL.

Синтаксис

kqlDivide(x, y)

Аргументы

• x — делимое. - y — делитель.

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

intDiv(x, y), если оба аргумента — целые числа; отношение тиков интервалов, если оба аргумента — интервалы; в остальных случаях — divide(x, y).

Примеры

целые числа

Query

SELECT kqlDivide(7, 2)

Response

3

вещественные числа

Query

SELECT kqlDivide(7.0, 2)

Response

3.5

timespans

Query

SELECT kqlDivide(toIntervalNanosecond(15000000), toIntervalNanosecond(10000000))

Response

1.5

​

kqlMultiply

Добавлено в: v26.8.0

Умножение в том виде, в каком его определяет Kusto Query Language: timespan (Interval) умножается на число, стоящее с любой стороны, поэтому 2 * 1h — это два часа. Два аргумента без интервала перемножаются так же, как в multiply.

Эта функция реализует оператор * при dialect = 'kusto'. Она не предназначена для прямого вызова из SQL.

Синтаксис

kqlMultiply(x, y)

Аргументы

• x — число или timespan. - y — число либо timespan, если x — число.

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

Произведение; интервал того же типа, если один из аргументов является интервалом.

Примеры

timespan

Query

SELECT kqlMultiply(2, toIntervalNanosecond(3600000000000))

Response

7200000000000

числа

Query

SELECT kqlMultiply(6, 7)

Response

42

​

kqlRangeCount

Добавлено в: v26.8.0

Количество строк, которые возвращает источник range языка Kusto Query Language: floor((to - from) / step) + 1, но не меньше нуля. Границы и шаг задаются числами, либо значениями даты и времени с шагом в виде timespan (то есть Interval), либо значениями timespan; временные формы подсчитываются в целых наносекундах, что нельзя выразить одной операцией деления в ClickHouse. Целые числа и decimal-значения подсчитываются точно, а не через Float64.

Эта функция обеспечивает работу источника range при dialect = 'kusto'. Её не предполагается вызывать напрямую из SQL.

Синтаксис

kqlRangeCount(from, to, step)

Arguments

• from — Первое значение диапазона. - to — Значение, за которое диапазон не выходит. - step — Разность между двумя соседними значениями.

Returned value

Количество значений в диапазоне.

Examples

numbers

Query

SELECT kqlRangeCount(1, 7, 2)

Response

4

datetimes

Query

SELECT kqlRangeCount(toDateTime64('2026-08-01 00:00:00', 7, 'UTC'), toDateTime64('2026-08-01 12:00:00', 7, 'UTC'), toIntervalHour(5))

Response

3

​

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 — Первое значение (U)Int8/16/32/64 или Float*, или BFloat16, или Decimal
• y — Второе значение (U)Int8/16/32/64 или Float*, или BFloat16, или Decimal

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

Возвращает большее из значений 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 — Первое значение (U)Int8/16/32/64 или Float*, или BFloat16, или Decimal
• y — Второе значение (U)Int8/16/32/64 или Float*, или BFloat16, или Decimal

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

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

Примеры

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

Query

SELECT min2(-1, 2)

Response

-1

​

minus

Добавленный в: v1.1.0

Вычисляет разность двух значений a и b. Результат всегда знаковый. Как и в случае с plus, из значения типа дата или дата и время можно вычитать целое число. Кроме того, поддерживается вычитание между значениями типа дата и время, в результате которого получается разница во времени между ними. Также можно вычесть Time или Time64 из DateTime или DateTime64; значение времени применяется как смещение в секундах. DateTime минус Time даёт DateTime, а любая комбинация с DateTime64 или Time64 даёт DateTime64 с максимальным масштабом из двух аргументов.

Синтаксис

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)

Аргументы

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

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

Возвращает остаток от деления. (U)Int* или Float*

Примеры

Базовое использование

Query

SELECT moduloLegacy(10, 3)

Response

1

​

moduloOrNull

Добавленный в: v25.5.0

Вычисляет остаток при делении a на b. Аналогична функции modulo, но moduloOrNull возвращает NULL, если операция в противном случае привела бы к исключению с плавающей запятой. Для аргументов с плавающей точкой это происходит только в случае, если делитель равен 0; для целочисленных аргументов это также включает случай, когда минимальное отрицательное значение берется по модулю -1 (например, -128 % -1 для Int8).

Синтаксис

moduloOrNull(x, y)

Псевдонимы: modOrNull

Аргументы

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

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

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

Примеры

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

Query

SELECT moduloOrNull(5, 0)

Response

\N

moduloOrNull при делении минимального отрицательного целого числа на -1

Query

SELECT moduloOrNull(toInt8(-128), toInt8(-1))

Response

\N

​

moduloOrZero

Добавленный в: v20.3.0

Как modulo, но для целочисленных результатов возвращает ноль вместо исключения в тех случаях, когда операция иначе привела бы к исключению. Для результатов с плавающей запятой нулевой делитель даёт NaN.

Синтаксис

moduloOrZero(a, b)

Аргументы

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

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

Возвращает остаток от деления a % b. Для целочисленных результатов возвращает 0 в тех случаях, когда операция иначе сгенерировала бы исключение. Для результатов с плавающей запятой нулевой делитель даёт NaN.

Примеры

Нулевой целочисленный делитель

Query

SELECT moduloOrZero(5, 0)

Response

0

Нулевой делитель с плавающей запятой

Query

SELECT moduloOrZero(toFloat64(5), toFloat64(0))

Response

nan

​

multiply

Добавленный в: v1.1.0

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

Синтаксис

multiply(x, y)

Аргументы

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

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

Возвращает произведение 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 multiply(toDecimal64(-12.647, 3), toDecimal32(2.1239, 4));
SELECT multiplyDecimal(toDecimal64(-12.647, 3), toDecimal32(2.1239, 4));

Response

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

Без переполнения при использовании multiplyDecimal

Query

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

Response

┌─────────────a─┬─────────────b─┬─multiplyDecimal(a, b)─┐
│ -12.647987876 │ 123.967645643 │       -1567.941279108 │
└───────────────┴───────────────┴───────────────────────┘

Переполнение типа Decimal при обычном умножении

Query

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

Response

Received exception:
Code: 407. DB::Exception: Decimal math overflow. (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. При сложении Time или Time64 с DateTime или DateTime64 значение времени применяется как смещение в секундах. DateTime плюс Time даёт DateTime, любая комбинация с участием DateTime64 или Time64 даёт DateTime64 с максимальной точностью (scale) из двух аргументов.

Синтаксис

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 — Делимое. (U)Int* или Float* или Decimal
• y — Делитель (модуль). (U)Int* или Float* или Decimal

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

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

Примеры

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

Query

SELECT positiveModulo(-1, 10)

Response

9

​

positiveModuloOrNull

Добавленный в: v25.5.0

Вычисляет остаток от деления a на b. Аналогична функции positiveModulo, но positiveModuloOrNull возвращает NULL, если операция в противном случае привела бы к исключению с плавающей запятой. Для аргументов с плавающей запятой это происходит только, когда делитель равен 0; для целочисленных аргументов сюда также относится минимальное отрицательное значение по модулю -1 (например, -128 % -1 для Int8).

Синтаксис

positiveModuloOrNull(x, y)

Псевдонимы: positive_modulo_or_null, pmodOrNull

Аргументы

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

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

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

Примеры

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

Query

SELECT positiveModuloOrNull(5, 0)

Response

\N

positiveModuloOrNull для минимального отрицательного целого числа при делении на -1

Query

SELECT positiveModuloOrNull(toInt8(-128), toInt8(-1))

Response

\N

​

sqr

Добавленный в: v26.7.0

Вычисляет квадрат значения x.

Синтаксис

sqr(x)

Аргументы

• x — Значение, возводимое в квадрат. (U)Int* или Float*, или Decimal

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

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

Примеры

Возведение числа в квадрат

Query

SELECT sqr(5)

Response

25