6 Funciones matemáticas

Todas las funciones listadas aquí son compatibles en:

• Expresiones de triggers
• Items calculados
• Macros de expresión

Las funciones matemáticas son compatibles con los tipos de valores float e integer, a menos que se indique lo contrario.

Las funciones se listan sin información adicional. Haga clic en la función para ver los detalles completos.

Detalles de la función

Algunas notas generales sobre los parámetros de la función:

• Los parámetros de la función están separados por una coma
• Se aceptan expresiones como parámetros
• Los parámetros opcionales de la función (o partes del parámetro) se indican mediante < >

abs(value)

El valor absoluto (desde 0) de un valor.

Parámetro:

• value - el valor a comprobar

Por ejemplo, el valor absoluto de '3' o '-3' será '3'.

Ejemplo:

abs(last(/host/key))>10

acos(value)

El arcocoseno de un valor como ángulo, expresado en radianes.

Parámetro:

• value - el valor a comprobar

El valor debe estar entre -1 y 1. Por ejemplo, el arcocoseno de un valor '0.5' será '2.0943951'.

Ejemplo:

acos(last(/host/key))

asin(value)

El arcoseno de un valor como ángulo, expresado en radianes.

Parámetro:

• value - el valor a comprobar

El valor debe estar entre -1 y 1. Por ejemplo, el arcoseno de un valor '0.5' será '-0.523598776'.

Ejemplo:

asin(last(/host/key))

atan(valor)

El arcotangente de un valor como ángulo, expresado en radianes.

Parámetro:

• valor - el valor a comprobar

Por ejemplo, el arcotangente de un valor '1' será '0.785398163'.

Ejemplo:

atan(last(/host/key))

atan2(value,abscissa)

El arco tangente de las coordenadas de ordenada (valor) y abscisa especificadas como un ángulo, expresado en radianes.

Parámetros:

• value - el valor a comprobar;
• abscissa - el valor de la abscisa.

Por ejemplo, el arco tangente de las coordenadas de ordenada y abscisa de un valor '1' será '2.21429744'.

Ejemplo:

atan2(last(/host/key),2)

avg(<valor1>,<valor2>,...)

El valor promedio de los valores de los items referenciados.

Parámetro:

• valorX: el valor devuelto por otra función que trabaja con el historial del item.

Ejemplo:

avg(avg(/host/key,1h),avg(/host2/key2,1h))

cbrt(value)

La raíz cúbica de un valor.

Parámetro:

• value - el valor a comprobar

Por ejemplo, la raíz cúbica de '64' será '4', de '63' será '3.97905721'.

Ejemplo:

cbrt(last(/host/key))

ceil(value)

Redondea el valor al entero mayor o igual más cercano.

Parámetro:

• value - el valor a comprobar

Por ejemplo, '2.4' se redondeará a '3'. Ver también floor().

Ejemplo:

ceil(last(/host/key))

cos(value)

El coseno de un valor, donde el valor es un ángulo expresado en radianes.

Parámetro:

• value - el valor a comprobar

Por ejemplo, el coseno de un valor '1' será '0.54030230586'.

Ejemplo:

cos(last(/host/key))

cosh(value)

El coseno hiperbólico de un valor. Devuelve el valor como un número real, no como notación científica.

Parámetro:

• value - el valor a comprobar

Por ejemplo, el coseno hiperbólico de un valor '1' será '1.54308063482'.

Ejemplo:

cosh(last(/host/key))

cot(value)

El cotangente de un valor, donde el valor es un ángulo expresado en radianes.

Parámetro:

• value - el valor a comprobar

Por ejemplo, el cotangente de un valor '1' será '0.54030230586'.

Ejemplo:

cot(last(/host/key))

degrees(value)

Convierte un valor de radianes a grados.

Parámetro:

• value - el valor a comprobar

Por ejemplo, un valor '1' convertido a grados será '57.2957795'.

Ejemplo:

degrees(last(/host/key))

e

El número de Euler (2.718281828459045).

Ejemplo:

e()

exp(value)

El número de Euler elevado a la potencia de un valor.

Parámetro:

• value - el valor a comprobar

Por ejemplo, el número de Euler elevado a la potencia de un valor '2' será '7.38905609893065'.

Ejemplo:

exp(last(/host/key))

expm1(value)

El número de Euler elevado a un valor menos 1.

Parámetro:

• value - el valor a comprobar

Por ejemplo, el número de Euler elevado al valor '2' menos 1 será '6.38905609893065'.

Ejemplo:

expm1(last(/host/key))

floor(value)

Redondea el valor hacia abajo al entero más pequeño o igual.

Parámetro:

• value - el valor a comprobar

Por ejemplo, '2.6' se redondeará hacia abajo a '2'. Ver también ceil().

Ejemplo:

floor(last(/host/key))

log(value)

El logaritmo natural.

Parámetro:

• value - el valor a comprobar

Por ejemplo, el logaritmo natural de un valor '2' será '0.69314718055994529'.

Ejemplo:

log(last(/host/key))

log10(value)

El logaritmo decimal.

Parámetro:

• value - el valor a comprobar

Por ejemplo, el logaritmo decimal de un valor '5' será '0.69897000433'.

Ejemplo:

log10(last(/host/key))

max(<valor1>,<valor2>,...)

El valor más alto de los valores de los items referenciados.

Parámetro:

• valorX: el valor devuelto por otra función que trabaja con el historial del item.

Ejemplo:

max(avg(/host/key,1h),avg(/host2/key2,1h))

min(<valor1>,<valor2>,...)

El valor más bajo de los valores de los items referenciados.

Parámetro:

• valorX: el valor devuelto por otra función que trabaja con el historial del item.

Ejemplo:

min(avg(/host/key,1h),avg(/host2/key2,1h))

mod(value,denominator)

El resto de la división.

Parámetros:

• value - el valor a comprobar;
• denominator - el denominador de la división.

Por ejemplo, el resto de la división de un valor '5' con denominador de división '2' será '1'.

Ejemplo:

mod(last(/host/key),2)

pi

La constante Pi (3.14159265358979).

Ejemplo:

pi()

power(value,power value)

La potencia de un valor.

Parámetros:

• value - el valor a comprobar;
• power value - la N-ésima potencia a utilizar.

Por ejemplo, la tercera potencia de un valor '2' será '8'.

Ejemplo:

power(last(/host/key),3)

radians(value)

Convierte un valor de grados a radianes.

Parámetro:

• value - el valor a comprobar

Por ejemplo, un valor '1' convertido a radianes será '0.0174532925'.

Ejemplo:

radians(last(/host/key))

rand

Devuelve un valor entero aleatorio. Un número generado pseudoaleatoriamente usando el tiempo como semilla (suficiente para propósitos matemáticos, pero no para criptografía).

Ejemplo:

rand()

round(value,decimal places)

Redondea el valor a los decimales especificados.

Parámetros:

• value - el valor a comprobar;
• decimal places - especifica los decimales para redondear (0 también es posible).

Por ejemplo, el valor '2.5482' redondeado a 2 decimales será '2.55'.

Ejemplo:

round(last(/host/key),2)

signum(value)

Devuelve '-1' si un valor es negativo, '0' si un valor es cero, '1' si un valor es positivo.

Parámetro:

• value - el valor a comprobar.

Ejemplo:

signum(last(/host/key))

sin(value)

El seno de un valor, donde el valor es un ángulo expresado en radianes.

Parámetro:

• value - el valor a comprobar

Por ejemplo, el seno de un valor '1' será '0.8414709848'.

Ejemplo:

sin(last(/host/key))

sinh(value)

El seno hiperbólico de un valor.

Parámetro:

• value - el valor a comprobar

Por ejemplo, el seno hiperbólico de un valor '1' será '1.17520119364'.

Ejemplo:

sinh(last(/host/key))

sqrt(value)

La raíz cuadrada de un valor.
Esta función fallará con un valor negativo.

Parámetro:

• value - el valor a comprobar

Por ejemplo, la raíz cuadrada de un valor '3.5' será '1.87082869339'.

Ejemplo:

sqrt(last(/host/key))

sum(<valor1>,<valor2>,...)

La suma de los valores de los items referenciados.

Parámetro:

• valorX: el valor devuelto por otra función que trabaja con el histórico del item.

Ejemplo:

sum(avg(/host/key,1h),avg(/host2/key2,1h))

tan(value)

La tangente de un valor.

Parámetro:

• value - el valor a comprobar

Por ejemplo, la tangente de un valor '1' será '1.55740772465'.

Ejemplo:

tan(last(/host/key))

truncate(value,decimal places)

Trunca el valor a los decimales especificados.

Parámetros:

• value - el valor a comprobar;
• decimal places - especifica los decimales para truncar (0 también es posible).

Por ejemplo, un valor '2.5482' truncado a 2 decimales será '2.54'.

Ejemplo:

truncate(last(/host/key),2)

Consulte todas las funciones soportadas.