6 Funções matemáticas

Todas as funções listadas aqui são compatíveis com:

• Trigger expressions
• Itens calculados

As funções matemáticas são compatíveis com os tipos de valor float e inteiro, salvo indicação em contrário.

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
• Os parâmetros de função opcionais (ou partes de parâmetros) são indicados por < >

abs(value)

O valor absoluto de um valor.
Tipos de valores compatíveis: Float, Integer, String, Text, Log.
Para strings, retorna: 0 - os valores são iguais; 1 - os valores são diferentes.

Parâmetro:

• value - o valor a ser verificado

A diferença numérica absoluta será calculada, como visto com esses valores de exemplo de entrada (valor "anterior" e "mais recente" = diferença absoluta): '1' e '5' = 4; '3' e '1' = 2; '0' e '-2.5' = 2.5

Exemplo:

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

acos(value)

O arccosine 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, a arccosina de um valor "0,5" será "2,0943951".

Exemplo:

acos(last(/host/key))

asin(value)

O arcsine 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 arcsine de um valor "0,5" será "-0,523598776".

Exemplo:

asin(last(/host/key))

atan(value)

O arctangente 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, a arctangente de um valor "1" será "0,785398163".

Exemplo:

atan(last(/host/key))

atan2(value,abscissa)

A arctangente das coordenadas da ordenada (valor) e da abscissa especificada como um ângulo, expressa em radianos.

Parâmetro:

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

Por exemplo, a arctangente das coordenadas da ordenada e da abscissa de um valor "1" será "2,21429744".

Exemplo:

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

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

O valor médio dos valores dos itens referenciados.

Parâmetro:

• valueX - o valor retornado por uma das funções de histórico.

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" e a de "63" será "3.97905721".

Exemplo:

cbrt(last(/host/key))

ceil(value)

Arredonda o valor para o número inteiro maior ou igual mais próximo.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, "2,4" será arredondado para "3". Consulte também floor().

Exemplo:

ceil(last(/host/key))

cos(value)

O cosseno de um valor, em que 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:

• valor - 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)

A cotangente de um valor, em que o valor é um ângulo expresso em radianos.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, a 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 em 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 em uma potência de um valor.

Parâmetro:

• valor - o valor a ser verificado

Por exemplo, o número de Euler em uma potência de um valor "2" será "7.38905609893065".

Exemplo:

exp(last(/host/key))

expm1(value)

O número de Euler em uma potência de um valor menos 1.

Parâmetro:

• valor - o valor a ser verificado

Por exemplo, o número de Euler em uma potência de um valor "2" menos 1 será "6.38905609893065".

Exemplo:

expm1(last(/host/key))

floor(value)

Arredonda o valor para baixo até o número inteiro menor ou igual mais próximo.

Parâmetro:

• value - o valor a ser verificado

Por exemplo, "2,6" será arredondado para "2". Consulte também ceil().

Exemplo:

floor(last(/host/key))

log(value)

O logaritmo natural.

Parâmetro:

• valor - 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 valor mais alto dos valores de itens referenciados.

Parâmetro:

• valueX - o valor retornado por uma das funções de histórico.

Exemplo:

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

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

O valor mais baixo dos valores de itens referenciados.

Parâmetro:

• valueX - o valor retornado por uma das funções de histórico.

Exemplo:

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

mod(value,denominator)

O resto da divisão.

Parâmetro:

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

Por exemplo, o resto da divisão de um valor "5" com denominador de 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âmetro:

• valor - o valor a ser verificado;
• power value - a enésima potência a ser usada.

Por exemplo, a terceira 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 em radianos será "0,0174532925".

Exemplo:

radians(last(/host/key))

rand

Retorna um valor inteiro aleatório. Um número gerado de forma pseudo-aleatória 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âmetro:

• 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 um valor for negativo, '0' se um valor for zero, '1' se um valor for positivo.

Parâmetros:

• value - o valor a ser verificado.

Exemplo:

signum(last(/host/key))

sin(value)

O seno de um valor, em que 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, em que 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.
Essa função falhará com um valor negativo.

Parâmetros:

• valor - 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 itens referenciados.

Parâmetro:

• valueX - o valor retornado por uma das funções de histórico.

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 em casas decimais.

Parâmetros:

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

Por exemplo, um valor "2,5482" truncado em 2 casas decimais será "2,54".

Exemplo:

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

Consulte todas as funções suportadas.