> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-3a82795f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentación sobre funciones matemáticas

# Funciones matemáticas

{/*AUTOGENERATED_START*/}

<div id="acos">
  ## acos
</div>

Introducido en: v1.1.0

Devuelve el arcocoseno del argumento.

**Sintaxis**

```sql theme={null}
acos(x)
```

**Argumentos**

* `x` — El valor cuyo arcocoseno se desea calcular. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el arcocoseno de x [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT acos(0.5);
```

```response title=Response theme={null}
1.0471975511965979
```

<div id="acosh">
  ## acosh
</div>

Introducido en: v20.12.0

Devuelve el coseno hiperbólico inverso.

**Sintaxis**

```sql theme={null}
acosh(x)
```

**Argumentos**

* `x` — Coseno hiperbólico del ángulo. Valores en el intervalo: `1 ≤ x < +∞`. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el ángulo en radianes. Valores en el intervalo: `0 ≤ acosh(x) < +∞`. [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT acosh(1)
```

```response title=Response theme={null}
0
```

<div id="asin">
  ## asin
</div>

Introducido en: v1.1.0

Calcula el arcoseno del argumento indicado.
Para argumentos en el intervalo `[-1, 1]`, devuelve un valor en el intervalo `[-pi() / 2, pi() / 2]`.

**Sintaxis**

```sql theme={null}
asin(x)
```

**Argumentos**

* `x` — Argumento cuyo arcoseno se calcula. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el valor del arcoseno del argumento `x` [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**inversa**

```sql title=Query theme={null}
SELECT asin(1.0) = pi() / 2, sin(asin(1)), asin(sin(1))
```

```response title=Response theme={null}
1 1 1
```

**float32**

```sql title=Query theme={null}
SELECT toTypeName(asin(1.0::Float32))
```

```response title=Response theme={null}
Float64
```

**nan**

```sql title=Query theme={null}
SELECT asin(1.1), asin(-2), asin(inf), asin(nan)
```

```response title=Response theme={null}
nan nan nan nan
```

<div id="asinh">
  ## asinh
</div>

Introducido en: v20.12.0

Devuelve el arcoseno hiperbólico.

**Sintaxis**

```sql theme={null}
asinh(x)
```

**Argumentos**

* `x` — Seno hiperbólico del ángulo. Valores en el intervalo: `-∞ < x < +∞`. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el ángulo, en radianes. Valores en el intervalo: `-∞ < asinh(x) < +∞`. [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Uso básico**

```sql title=Query theme={null}
SELECT asinh(0)
```

```response title=Response theme={null}
0
```

<div id="atan">
  ## atan
</div>

Introducido en: v1.1.0

Devuelve la arcotangente del argumento.

**Sintaxis**

```sql theme={null}
atan(x)
```

**Argumentos**

* `x` — El valor cuya arcotangente se desea calcular. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve la arcotangente de `x`. [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT atan(1);
```

```response title=Response theme={null}
0.7853981633974483
```

<div id="atan2">
  ## atan2
</div>

Introducido en: v20.12.0

Devuelve atan2 como el ángulo en el plano euclidiano, expresado en radianes, entre el eje x positivo y la semirrecta que pasa por el punto `(x, y) ≠ (0, 0)`.

**Sintaxis**

```sql theme={null}
atan2(y, x)
```

**Argumentos**

* `y` — coordenada y del punto por el que pasa el rayo. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)
* `x` — coordenada x del punto por el que pasa el rayo. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el ángulo `θ` tal que `-π < θ ≤ π`, en radianes. [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT atan2(1, 1)
```

```response title=Response theme={null}
0.7853981633974483
```

<div id="atanh">
  ## atanh
</div>

Introducido en: v20.12.0

Devuelve la tangente hiperbólica inversa.

**Sintaxis**

```sql theme={null}
atanh(x)
```

**Argumentos**

* `x` — Tangente hiperbólica del ángulo. Valores en el intervalo: -1 \< x \< 1. `(U)Int*`, `Float*` o `Decimal*`. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el ángulo en radianes. Valores en el intervalo: -∞ \< atanh(x) \< +∞ [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT atanh(0)
```

```response title=Response theme={null}
0
```

<div id="cbrt">
  ## cbrt
</div>

Introducida en: v1.1.0

Devuelve la raíz cúbica del argumento.

**Sintaxis**

```sql theme={null}
cbrt(x)
```

**Argumentos**

* `x` — El valor del que se desea obtener la raíz cúbica. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve la raíz cúbica de `x`. [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT cbrt(8);
```

```response title=Response theme={null}
2
```

<div id="cos">
  ## cos
</div>

Introducido en: v1.1.0

Devuelve el coseno del argumento.

**Sintaxis**

```sql theme={null}
cos(x)
```

**Argumentos**

* `x` — El ángulo en radianes. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el coseno hiperbólico de `x`. [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT cos(0);
```

```response title=Response theme={null}
1
```

<div id="cosh">
  ## cosh
</div>

Introducido en: v20.12.0

Devuelve el coseno hiperbólico del argumento.

**Sintaxis**

```sql theme={null}
cosh(x)
```

**Argumentos**

* `x` — El ángulo, en radianes. Valores en el intervalo: `-∞ < x < +∞`. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve valores en el intervalo: `1 ≤ cosh(x) < +∞` [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Uso básico**

```sql title=Query theme={null}
SELECT cosh(0)
```

```response title=Response theme={null}
1
```

<div id="degrees">
  ## degrees
</div>

Introducido en: v22.2.0

Convierte radianes a grados.

**Sintaxis**

```sql theme={null}
degrees(x)
```

**Argumentos**

* `x` — Valor de entrada en radianes. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el valor de `x` en grados. [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Uso básico**

```sql title=Query theme={null}
SELECT degrees(3.141592653589793)
```

```response title=Response theme={null}
180
```

<div id="e">
  ## e
</div>

Disponible desde: v1.1.0

Devuelve la constante de Euler (e).

**Sintaxis**

```sql theme={null}
e()
```

**Argumentos**

* Ninguno.

**Valor devuelto**

Devuelve la constante de Euler [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT e();
```

```response title=Response theme={null}
2.718281828459045
```

<div id="erf">
  ## erf
</div>

Introducido en: v1.1.0

Si `x` no es negativo, entonces `erf(x/(σ√2))` es la probabilidad de que una variable aleatoria con distribución normal y desviación estándar `σ` tome un valor que difiera del valor esperado en más de `x`.

**Sintaxis**

```sql theme={null}
erf(x)
```

**Argumentos**

* `x` — El valor para el que se calcula la función de error. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el valor de la función de error [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Regla de las tres sigmas**

```sql title=Query theme={null}
SELECT erf(3 / sqrt(2))
```

```response title=Response theme={null}
┌─erf(divide(3, sqrt(2)))─┐
│      0.9973002039367398 │
└─────────────────────────┘
```

<div id="erfc">
  ## erfc
</div>

Introducido en: v1.1.0

Devuelve un número próximo a `1-erf(x)` sin pérdida de precisión para valores grandes de `x`.

**Sintaxis**

```sql theme={null}
erfc(x)
```

**Argumentos**

* `x` — El valor cuyo valor de la función de error se quiere obtener. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el valor de la función de error complementaria [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT erfc(0);
```

```response title=Response theme={null}
1
```

<div id="exp">
  ## exp
</div>

Introducido en: v1.1.0

Devuelve e elevada a la potencia de `x`, donde `x` es el argumento dado de la función.

**Sintaxis**

```sql theme={null}
exp(x)
```

**Argumentos**

* `x` — El exponente. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve `e^x` [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Uso básico**

```sql title=Query theme={null}
SELECT round(exp(-1), 4)
```

```response title=Response theme={null}
┌─round(exp(-1), 4)─┐
│            0.3679 │
└───────────────────┘
```

<div id="exp10">
  ## exp10
</div>

Introducido en: v1.1.0

Devuelve 10 elevado a la potencia del argumento dado.

**Sintaxis**

```sql theme={null}
exp10(x)
```

**Argumentos**

* `x` — El exponente. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve 10^x [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT exp10(2);
```

```response title=Response theme={null}
100
```

<div id="exp2">
  ## exp2
</div>

Introducido en: v1.1.0

Devuelve 2 elevado al argumento dado.

**Sintaxis**

```sql theme={null}
exp2(x)
```

**Argumentos**

* `x` — El exponente. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve 2^x [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT exp2(3);
```

```response title=Response theme={null}
8
```

<div id="factorial">
  ## factorial
</div>

Introducido en: v22.11.0

Calcula el factorial de un valor entero.
El factorial de 0 es 1. Asimismo, la función `factorial()` devuelve `1` para cualquier valor negativo.
El valor positivo máximo del argumento de entrada es `20`; un valor de `21` o superior provocará una excepción.

**Sintaxis**

```sql theme={null}
factorial(n)
```

**Argumentos**

* `n` — Valor entero para el que se calcula el factorial. El valor máximo es 20. [`(U)Int8/16/32/64`](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve el factorial del valor de entrada como UInt64. Devuelve 1 para el valor de entrada 0 o cualquier valor negativo. [`UInt64`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
factorial(10)
```

```response title=Response theme={null}
3628800
```

<div id="hypot">
  ## hypot
</div>

Introducido en: v20.12.0

Devuelve la longitud de la hipotenusa de un triángulo rectángulo.
`hypot` evita los problemas que se producen al elevar al cuadrado números muy grandes o muy pequeños.

**Sintaxis**

```sql theme={null}
hypot(x, y)
```

**Argumentos**

* `x` — El primer cateto de un triángulo rectángulo. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)
* `y` — El segundo cateto de un triángulo rectángulo. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve la longitud de la hipotenusa de un triángulo rectángulo. [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Uso básico**

```sql title=Query theme={null}
SELECT hypot(1, 1)
```

```response title=Response theme={null}
1.4142135623730951
```

<div id="intExp10">
  ## intExp10
</div>

Introducido en: v1.1.0

Igual que [exp10](#exp10), pero devuelve un número `UInt64`.

**Sintaxis**

```sql theme={null}
intExp10(x)
```

**Argumentos**

* `x` — El exponente. [`Int*`](/es/reference/data-types/int-uint) o [`UInt*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float)

**Valor devuelto**

Devuelve 10^x. [`UInt64`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT intExp10(2);
```

```response title=Response theme={null}
100
```

<div id="intExp2">
  ## intExp2
</div>

Introducido en: v1.1.0

Igual que [exp2](#exp2), pero devuelve un número `UInt64`.

**Sintaxis**

```sql theme={null}
intExp2(x)
```

**Argumentos**

* `x` — El exponente. [`Int*`](/es/reference/data-types/int-uint) o [`UInt*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float)

**Valor devuelto**

Devuelve 2^x. [`UInt64`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT intExp2(3);
```

```response title=Response theme={null}
8
```

<div id="isPrime">
  ## isPrime
</div>

Introducido en: v26.5.0

Devuelve `1` si el argumento es un número primo; de lo contrario, `0`.

Usa un bitmap de búsqueda exacta para valores pequeños y una [prueba de Miller-Rabin](https://en.wikipedia.org/wiki/Miller-Rabin_primality_test) determinista
para valores más grandes. El resultado es exacto para todos los tipos de entrada admitidos.

Para tipos de enteros sin signo de mayor tamaño (`UInt128`, `UInt256`), use [`isProbablePrime`](/es/reference/functions/regular-functions/math-functions#isProbablePrime) en su lugar.

**Sintaxis**

```sql theme={null}
isPrime(n)
```

**Argumentos**

* `n` — Entero sin signo que se va a comprobar si es primo. [`UInt8`](/es/reference/data-types/int-uint) o [`UInt16`](/es/reference/data-types/int-uint) o [`UInt32`](/es/reference/data-types/int-uint) o [`UInt64`](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve `1` si `n` es primo; en caso contrario, `0`. [`UInt8`](/es/reference/data-types/int-uint)

**Ejemplos**

**Número primo**

```sql title=Query theme={null}
SELECT isPrime(17)
```

```response title=Response theme={null}
1
```

**Número compuesto**

```sql title=Query theme={null}
SELECT isPrime(18)
```

```response title=Response theme={null}
0
```

**Número primo grande de `UInt64`**

```sql title=Query theme={null}
SELECT isPrime(18446744073709551557)
```

```response title=Response theme={null}
1
```

**Valor máximo de `UInt64`**

```sql title=Query theme={null}
SELECT isPrime(18446744073709551615)
```

```response title=Response theme={null}
0
```

<div id="isProbablePrime">
  ## isProbablePrime
</div>

Introducido en: v26.5.0

Devuelve `1` si el argumento probablemente es primo y `0` si sin duda es compuesto.

Para `UInt8`, `UInt16`, `UInt32` y `UInt64`, el resultado es exacto y coincide con
[`isPrime`](/es/reference/functions/regular-functions/math-functions#isPrime). El argumento `rounds` se ignora.

Para `UInt128` y `UInt256`, un valor de retorno de `1` es probabilístico. El argumento opcional `rounds` controla
cuántas rondas de [Miller-Rabin](https://en.wikipedia.org/wiki/Miller-Rabin_primality_test) se usan:
cuantas más rondas, menor es la probabilidad de un falso positivo y mayor el tiempo de ejecución. Con testigos aleatorios uniformes,
la tasa de falsos positivos para un compuesto fijo está acotada por `4^(-rounds)`; el valor predeterminado de `25`
mantiene esta cota por debajo de `10^-15`, y el máximo de `256` la mantiene por debajo de `10^-154`.

La función es determinista: los testigos se derivan de `n`, por lo que el mismo par `(n, rounds)` siempre produce
el mismo resultado. La cota `4^(-rounds)` es la probabilidad por entrada con testigos aleatorios uniformes;
con nuestra inicialización determinista, en cambio, describe una fracción de las entradas: un compuesto que engañe a su
secuencia de testigos devolverá `1` de forma reproducible.

**Sintaxis**

```sql theme={null}
isProbablePrime(n[, rounds])
```

**Argumentos**

* `n` — Entero sin signo que se va a comprobar si es primo. [`UInt8`](/es/reference/data-types/int-uint) o [`UInt16`](/es/reference/data-types/int-uint) o [`UInt32`](/es/reference/data-types/int-uint) o [`UInt64`](/es/reference/data-types/int-uint) o [`UInt128`](/es/reference/data-types/int-uint) o [`UInt256`](/es/reference/data-types/int-uint)
* `rounds` — Constante entera positiva opcional en `[1, 256]`. Número de rondas de Miller-Rabin para `UInt128`/`UInt256` (se ignora en tipos más pequeños). El valor predeterminado es `25`. [`UInt8`](/es/reference/data-types/int-uint) o [`UInt16`](/es/reference/data-types/int-uint) o [`UInt32`](/es/reference/data-types/int-uint) o [`UInt64`](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve `1` si `n` probablemente es primo y `0` si definitivamente es compuesto. [`UInt8`](/es/reference/data-types/int-uint)

**Ejemplos**

**Primo pequeño**

```sql title=Query theme={null}
SELECT isProbablePrime(17)
```

```response title=Response theme={null}
1
```

**Número compuesto pequeño**

```sql title=Query theme={null}
SELECT isProbablePrime(18)
```

```response title=Response theme={null}
0
```

**El número primo `UInt64` más grande (resultado exacto)**

```sql title=Query theme={null}
SELECT isProbablePrime(18446744073709551557)
```

```response title=Response theme={null}
1
```

**Número primo de Mersenne `M_127` (`UInt128`)**

```sql title=Query theme={null}
SELECT isProbablePrime(toUInt128('170141183460469231731687303715884105727'))
```

```response title=Response theme={null}
1
```

**Número primo del campo base de Curve25519 `2^255 - 19` (`UInt256`)**

```sql title=Query theme={null}
SELECT isProbablePrime(toUInt256('57896044618658097711785492504343953926634992332820282019728792003956564819949'))
```

```response title=Response theme={null}
1
```

**Verificación más rápida, con menor fiabilidad: 5 rondas**

```sql title=Query theme={null}
SELECT isProbablePrime(toUInt256('57896044618658097711785492504343953926634992332820282019728792003956564819949'), 5)
```

```response title=Response theme={null}
1
```

<div id="lgamma">
  ## lgamma
</div>

Introducido en: v1.1.0

Devuelve el logaritmo de la función gamma.

**Sintaxis**

```sql theme={null}
lgamma(x)
```

**Argumentos**

* `x` — El número del que se calcula el logaritmo de la función gamma. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el logaritmo de la función gamma de `x`. [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT lgamma(5);
```

```response title=Response theme={null}
3.1780538303479458
```

<div id="log">
  ## log
</div>

Introducido en: v1.1.0

Devuelve el logaritmo natural del argumento.

**Sintaxis**

```sql theme={null}
log(x)
```

**Alias**: `ln`

**Argumentos**

* `x` — El número del que se calcula el logaritmo natural. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el logaritmo natural de `x`. [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT log(10);
```

```response title=Response theme={null}
2.302585092994046
```

<div id="log10">
  ## log10
</div>

Introducido en: v1.1.0

Devuelve el logaritmo decimal del argumento.

**Sintaxis**

```sql theme={null}
log10(x)
```

**Argumentos**

* `x` — Número para el que se calcula el logaritmo decimal. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el logaritmo decimal de `x`. [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT log10(100);
```

```response title=Response theme={null}
2
```

<div id="log1p">
  ## log1p
</div>

Introducida en: v20.12.0

Calcula log(1+x).
El cálculo de `log1p(x)` es más preciso que log(1+x) para valores pequeños de `x`.

**Sintaxis**

```sql theme={null}
log1p(x)
```

**Argumentos**

* `x` — Valores en el intervalo: `-1 < x < +∞`. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve valores en el intervalo: -∞ \< log1p(x) \< +∞ [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT log1p(0)
```

```response title=Response theme={null}
0
```

<div id="log2">
  ## log2
</div>

Introducido en: v1.1.0

Devuelve el logaritmo binario del argumento.

**Sintaxis**

```sql theme={null}
log2(x)
```

**Argumentos**

* `x` — El número cuyo logaritmo binario se debe calcular. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el logaritmo binario de `x`. [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT log2(8);
```

```response title=Response theme={null}
3
```

<div id="pi">
  ## pi
</div>

Introducido en: v1.1.0

Devuelve pi (π).

**Sintaxis**

```sql theme={null}
pi()
```

**Argumentos**

* Ninguno.

**Valor devuelto**

Devuelve pi [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT pi();
```

```response title=Response theme={null}
3.141592653589793
```

<div id="pow">
  ## pow
</div>

Introducido en: v1.1.0

Devuelve x elevado a y.

**Sintaxis**

```sql theme={null}
pow(x, y)
```

**Alias**: `power`

**Argumentos**

* `x` — La base. [`(U)Int8/16/32/64`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)
* `y` — El exponente. [`(U)Int8/16/32/64`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve x^y como [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT pow(2, 3);
```

```response title=Response theme={null}
8
```

<div id="proportionsZTest">
  ## proportionsZTest
</div>

Introducido en: v22.3.0

Devuelve estadísticas de prueba para la prueba Z de dos proporciones, una prueba estadística para comparar las proporciones de dos poblaciones, x e y.
La función admite métodos de estimación combinada y no combinada para el error estándar.
En la versión combinada, las dos proporciones se promedian y se utiliza una sola proporción para estimar el error estándar.
En la versión no combinada, las dos proporciones se utilizan por separado.

**Sintaxis**

```sql theme={null}
proportionsZTest(successes_x, successes_y, trials_x, trials_y, conf_level, pool_type)
```

**Argumentos**

* `successes_x` — Número de éxitos en la población x. [`UInt64`](/es/reference/data-types/int-uint)
* `successes_y` — Número de éxitos en la población y. [`UInt64`](/es/reference/data-types/int-uint)
* `trials_x` — Número de ensayos en la población x. [`UInt64`](/es/reference/data-types/int-uint)
* `trials_y` — Número de ensayos en la población y. [`UInt64`](/es/reference/data-types/int-uint)
* `conf_level` — Nivel de confianza de la prueba. [`Float64`](/es/reference/data-types/float)
* `pool_type` — Selección del método de agrupación para estimar el error estándar. Puede ser 'unpooled' o 'pooled'. [`String`](/es/reference/data-types/string)

**Valor devuelto**

Devuelve una tupla que contiene: `z_stat` (estadístico Z), `p_val` (valor p), `ci_low` (límite inferior del intervalo de confianza), `ci_high` (límite superior del intervalo de confianza). [`Tuple(Float64, Float64, Float64, Float64)`](/es/reference/data-types/tuple)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT proportionsZTest(10, 11, 100, 101, 0.95, 'unpooled');
```

```response title=Response theme={null}
┌─proportionsZTest(10, 11, 100, 101, 0.95, 'unpooled')───────────────────────────────┐
│ (-0.20656724435948853,0.8363478437079654,-0.09345975390115283,0.07563797172293502) │
└────────────────────────────────────────────────────────────────────────────────────┘
```

<div id="radians">
  ## radians
</div>

Introducido en: v22.2.0

Convierte grados en radianes.

**Sintaxis**

```sql theme={null}
radians(x)
```

**Argumentos**

* `x` — Valor de entrada en grados. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve un valor en radianes [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT radians(180)
```

```response title=Response theme={null}
3.141592653589793
```

<div id="sigmoid">
  ## sigmoid
</div>

Introducido en: v20.1.0

Calcula la función sigmoide: `1 / (1 + exp(-x))`. La función sigmoide asigna cualquier número real al intervalo (0, 1) y se utiliza habitualmente en el aprendizaje automático.

**Sintaxis**

```sql theme={null}
sigmoid(x)
```

**Argumentos**

* `x` — El valor de entrada. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float)

**Valor devuelto**

Devuelve la sigmoide del valor de entrada, en el intervalo (0, 1). [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Uso básico**

```sql title=Query theme={null}
SELECT sigmoid(0)
```

```response title=Response theme={null}
0.5
```

<div id="sign">
  ## sign
</div>

Introducido en: v21.2.0

Devuelve el signo de un número real.

**Sintaxis**

```sql theme={null}
sign(x)
```

**Argumentos**

* `x` — Valores entre -∞ y +∞. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Decimal*`](/es/reference/data-types/decimal) o [`Float*`](/es/reference/data-types/float)

**Valor devuelto**

Devuelve `-1` para `x < 0`, `0` para `x = 0` y `1` para `x > 0`. [`Int8`](/es/reference/data-types/int-uint)

**Ejemplos**

**Signo de cero**

```sql title=Query theme={null}
SELECT sign(0)
```

```response title=Response theme={null}
0
```

**Signo positivo**

```sql title=Query theme={null}
SELECT sign(1)
```

```response title=Response theme={null}
1
```

**Signo negativo**

```sql title=Query theme={null}
SELECT sign(-1)
```

```response title=Response theme={null}
-1
```

<div id="sin">
  ## sin
</div>

Introducido en: v1.1.0

Devuelve el seno del argumento.

**Sintaxis**

```sql theme={null}
sin(x)
```

**Argumentos**

* `x` — El número cuyo seno se devuelve. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el seno de x.

**Ejemplos**

**simple**

```sql title=Query theme={null}
SELECT sin(1.23)
```

```response title=Response theme={null}
0.9424888019316975
```

<div id="sinh">
  ## sinh
</div>

Introducido en: v20.12.0

Devuelve el seno hiperbólico.

**Sintaxis**

```sql theme={null}
sinh(x)
```

**Argumentos**

* `x` — El ángulo, en radianes. Valores en el intervalo: -∞ \< x \< +∞. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve valores en el intervalo: -∞ \< sinh(x) \< +∞ [`Float64`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT sinh(0)
```

```response title=Response theme={null}
0
```

<div id="sqrt">
  ## sqrt
</div>

Introducido en: v1.1.0

Devuelve la raíz cuadrada del argumento.

**Sintaxis**

```sql theme={null}
sqrt(x)
```

**Argumentos**

* `x` — El número del que se calcula la raíz cuadrada. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve la raíz cuadrada de x [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT sqrt(16);
```

```response title=Response theme={null}
4
```

<div id="tan">
  ## tan
</div>

Introducido en: v1.1.0

Devuelve la tangente del argumento.

**Sintaxis**

```sql theme={null}
tan(x)
```

**Argumentos**

* `x` — El ángulo en radianes. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve la tangente de `x`. [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT tan(0);
```

```response title=Response theme={null}
0
```

<div id="tanh">
  ## tanh
</div>

Introducido en: v20.1.0

Devuelve la tangente hiperbólica.

**Sintaxis**

```sql theme={null}
tanh(x)
```

**Argumentos**

* `x` — El ángulo en radianes. Valores en el intervalo: -∞ \< x \< +∞. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve valores en el intervalo: -1 \< tanh(x) \< 1 [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT tanh(0)
```

```response title=Response theme={null}
0
```

<div id="tgamma">
  ## tgamma
</div>

Introducido en: v1.1.0

Devuelve la función gamma.

**Sintaxis**

```sql theme={null}
tgamma(x)
```

**Argumentos**

* `x` — El número para el que se calcula la función gamma. [`(U)Int*`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal)

**Valor devuelto**

Devuelve el valor de la función gamma [`Float*`](/es/reference/data-types/float)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT tgamma(5);
```

```response title=Response theme={null}
24
```

<div id="widthBucket">
  ## widthBucket
</div>

Introducido en: v23.3.0

Devuelve el número del bucket en el que cae el parámetro `operand` en un histograma con `count` buckets de igual amplitud que abarcan el intervalo de `low` a `high`. Devuelve 0 si `operand` es menor que `low`, y devuelve `count`+1 si `operand` es mayor o igual que `high`.
También existe un alias que no distingue entre mayúsculas y minúsculas, llamado `WIDTH_BUCKET`, para ofrecer compatibilidad con otras bases de datos.

**Sintaxis**

```sql theme={null}
widthBucket(operand, low, high, count)
```

**Alias**: `width_bucket`

**Argumentos**

* `operand` — El valor para el que se debe determinar el bucket. [`(U)Int8/16/32/64`](/es/reference/data-types/int-uint)
* `low` — El límite inferior del rango del histograma. [`(U)Int8/16/32/64`](/es/reference/data-types/int-uint)
* `high` — El límite superior del rango del histograma. [`(U)Int8/16/32/64`](/es/reference/data-types/int-uint)
* `count` — El número de buckets de igual ancho. No puede ser cero. [`UInt8/16/32/64`](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve el número de bucket como un valor entero. Devuelve 0 si operand \< low y count+1 si operand >= high. [`UInt8/16/32/64`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
widthBucket(10.15, -8.6, 23, 18)
```

```response title=Response theme={null}
11
```