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 0.54030230586814.

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) através do cálculo (n! = 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 2 3  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

The rounding is done after dividing the number (x) by mult. If that result is negative (and is exactly an integer plus a half), the function rounds up instead of rounding away from zero. After it rounds to an integer, it multiplies again by the 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) returns a value of -30.

  • Round(–25, 10) returns a value of –20.

  • Round(–1.5, 1) returns a value of –1.

  • Round(15, 10) returns a value of 20.

  • Round(–15, 10) returns a value of –10.

  • Round(15, –10) returns a value of 10.

  • Round(–15, –10) returns a value of –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.