Skip to main content

Funções matemáticas

Uma função matemática realiza cálculos matemáticos. Use funções matemáticas somente com tipos de dados numéricos.

ABS

ABS(x): retorna o valor absoluto de um número (x). É a distância entre 0 e um número. O valor é sempre positivo.

Exemplo

  • ABS(32) retorna 32.

  • ABS(–32) retorna 32.

ACOS

ACOS(x): retorna o arco cosseno, ou cosseno inverso, de um número (x). O arco cosseno é o ângulo cujo cosseno é (x).

  • O ângulo é apresentado em radianos na faixa de 0 (zero) a pi.

  • O número (x) deve estar entre -1 e 1.

Exemplo

ACOS(0.5) retorna 1.047198.

ASIN

ASIN(x): retorna o arco seno, ou seno inverso, de um número (x). O arco seno é o ângulo cujo seno é (x).

  • O ângulo é apresentado em radianos na faixa de -pi/2 a pi/2.

  • O número (x) deve estar entre -1 e 1.

Exemplo

ASIN(0.5) retorna 0.523599.

ATAN

ATAN(x): retorna o arco tangente, ou tangente inversa, de um número (x). O arco tangente é o ângulo cuja tangente é (x). O ângulo é apresentado em radianos na faixa de -pi/2 a pi/2.

Exemplo

ATAN(0.8) retorna 0.674741.

ATAN2

ATAN2(y, x): retorna o arco tangente, ou a tangente inversa, de y e x (arco - tangente de (y/x)).

Exemplo

ATAN2(4, –3) retorna 2.2143.

Average

Average(n1, ...): retorna a média de uma lista de números. Os valores nulos são tratados como 0 e levados em consideração no cálculo do valor médio.

Exemplo

Average(20,30,55) retorna 35 porque [(20+30+55)/3]= 35.

AverageNonNull

AverageNonNull(n1, ...): retorna a média de uma lista de números. Valores nulos são excluídos do cálculo. O cálculo funciona apenas com tipos de dados numéricos.

Nota

Observe que a função AverageNonNull funciona de forma diferente da Average(n1, …) acima.

  • A função AverageNonNull exclui valores nulos do cálculo da média. Esse é o mesmo comportamento da ação "Média" disponível por meio da ferramenta Sumarizar.

  • A função Average trata valores nulos como 0 (zeros).

Por isso, as duas funções podem retornar resultados diferentes dependendo da entrada.

Exemplo

  • AVERAGENONNULL(Null, 1, 1) retorna 1 (vs. 0.666666666666667 com a função Average, que inclui o valor nulo como 0).

  • AVERAGENONNULL(Null, 1, 2, 3) retorna 2 (vs. 1.5 com a função Average).

  • AVERAGENONNULL(Null, 1, 2, 2) retorna 1.666666666666667 (vs. 1.25 com a função Average).

  • AVERAGENONNULL(Null, 1.2, 2.345, 3.456789) retorna 2.33392966666667 (vs. 1.75044725 com a função Average).

  • AVERAGENONNULL(Null, 1.2, 2.345, 3.456789, Null) retorna 2.33392966666667 (vs. 1.4003578 com a função Average).

  • AVERAGENONNULL(Null, Null, Null) retorna [Null] (nulo). Quando todos os valores são nulos, o resultado também é nulo.

CEIL

CEIL(x, [mult]): retorna um valor numérico (x) aumentado para o múltiplo mais baixo de (mult) que seja maior que ou igual a x. O parâmetro (mult) deve ser um número maior que 0. Se (mult) não estiver especificado, a função retorna o menor número inteiro maior ou igual a (x).

Nota

CEIL(x) altera o tipo de double para Int64 se o valor estiver dentro do intervalo INT64, caso contrário, retorna um Double.

Exemplo

  • CEIL(9.567) retorna 10 (se não fornecermos um parâmetro, a função retornará como padrão o menor número inteiro maior que ou igual a x).

  • CEIL(123.456, 10) retorna 130 (arredonda até o múltiplo mais próximo de 10).

  • CEIL(–110, 100) retorna -100 (arredonda até o múltiplo mais próximo de 100).

  • CEIL(123, Null) retorna [Null] (nulo, porque se houver um nulo em qualquer parâmetro, o resultado será nulo).

  • CEIL(9.123, 0.01) retorna 9.13 (arredonda até o múltiplo mais próximo de 0.01).

  • CEIL(7, 5) retorna 10 (arredonda até o múltiplo mais próximo de 5).

COS

COS(x): retorna o cosseno de um determinado ângulo (x). O valor x precisa estar em radianos.

Exemplo

COS(1) retorna 0.54030230586814.

COSH

COSH(x): retorna o cosseno hiperbólico de um número (x).

Exemplo

COSH(1) retorna 1.54308063481524.

DISTANCE

DISTANCE(from_Lat,from_Lon, to_Lat, to_Lon): retorna a distância de (Lat1,Lon1) até (Lat2,Lon2).

Exemplo

DISTANCE(42, –90, 43, –80) retorna um valor de 513.473706 milhas.

EXP

EXP(x): retorna a constante e elevada à potência de um expoente (x) (e^x).

FACTORIAL

FACTORIAL(x): retorna o fatorial de um valor numérico (x) por meio do cálculo (n! cálculo de = n x (n-1) x … x 1). Por exemplo, o fatorial de 4 é calculado como: 4! = 4 x 3 x 2 x 1 = 24.

  • Esta função aceita apenas números inteiros positivos.

  • Esta função não oferece suporte para números decimais.

  • Devido às limitações de tamanho para dados numéricos, o valor máximo permitido para (x) na função Factorial é 170.

Nota

Embora a representação matemática do fatorial seja a notação x!, a função do Alteryx somente reconhece o fatorial com o uso de Factorial(x).

Exemplo

  • FACTORIAL(0) retorna 1.

  • FACTORIAL(1) retorna 1.

  • FACTORIAL(Null) retorna [Null] (nulo).

  • FACTORIAL(5) retorna 120 (5 * 4 * 3 * 2 * 1).

  • FACTORIAL(8) retorna 40320 (8 * 7 * 6 * 5 * 4 * 3 * 2 * 1).

FLOOR

FLOOR(x, [mult]): retorna um valor numérico (x) reduzido para o múltiplo mais alto de (mult) que seja menor que ou igual a x. O parâmetro (mult) deve ser um número maior que 0. Se (mult) não estiver especificado, a função retorna o maior número inteiro menor ou igual a (x), conforme mostrado no primeiro exemplo abaixo.

Nota

FLOOR(x) altera o tipo de double para Int64 se o valor estiver dentro do intervalo INT64, caso contrário, retorna um Double.

Exemplo

  • FLOOR(4.567) retorna 4 (se um parâmetro não for fornecido, a função retornará como padrão o maior número inteiro menor que ou igual a x).

  • FLOOR(4.567, 0.01) retorna 4.56 (arredonda para baixo até o centésimo mais próximo).

  • FLOOR(–15.75, 0.1) retorna -15.8 (arredonda para baixo até o décimo mais próximo).

  • FLOOR(Null, 10) retorna [Null] (nulo, porque se houver um nulo em qualquer parâmetro, o resultado será nulo).

  • FLOOR(13, 5) retorna 10 (arredonda para baixo para 10, que é o múltiplo mais próximo de 5 menor que ou igual a 13).

LOG

LOG(x): retorna o logaritmo natural de um número (x). O valor x deve ser um número positivo.

Exemplo

  • LOG(1) retorna 0.

  • LOG(14) retorna 2.639057.

LOG10

LOG10(x): retorna o logaritmo na base 10 de um número (x). O valor x deve ser um número positivo.

Exemplo

  • LOG10(1) retorna 0.

  • LOG10(14) retorna 1.146128.

Median

Median(...): calcula a mediana de um ou mais valores (possivelmente não ordenados).

Exemplo

Mediana (5, 4, 3, 7, 6) retorna 5.

Mod

Mod(n,d): módulo de um número (n) dividido por um número (d) (operação com números inteiros).

A operação de módulo encontra o resto da divisão de um número inteiro (n) por um divisor inteiro (d).

  • Se (n) for positivo, o resultado será positivo.

  • Se (n) for negativo, o resultado será negativo.

Se você usar valores decimais, o decimal será truncado. Isso pode resultar em um erro de divisão por 0 se o divisor for um decimal menor que 1.

Exemplo

  • MOD(6,4) retorna 2.

  • MOD(6,–4) retorna 2.

  • MOD(–6,4) retorna -2.

  • MOD(–6,–4) retorna -2.

  • MOD(6,.4) retorna [Null] (nulo).

PI

PI(): retorna o valor da constante PI com 15 dígitos de acurácia.

Exemplo

PI() retorna 3.141593.

POW

POW(x, e): retorna (x) elevado à potência (e).

Exemplo

POW(2, 3) é equivalente a 23 e retorna 8.

RAND

RAND(): retorna um número aleatório maior ou igual a 0 e menor que 1.

Exemplo

RAND() retorna um número aleatório como 0.256.

RandInt

RandInt(n): retorna um número inteiro aleatório entre 0 e o parâmetro especificado (n).

Exemplo

  • RandInt(10) retorna 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 or 10.

  • RandInt(5000) retorna um número inteiro aleatório entre 0 e 5000, como 741.

Round

Round(x, mult): retorna um número (x) arredondado para o múltiplo mais próximo de (mult).

Nota

O arredondamento é feito após dividir o número (x) por "mult". Se esse resultado for negativo (e for exatamente um número inteiro mais meio), a função arredonda para cima em vez de arredondar para longe de zero. Depois de arredondar para um número inteiro, ele multiplica novamente pelo "mult".

Exemplo

  • Round(55.34, 2) retorna um valor de 56.

  • Round(39.88, 10) retorna um valor de 40.

  • Round(41.1, 10) retorna um valor de 40.

  • Round(1.25, 0.1) retorna um valor de 1.3.

  • Round(1.227, 0.01) retorna um valor de 1.23.

  • Round(-25, -10) retorna um valor de -30.

  • Round(-25, 10) retorna um valor de -20.

  • Round(-1,5, 1) retorna um valor de -1.

  • Round(15, 10) retorna um valor de 20.

  • Round(-15, 10) retorna um valor de -10.

  • Round(15, -10) retorna um valor de 10.

  • Round(-15, -10) retorna um valor de -20.

SIN

SIN(x): retorna o seno de um determinado ângulo (x). O valor x precisa estar em radianos.

Exemplo

SIN(90) retorna 0.893996663600558.

SINH

SINH(x): retorna o seno hiperbólico de um número (x).

SmartRound

SmartRound(x): retorna um número (x) arredondado para o múltiplo mais próximo de um valor determinado dinamicamente com base no tamanho de (x).

SQRT

SQRT(x): retorna a raiz quadrada de um número (x).

Exemplo

SQRT(100) retorna um valor de 10.

TAN

TAN(x): retorna a tangente de um determinado ângulo (x). O valor x precisa estar em radianos.

Exemplo

TAN(1) retorna 1.5574077246549.

TANH

TANH(x): retorna a tangente hiperbólica de um número (x).

Exemplo

TANH(90) retorna 1.