Funciones aritméticas - ClickHouse Documentation

Descripción general

Las funciones aritméticas se aplican a cualquier par de operandos de tipo UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64, Float32 o Float64. Antes de realizar la operación, ambos operandos se convierten al tipo de resultado. El tipo de resultado se determina de la siguiente manera (a menos que se especifique lo contrario en la documentación de la función que aparece a continuación):

Si ambos operandos tienen hasta 32 bits, el tamaño del tipo de resultado será el del siguiente tipo de mayor tamaño después del mayor de los dos operandos (promoción de tamaño de enteros). Por ejemplo, UInt8 + UInt16 = UInt32 o Float32 * Float32 = Float64.
Si uno de los operandos tiene 64 bits o más, el tamaño del tipo de resultado será el mismo que el del mayor de los dos operandos. Por ejemplo, UInt32 + UInt128 = UInt128 o Float32 * Float64 = Float64.
Si uno de los operandos es con signo, el tipo de resultado también será con signo; en caso contrario, será sin signo. Por ejemplo, UInt32 * Int32 = Int64 o UInt32 * UInt32 = UInt64.

Estas reglas garantizan que el tipo de resultado será el tipo más pequeño capaz de representar todos los resultados posibles. Aunque esto introduce un riesgo de desbordamiento cerca de los límites del rango de valores, garantiza que los cálculos se realicen rápidamente utilizando el ancho nativo máximo de enteros de 64 bits. Este comportamiento también garantiza la compatibilidad con muchas otras bases de datos que ofrecen enteros de 64 bits (BIGINT) como el mayor tipo entero. Ejemplo:

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                                   │
└───────────────┴────────────────────────┴─────────────────────────────────┴──────────────────────────────────────────┘

Los desbordamientos se producen de la misma forma que en C++.

abs

Introducido en: v1.1.0 Calcula el valor absoluto de x. No tiene efecto si x es de tipo sin signo. Si x es de tipo con signo, devuelve un número sin signo. Sintaxis

abs(x)

Argumentos

x — Valor del que se obtiene el valor absoluto

Valor devuelto El valor absoluto de x Ejemplos Ejemplo de uso

Query

SELECT abs(-0.5)

Response

0.5

avg2

Introducido en: v25.11.0 Calcula y devuelve el valor medio de los argumentos proporcionados. Admite tipos numéricos y temporales. Sintaxis

avg2(x1, x2])

Argumentos

x1, x2] — Acepta dos valores para promediarlos.

Valor devuelto Devuelve el valor medio de los argumentos proporcionados, expresado en el tipo compatible de mayor tamaño. Ejemplos Tipos numéricos

Query

SELECT avg2(toUInt8(3), 1.0) AS result, toTypeName(result) AS type;
-- El tipo devuelto es Float64 ya que el UInt8 debe promoverse a 64 bits para la comparación.

Response

┌─result─┬─type────┐
│      2 │ Float64 │
└────────┴─────────┘

Tipos decimales

Query

SELECT avg2(toDecimal32(1, 2), 2) AS result, toTypeName(result) AS type;

Response

┌─result─┬─type──────────┐
│    1.5 │ Decimal(9, 2) │
└────────┴───────────────┘

Tipos de dato Date

Query

SELECT avg2(toDate('2025-01-01'), toDate('2025-01-05')) AS result, toTypeName(result) AS type;

Response

┌─────result─┬─type─┐
│ 2025-01-03 │ Date │
└────────────┴──────┘

Tipos de 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 │
└─────────────────────┴──────────┘

Tipos 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

Introducido en: v23.10.0 Invierte los bytes de un entero, es decir, cambia su endianness. El ejemplo siguiente puede desglosarse de la siguiente manera:

Convierta el entero en base 10 a su formato hexadecimal equivalente en orden big-endian; es decir, 3351772109 -> C7 C7 FB CD (4 bytes)
Invierta los bytes; es decir, C7 C7 FB CD -> CD FB C7 C7
Convierta el resultado de nuevo en un entero asumiendo el orden big-endian; es decir, CD FB C7 C7 -> 3455829959 Un caso de uso de esta función es invertir direcciones IPv4:

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

Sintaxis

byteSwap(x)

Argumentos

x — Un valor entero. (U)Int*

Valor devuelto Devuelve x con los bytes en orden inverso. (U)Int* Ejemplos Ejemplo de uso

Query

SELECT byteSwap(3351772109)

Response

3455829959

8 bits

Query

SELECT byteSwap(54)

Response

16 bits

Query

SELECT byteSwap(4135)

Response

32 bits

Query

SELECT byteSwap(3351772109)

Response

3455829959

64 bits

Query

SELECT byteSwap(123294967295)

Response

18439412204227788800

divide

Introducido en: v1.1.0 Calcula el cociente de dos valores, a y b. El tipo de resultado siempre es Float64. La función intDiv proporciona la división entera.

La división por 0 devuelve inf, -inf o nan.

Sintaxis

divide(x, y)

Argumentos

x — Dividendo - y — Divisor

Valor devuelto El cociente de x entre y Ejemplos División de dos números

Query

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

Response

5	Float64

División por cero

Query

SELECT divide(25,0)

Response

inf

divideDecimal

Introducido en: v22.12.0 Realiza la división de dos números decimales. El valor resultante será de tipo Decimal256. La escala del resultado puede especificarse explícitamente mediante el argumento result_scale (un Integer constante en el rango [0, 76]). Si no se especifica, la escala del resultado será la escala máxima de los argumentos proporcionados.

Esta función es significativamente más lenta que divide. Si realmente no necesita precisión controlada y/o necesita un cálculo rápido, considere usar divide.

Sintaxis

divideDecimal(x, y[, result_scale])

Argumentos

x — Primer valor: Decimal. - y — Segundo valor: Decimal. - result_scale — Escala del resultado. Tipo Int/UInt.

Valor devuelto El resultado de la división con la escala especificada. Decimal256 Ejemplos Ejemplo 1

Query

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

Response

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

Ejemplo 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

Introducido en: v25.5.0 Igual que divide, pero devuelve NULL cuando se divide entre cero. Sintaxis

divideOrNull(x, y)

Argumentos

x — Dividendo - y — Divisor

Valor devuelto El cociente de x entre y, o NULL. Ejemplos División entre cero

Query

SELECT divideOrNull(25, 0)

Response

\N

gcd

Introducido en: v1.1.0 Devuelve el máximo común divisor de dos valores, a y b. Se produce una excepción al dividir por cero o al dividir el número negativo mínimo entre menos uno. Sintaxis

gcd(x, y)

Argumentos

x — Primer número entero - y — Segundo número entero

Valor devuelto El máximo común divisor de x y y. Ejemplos Ejemplo de uso

Query

SELECT gcd(12, 18)

Response

ifNotFinite

Introducido en: v20.3.0 Comprueba si un valor de punto flotante es finito. Puede obtener un resultado similar utilizando el operador ternario: isFinite(x) ? x : y. Sintaxis

ifNotFinite(x,y)

Argumentos

x — Valor que se comprueba para ver si es infinito. Float*
y — Valor alternativo. Float*

Valor devuelto

x si x es finito.
y si x no es finito.

Ejemplos Ejemplo de uso

Query

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

Response

inf	42

intDiv

Introducido en: v1.1.0 Realiza una división entera de dos valores, x entre y. En otras palabras, calcula el cociente redondeado hacia abajo al entero inferior más próximo. El resultado tiene el mismo tamaño que el dividendo (el primer parámetro). Se lanza una excepción al dividir por cero, cuando el cociente no cabe en el rango del dividendo o al dividir el número negativo mínimo entre menos uno. Sintaxis

intDiv(x, y)

Argumentos

x — Operando izquierdo. - y — Operando derecho.

Valor devuelto Resultado de la división entera entre x e y Ejemplos División entera de dos números de punto flotante

Query

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

Response

┌──res─┬─toTypeName(res)─┐
│ 1000 │ Int64           │
└──────┴─────────────────┘

El cociente no está dentro del rango del dividendo

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

Introducido en: v25.5.0 Igual que intDiv, pero devuelve NULL al dividir por cero o al dividir el número negativo mínimo entre menos uno. Sintaxis

intDivOrNull(x, y)

Argumentos

x — Operando izquierdo. (U)Int*
y — Operando derecho. (U)Int*

Valor devuelto Resultado de la división entera de x e y, o NULL. Ejemplos División entera entre cero

Query

SELECT intDivOrNull(1, 0)

Response

\N

División del número negativo mínimo entre -1

Query

SELECT intDivOrNull(-9223372036854775808, -1)

Response

\N

intDivOrZero

Introducido en: v1.1.0 Igual que intDiv, pero devuelve cero al dividir por cero o al dividir el número negativo mínimo entre menos uno. Sintaxis

intDivOrZero(a, b)

Argumentos

a — Operando izquierdo. (U)Int*
b — Operando derecho. (U)Int*

Valor devuelto Resultado de la división entera de a entre b, o cero. Ejemplos División entera por cero

Query

SELECT intDivOrZero(1, 0)

Response

Dividir el número negativo mínimo entre -1

Query

SELECT intDivOrZero(0.05, -1)

Response

isFinite

Introducido en: v1.1.0 Devuelve 1 si el argumento Float32 o Float64, o BFloat16 no es infinito ni es NaN; de lo contrario, esta función devuelve 0. Sintaxis

isFinite(x)

Argumentos

x — Número cuya finitud se comprueba. Float* o BFloat16

Valor devuelto 1 si x no es infinito ni NaN; en caso contrario, 0. Ejemplos Comprobar si un número es finito

Query

SELECT isFinite(inf)

Response

isInfinite

Introducido en: v1.1.0 Devuelve 1 si el argumento de tipo Float32 o Float64, o BFloat16 es infinito; en caso contrario, esta función devuelve 0. Tenga en cuenta que también se devuelve 0 para un NaN. Sintaxis

isInfinite(x)

Argumentos

x — Número que se comprueba para determinar si es infinito. Float* o BFloat16

Valor devuelto 1 si x es infinito; de lo contrario, 0 (también para NaN). Ejemplos Comprobar si un número es infinito

Query

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

Response

1	0	0

isNaN

Introducido en: v1.1.0 Devuelve 1 si el argumento de tipo Float32 o Float64, o BFloat16, es NaN; de lo contrario, devuelve 0. Sintaxis

isNaN(x)

Argumentos

x — Argumento que se evalúa para determinar si es NaN. Float* o BFloat16

Valor devuelto 1 si es NaN; de lo contrario, 0 Ejemplos Ejemplo de uso

Query

SELECT isNaN(NaN)

Response

kqlBin

Introducido en: v26.8.0 Redondea un valor hacia abajo hasta un múltiplo de roundTo, como lo hace bin() de Kusto Query Language. La regla depende de los tipos de los argumentos: un número se redondea aritméticamente, un intervalo de tiempo (que es un Interval) se redondea a un intervalo de tiempo y un DateTime se redondea a un intervalo de tiempo. Un DateTime de KQL es un DateTime64; los tipos portadores más restringidos, DateTime y Date, se rechazan porque no pueden representar todos los bins que puede producir un DateTime de KQL. Esta función implementa bin() cuando dialect = 'kusto'. No está pensada para invocarse directamente desde SQL. Sintaxis

kqlBin(value, roundTo)

Argumentos

value — Un número, un intervalo de tiempo o un DateTime (un DateTime64). - roundTo — El tamaño del bin.

Valor devuelto value redondeado hacia abajo al múltiplo de roundTo más cercano. Ejemplos número

Query

SELECT kqlBin(4.5, 1)

Response

intervalo de tiempo

Query

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

Response

1209600000000000

DateTime

Query

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

Response

2026-08-01 12:00:00.0000000

kqlBinAt

Disponible desde: v26.8.0 Redondea un valor hacia abajo hasta un múltiplo de binSize contado desde fixedPoint, como hace bin_at() de Kusto Query Language. Los bins pueden alinearse antes o después del punto fijo. La regla depende de los tipos de los argumentos: un número se redondea aritméticamente; un intervalo de tiempo (que es un Interval) se redondea mediante un intervalo de tiempo respecto a otro intervalo de tiempo, y un DateTime se redondea mediante un intervalo de tiempo contado desde un punto fijo de DateTime. Un DateTime de KQL es un DateTime64; los tipos más restringidos DateTime y Date se rechazan, ya que no pueden representar todos los bins que puede producir un DateTime de KQL. Esta función implementa bin_at() cuando dialect = 'kusto'. No está pensada para llamarse directamente desde SQL. Sintaxis

kqlBinAt(value, binSize, fixedPoint)

Argumentos

value — Un número, un intervalo de tiempo o un DateTime (un DateTime64). - binSize — El tamaño del intervalo. - fixedPoint — El punto a partir del cual se cuentan los intervalos.

Valor devuelto value redondeado hacia abajo al múltiplo de binSize más cercano, a partir de fixedPoint. Ejemplos número

Query

SELECT kqlBinAt(6.5, 2.5, -0.5)

Response

4.5

DateTime

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

Introducido en: v26.8.0 Redondea un DateTime hacia abajo al múltiplo de intervalo de tiempo contado desde un punto fijo DateTime. Sintaxis

kqlDateTimeBinAt(value, binSize, fixedPoint)

Argumentos

value — El DateTime que se redondeará. - binSize — El tamaño del intervalo de tiempo. - fixedPoint — El punto fijo de DateTime.

Valor devuelto El DateTime redondeado. Ejemplos

kqlDivide

Introducido en: v26.8.0 División tal como la define Kusto Query Language: dos operandos enteros dan como resultado un entero, por lo que 7 / 2 es 3, y dos operandos intervalo de tiempo (que son valores Interval) dan como resultado su cociente de valor real, por lo que 15ms / 10ms es 1.5. Cualquier otra combinación de tipos de operandos se divide como divide. Esta función implementa el operador / cuando dialect = 'kusto'. No está pensada para invocarse directamente desde SQL. Sintaxis

kqlDivide(x, y)

Argumentos

x — El dividendo. - y — El divisor.

Valor devuelto intDiv(x, y) si ambos argumentos son enteros; la razón entre los ticks de los intervalos si ambos son intervalos; divide(x, y) en caso contrario. Ejemplos enteros

Query

SELECT kqlDivide(7, 2)

Response

reales

Query

SELECT kqlDivide(7.0, 2)

Response

3.5

intervalos de tiempo

Query

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

Response

1.5

kqlMultiply

Introducido en: v26.8.0 Multiplicación tal como la define Kusto Query Language: un intervalo de tiempo (un Interval) se multiplica por un número a cualquiera de los lados, por lo que 2 * 1h equivale a dos horas. Dos argumentos sin un intervalo se multiplican como lo hace multiply. Esta función implementa el operador * cuando dialect = 'kusto'. No está pensada para invocarse directamente desde SQL. Sintaxis

kqlMultiply(x, y)

Argumentos

x — Un número o un intervalo de tiempo. - y — Un número o un intervalo de tiempo si x es un número.

Valor devuelto El producto; un intervalo del mismo tipo cuando alguno de los argumentos lo es. Ejemplos intervalo de tiempo

Query

SELECT kqlMultiply(2, toIntervalNanosecond(3600000000000))

Response

7200000000000

números

Query

SELECT kqlMultiply(6, 7)

Response

kqlRangeCount

Introducida en: v26.8.0 El número de filas que genera la fuente range de Kusto Query Language: floor((to - from) / step) + 1, y nunca inferior a cero. Los límites y el paso pueden ser números, valores de fecha y hora incrementados mediante un intervalo de tiempo (un Interval) o intervalos de tiempo; las formas temporales se cuentan en nanosegundos enteros, algo que no puede expresarse con una única división de ClickHouse. Los enteros y los decimales se cuentan de forma exacta, no mediante Float64. Esta función respalda la fuente range cuando dialect = 'kusto'. No está diseñada para invocarse directamente desde SQL. Sintaxis

kqlRangeCount(from, to, step)

Argumentos

from — El primer valor del rango. - to — El valor que el rango no supera. - step — La diferencia entre dos valores consecutivos.

Valor devuelto El número de valores del rango. Ejemplos numbers

Query

SELECT kqlRangeCount(1, 7, 2)

Response

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

lcm

Introducido en: v1.1.0 Devuelve el mínimo común múltiplo de dos valores x e y. Se produce una excepción al dividir por cero o al dividir el número negativo mínimo entre menos uno. Sintaxis

lcm(x, y)

Argumentos

x — Primer entero. (U)Int*
y — Segundo entero. (U)Int*

Valor devuelto Devuelve el mínimo común múltiplo de x e y. (U)Int* Ejemplos Ejemplo de uso

Query

SELECT lcm(6, 8)

Response

max2

Introducida en: v21.11.0 Devuelve el valor mayor de dos valores numéricos x e y. Sintaxis

max2(x, y)

Argumentos

x — Primer valor (U)Int8/16/32/64 o Float* o BFloat16 o Decimal
y — Segundo valor (U)Int8/16/32/64 o Float* o BFloat16 o Decimal

Valor devuelto Devuelve el mayor de los valores x e y. Float64 Ejemplos Ejemplo de uso

Query

SELECT max2(-1, 2)

Response

midpoint

Introducido en: v25.11.0 Calcula y devuelve el valor medio de los argumentos proporcionados. Admite tipos numéricos y temporales. Sintaxis

midpoint(x1[, x2, ...])

Argumentos

x1[, x2, ...] — Acepta un solo valor o varios para calcular el promedio.

Valor devuelto Devuelve el valor medio de los argumentos proporcionados, convertido al tipo compatible de mayor tamaño. Ejemplos Tipos numéricos

Query

SELECT midpoint(1, toUInt8(3), 0.5) AS result, toTypeName(result) AS type;
-- El tipo devuelto es Float64 ya que el UInt8 debe promoverse a 64 bits para la comparación.

Response

┌─result─┬─type────┐
│    1.5 │ Float64 │
└────────┴─────────┘

Tipos decimales

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) │
└────────┴───────────────┘

Tipos de Date

Query

SELECT midpoint(toDate('2025-01-01'), toDate('2025-01-05')) AS result, toTypeName(result) AS type;

Response

┌─────result─┬─type─┐
│ 2025-01-03 │ Date │
└────────────┴──────┘

Tipos de 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 │
└─────────────────────┴──────────┘

Tipos de 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

Introducido en: v21.11.0 Devuelve el más pequeño de dos valores numéricos, x e y. Sintaxis

min2(x, y)

Argumentos

x — Primer valor (U)Int8/16/32/64 o Float* o BFloat16 o Decimal
y — Segundo valor (U)Int8/16/32/64 o Float* o BFloat16 o Decimal

Valor devuelto Devuelve el menor valor entre x e y. Float64 Ejemplos Ejemplo de uso

Query

SELECT min2(-1, 2)

Response

-1

minus

Introducido en: v1.1.0 Calcula la diferencia entre dos valores, a y b. El resultado siempre tiene signo. Al igual que con plus, es posible restar un entero de una fecha o de una fecha con hora. Además, se admite la resta entre fechas con hora, lo que da como resultado la diferencia de tiempo entre ambas. También es posible restar un Time o Time64 de un DateTime o DateTime64; el valor de tiempo se aplica como un desplazamiento en segundos. DateTime menos Time produce un DateTime; cualquier combinación que incluya DateTime64 o Time64 produce un DateTime64 con la escala máxima de los dos argumentos. Sintaxis

minus(x, y)

Argumentos

x — Minuendo. - y — Sustraendo.

Valor devuelto x menos y Ejemplos Resta de dos números

Query

SELECT minus(10, 5)

Response

Resta entre un entero y una fecha

Query

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

Response

2024-12-27

modulo

Introducido en: v1.1.0 Calcula el resto de la división de dos valores, a entre b. El tipo de resultado es un entero si ambas entradas son enteras. Si una de las entradas es un número de coma flotante, el tipo de resultado es Float64. El resto se calcula igual que en C++. Para los números negativos, se usa la división truncada. Se genera una excepción al dividir por cero o al dividir el número negativo mínimo entre menos uno. Sintaxis

modulo(a, b)

Alias: mod Argumentos

a — El dividendo - b — El divisor (módulo)

Valor devuelto El resto de a % b Ejemplos Ejemplo de uso

Query

SELECT modulo(5, 2)

Response

moduloLegacy

Introducido en: v1.1.0 Calcula el resto de una división. Esta es la implementación heredada de módulo que usa el operador % de C++, que puede producir resultados negativos con argumentos negativos. Esta función existe por compatibilidad retroactiva con la lógica antigua de particionado de tablas. Utilice modulo o positiveModulo para el comportamiento estándar. Sintaxis

moduloLegacy(a, b)

Argumentos

a — El dividendo. (U)Int* o Float*
b — El divisor. (U)Int* o Float*

Valor devuelto Devuelve el resto de la división. (U)Int* o Float* Ejemplos Uso básico

Query

SELECT moduloLegacy(10, 3)

Response

moduloOrNull

Introducido en: v25.5.0 Calcula el resto de dividir a entre b. Es similar a la función modulo, excepto que moduloOrNull devuelve NULL cuando, de otro modo, la operación produciría una excepción de coma flotante. En el caso de argumentos de coma flotante, esto ocurre solo cuando el divisor es 0; para argumentos enteros, además cubre el caso del valor negativo mínimo módulo -1 (por ejemplo, -128 % -1 para Int8). Sintaxis

moduloOrNull(x, y)

Alias: modOrNull Argumentos

x — El dividendo. (U)Int* o Float*
y — El divisor (módulo). (U)Int* o Float*

Valor devuelto Devuelve el resto de la división de x entre y, o NULL cuando la operación produciría una excepción de coma flotante: cuando el divisor es cero o, en el caso de argumentos enteros, al calcular el valor negativo mínimo módulo -1. Ejemplos moduloOrNull con cero

Query

SELECT moduloOrNull(5, 0)

Response

\N

moduloOrNull del entero negativo mínimo con -1

Query

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

Response

\N

moduloOrZero

Introducido en: v20.3.0 Como modulo, pero devuelve cero en lugar de una excepción para resultados enteros cuando la operación generaría una excepción. Para resultados de coma flotante, un divisor cero produce NaN. Sintaxis

moduloOrZero(a, b)

Argumentos

a — El dividendo. (U)Int* o Float*
b — El divisor (módulo). (U)Int* o Float*

Valor devuelto Devuelve el resto de a % b. Para resultados enteros, devuelve 0 en los casos en que la operación generaría una excepción. Para resultados de coma flotante, un divisor cero produce NaN. Ejemplos Divisor cero entero

Query

SELECT moduloOrZero(5, 0)

Response

Divisor cero de coma flotante

Query

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

Response

nan

multiply

Introducido en: v1.1.0 Calcula el producto de dos valores x y y. Sintaxis

multiply(x, y)

Argumentos

x — factor. (U)Int* o Float* o Decimal
y — factor. (U)Int* o Float* o Decimal

Valor devuelto Devuelve el producto de x e y Ejemplos Multiplicación de dos números

Query

SELECT multiply(5,5)

Response

multiplyDecimal

Introducido en: v22.12.0 Realiza la multiplicación de dos valores decimales. El valor resultante será de tipo Decimal256. La escala del resultado puede especificarse explícitamente mediante el argumento result_scale (Integer constante en el rango [0, 76]). Si no se especifica, la escala del resultado será la escala máxima de los argumentos proporcionados.

Estas funciones son considerablemente más lentas que multiply. Si realmente no necesita precisión controlada o necesita un cálculo rápido, considere usar multiply

Sintaxis

multiplyDecimal(a, b[, result_scale])

Argumentos

a — Primer valor. Decimal
b — Segundo valor. Decimal
result_scale — Escala del resultado. (U)Int*

Valor devuelto El resultado de la multiplicación con la escala indicada. Tipo: Decimal256 Ejemplos Ejemplo de uso

Query

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

Response

25.2

Diferencia con la multiplicación normal

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 │
└──────────────────────────────────────────────────────────────────┘

Sin desbordamiento con 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 │
└───────────────┴───────────────┴───────────────────────┘

Desbordamiento del tipo Decimal con la multiplicación normal

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

Introducido en: v1.1.0 Devuelve el valor negado del argumento x. El resultado siempre es con signo. Sintaxis

negate(x)

Argumentos

x — El valor que se va a negar.

Valor devuelto Devuelve -x de x Ejemplos Ejemplo de uso

Query

SELECT negate(10)

Response

-10

plus

Introducido en: v1.1.0 Calcula la suma de dos valores x e y. Alias: x + y (operador). Es posible sumar un entero y una fecha o una fecha con hora. La primera operación aumenta el número de días de la fecha; la segunda aumenta el número de segundos de la fecha con hora. También es posible sumar una fecha y una hora. Sumar un Date y un Time produce un DateTime. Sumar un Date y un Time64, o un Date32 y un Time o Time64, produce un DateTime64. Sumar un Time o Time64 a un DateTime o DateTime64 aplica el valor de tiempo como un desplazamiento en segundos. DateTime más Time produce un DateTime; cualquier combinación que incluya DateTime64 o Time64 produce un DateTime64 con la escala máxima de los dos argumentos. Sintaxis

plus(x, y)

Argumentos

x — operando izquierdo. - y — operando derecho.

Valor devuelto Devuelve la suma de x e y Ejemplos Suma de dos números

Query

SELECT plus(5,5)

Response

Sumar un entero a una fecha

Query

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

Response

2025-01-06

Agregar fecha y hora

Query

SELECT toDate('2025-01-01') + CAST('14:30:25', 'Time')

Response

2025-01-01 14:30:25

positiveModulo

Introducido en: v22.11.0 Calcula el resto de dividir x entre y. Es similar a la función modulo, salvo que positiveModulo siempre devuelve un número no negativo. Sintaxis

positiveModulo(x, y)

Alias: positive_modulo, pmod Argumentos

x — El dividendo. (U)Int* o Float* o Decimal
y — El divisor (módulo). (U)Int* o Float* o Decimal

Valor devuelto Devuelve la diferencia entre x y el entero más cercano, no mayor que x, que sea divisible por y. Ejemplos Ejemplo de uso

Query

SELECT positiveModulo(-1, 10)

Response

positiveModuloOrNull

Introducido en: v25.5.0 Calcula el resto de dividir a entre b. Es similar a la función positiveModulo, salvo que positiveModuloOrNull devuelve NULL cuando la operación provocaría de otro modo una excepción de coma flotante. En el caso de argumentos de coma flotante, esto solo ocurre cuando el divisor es 0; para argumentos enteros, además cubre el valor negativo mínimo módulo -1 (por ejemplo, -128 % -1 para Int8). Sintaxis

positiveModuloOrNull(x, y)

Alias: positive_modulo_or_null, pmodOrNull Argumentos

x — El dividendo. (U)Int*/Float32/64. - y — El divisor (módulo). (U)Int*/Float32/64.

Valor devuelto Devuelve la diferencia entre x y el entero más cercano, no mayor que x, divisible por y, o NULL cuando la operación produciría una excepción de coma flotante: cuando el divisor es cero o, para argumentos enteros, al calcular el valor negativo mínimo módulo -1. Ejemplos positiveModuloOrNull con cero

Query

SELECT positiveModuloOrNull(5, 0)

Response

\N

positiveModuloOrNull del entero negativo mínimo dividido entre -1

Query

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

Response

\N

sqr

Introducido en: v26.7.0 Calcula el cuadrado de un valor x. Sintaxis

sqr(x)

Argumentos

x — Valor que se elevará al cuadrado. (U)Int* o Float* o Decimal

Valor devuelto Devuelve el producto de x por sí mismo. Ejemplos Elevar al cuadrado un número

Query

SELECT sqr(5)

Response

​Descripción general

​abs

​avg2

​byteSwap

​divide

​divideDecimal

​divideOrNull

​gcd

​ifNotFinite

​intDiv

​intDivOrNull

​intDivOrZero

​isFinite

​isInfinite

​isNaN

​kqlBin

​kqlBinAt

​kqlDateTimeBinAt

​kqlDivide

​kqlMultiply

​kqlRangeCount

​lcm

​max2

​midpoint

​min2

​minus

​modulo

​moduloLegacy

​moduloOrNull

​moduloOrZero

​multiply

​multiplyDecimal

​negate

​plus

​positiveModulo

​positiveModuloOrNull

​sqr

Descripción general

abs

avg2

byteSwap

divide

divideDecimal

divideOrNull

gcd

ifNotFinite

intDiv

intDivOrNull

intDivOrZero

isFinite

isInfinite

isNaN

kqlBin

kqlBinAt

kqlDateTimeBinAt

kqlDivide

kqlMultiply

kqlRangeCount

lcm

max2

midpoint

min2

minus

modulo

moduloLegacy

moduloOrNull

moduloOrZero

multiply

multiplyDecimal

negate

plus

positiveModulo

positiveModuloOrNull

sqr