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.