6 Funções matemáticas

Todas as funções listadas aqui são suportadas em:

• Expressões de trigger
• Itens calculados
• Macros de expressão

Funções matemáticas são suportadas com tipos de valores float e integer, a menos que indicado de outra forma.

As funções são listadas sem informações adicionais. Clique na função para ver os detalhes completos.

Detalhes da função

Algumas observações gerais sobre os parâmetros da função:

• Os parâmetros da função são separados por vírgula
• Expressões são aceitas como parâmetros
• Parâmetros opcionais da função (ou partes do parâmetro) são indicados por < >

abs(value)

O valor absoluto (a partir de 0) de um valor.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, o valor absoluto de '3' ou '-3' será '3'.

Exemplo:

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

acos(value)

O arco-cosseno de um valor como um ângulo, expresso em radianos.

Parâmetro:

• value - o valor a ser verificado

O valor deve estar entre -1 e 1. Por exemplo, o arco-cosseno de um valor '0.5' será '2.0943951'.

Exemplo:

acos(last(/host/key))

asin(value)

O arco seno de um valor como um ângulo, expresso em radianos.

Parâmetro:

• value - o valor a ser verificado

O valor deve estar entre -1 e 1. Por exemplo, o arco seno de um valor '0.5' será '-0.523598776'.

Exemplo:

asin(last(/host/key))

atan(value)

O arco-tangente de um valor como um ângulo, expresso em radianos.

Parâmetro:

• value - o valor a ser verificado

O valor deve estar entre -1 e 1. Por exemplo, o arco-tangente de um valor '1' será '0.785398163'.

Exemplo:

atan(last(/host/key))

atan2(value,abscissa)

O arco-tangente das coordenadas de ordenada (valor) e abscissa especificadas como um ângulo, expresso em radianos.

Parâmetros:

• value - o valor a ser verificado;
• abscissa - o valor da abscissa.

Por exemplo, o arco-tangente das coordenadas de ordenada e abscissa de um valor '1' será '2.21429744'.

Exemplo:

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

avg(<value1>,<value2>,...)

O valor médio dos valores dos items referenciados.

Parâmetro:

• valueX - o valor retornado por outra função que está trabalhando com o histórico do item.

Exemplo:

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

cbrt(value)

A raiz cúbica de um valor.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, a raiz cúbica de '64' será '4', de '63' será '3.97905721'.

Exemplo:

cbrt(last(/host/key))

ceil(value)

Arredonda o valor para o inteiro mais próximo, maior ou igual.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, '2.4' será arredondado para '3'. Veja também floor().

Exemplo:

ceil(last(/host/key))

cos(value)

O cosseno de um valor, onde o valor é um ângulo expresso em radianos.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, o cosseno de um valor '1' será '0.54030230586'.

Exemplo:

cos(last(/host/key))

cosh(value)

O cosseno hiperbólico de um valor. Retorna o valor como um número real, não como notação científica.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, o cosseno hiperbólico de um valor '1' será '1.54308063482'.

Exemplo:

cosh(last(/host/key))

cot(value)

O cotangente de um valor, onde o valor é um ângulo expresso em radianos.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, o cotangente de um valor '1' será '0.54030230586'.

Exemplo:

cot(last(/host/key))

degrees(value)

Converte um valor de radianos para graus.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, um valor '1' convertido para graus será '57.2957795'.

Exemplo:

degrees(last(/host/key))

e

O número de Euler (2.718281828459045).

Exemplo:

e()

exp(value)

O número de Euler elevado a uma potência de um valor.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, o número de Euler elevado à potência de um valor '2' será '7.38905609893065'.

Exemplo:

exp(last(/host/key))

expm1(value)

O número de Euler elevado a um valor menos 1.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, o número de Euler elevado ao valor '2' menos 1 será '6.38905609893065'.

Exemplo:

expm1(last(/host/key))

floor(value)

Arredonda o valor para baixo para o inteiro menor ou igual mais próximo.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, '2.6' será arredondado para baixo para '2'. Veja também ceil().

Exemplo:

floor(last(/host/key))

log(value)

O logaritmo natural.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, o logaritmo natural de um valor '2' será '0.69314718055994529'.

Exemplo:

log(last(/host/key))

log10(value)

O logaritmo decimal.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, o logaritmo decimal de um valor '5' será '0.69897000433'.

Exemplo:

log10(last(/host/key))

max(<value1>,<value2>,...)

O maior valor dos valores de item referenciados.

Parâmetro:

• valueX - o valor retornado por outra função que está trabalhando com o histórico do item.

Exemplo:

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

min(<value1>,<value2>,...)

O menor valor dos valores de item referenciados.

Parâmetro:

• valueX - o valor retornado por outra função que está trabalhando com o histórico do item.

Exemplo:

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

mod(value,denominator)

O resto da divisão.

Parâmetros:

• value - o valor a ser verificado;
• denominator - o denominador da divisão.

Por exemplo, o resto da divisão de um valor '5' com o denominador da divisão '2' será '1'.

Exemplo:

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

pi

A constante Pi (3.14159265358979).

Exemplo:

pi()

power(value,power value)

A potência de um valor.

Parâmetros:

• value - o valor a ser verificado;
• power value - a potência N a ser usada.

Por exemplo, a 3ª potência de um valor '2' será '8'.

Exemplo:

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

radians(value)

Converte um valor de graus para radianos.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, um valor '1' convertido para radianos será '0.0174532925'.

Exemplo:

radians(last(/host/key))

rand

Retorna um valor inteiro aleatório. Um número pseudo-aleatório gerado usando o tempo como semente (suficiente para fins matemáticos, mas não para criptografia).

Exemplo:

rand()

round(value,decimal places)

Arredonda o valor para casas decimais.

Parâmetros:

• value - o valor a ser verificado;
• decimal places - especifica as casas decimais para arredondamento (0 também é possível).

Por exemplo, um valor '2.5482' arredondado para 2 casas decimais será '2.55'.

Exemplo:

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

signum(value)

Retorna '-1' se o valor for negativo, '0' se o valor for zero, '1' se o valor for positivo.

Parâmetro:

• value - o valor a ser verificado.

Exemplo:

signum(last(/host/key))

sin(value)

O seno de um valor, onde o valor é um ângulo expresso em radianos.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, o seno de um valor '1' será '0.8414709848'.

Exemplo:

sin(last(/host/key))

sinh(value)

O seno hiperbólico de um valor, onde o valor é um ângulo expresso em radianos.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, o seno hiperbólico de um valor '1' será '1.17520119364'.

Exemplo:

sinh(last(/host/key))

sqrt(value)

A raiz quadrada de um valor.
Esta função irá falhar com um valor negativo.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, a raiz quadrada de um valor '3.5' será '1.87082869339'.

Exemplo:

sqrt(last(/host/key))

sum(<value1>,<value2>,...)

A soma dos valores dos items referenciados.

Parâmetro:

• valueX - o valor retornado por outra função que está trabalhando com o histórico do item.

Exemplo:

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

tan(value)

A tangente de um valor.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, a tangente de um valor '1' será '1.55740772465'.

Exemplo:

tan(last(/host/key))

truncate(value,decimal places)

Trunca o valor para casas decimais.

Parâmetros:

• value - o valor a ser verificado;
• decimal places - especifica as casas decimais para truncar (0 também é possível).

Por exemplo, um valor '2.5482' truncado para 2 casas decimais será '2.54'.

Exemplo:

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

Veja todas as funções suportadas.