Fonctions mathématiques
Une fonction mathématique exécute des calculs mathématiques. Utilisez les fonctions mathématiques avec des types de données numériques uniquement.
ABS
ABS(x)
: renvoie la valeur absolue d'un nombre (x). Cette valeur représente la distance entre 0 et un nombre. La valeur est toujours positive.
Exemple
ABS(32)
renvoie 32ABS(-32)
renvoie 32
ACOS
ACOS(x)
: renvoie l.arc cosinus, ou le cosinus inverse, d'un nombre. L'arc cosinus correspond à l'angle dont le cosinus est (x).
L'angle renvoyé est indiqué en radians dans la plage allant de 0 (zéro) à pi.
Le nombre (x) doit être compris entre -1 et 1.
Exemple
ACOS(0.5)
renvoie 1.047198.
ASIN
ASIN(x)
: renvoie l'arc sinus, ou le sinus inverse, d'un nombre (x). L'arc sinus correspond à l'angle dont le sinus est (x).
L'angle renvoyé est indiqué en radians dans la plage allant de -pi/2 à pi/2.
Le nombre (x) doit être compris entre -1 et 1.
Exemple
ASIN(0.5)
renvoie 0.523599.
ATAN
ATAN(x)
: renvoie l'arc tangente, ou la tangente inverse, d'un nombre (x). L'arc tangente correspond à l'angle dont la tangente est (x). L'angle renvoyé est indiqué en radians dans la plage allant de -pi/2 à pi/2.
Exemple
ATAN(0.8)
renvoie 0.674741.
ATAN2
ATAN2(y, x)
: renvoie l'arc tangente, ou la tangente inverse, de y et x (Arc - Tangente de (y/x)).
Exemple
ATAN2(4, -3)
renvoie 2.2143.
Average
Average(n1, …)
: renvoie la moyenne d'une liste de nombres. Les valeurs NULL sont traitées comme 0 et prises en compte dans le calcul de la valeur moyenne.
Exemple
Average(20,30,55)
renvoie 35, car [(20+30+55)/3]= 35.
AverageNonNull
AverageNonNull(n1, ...)
: renvoie la moyenne d'une liste de nombres. Les valeurs nulles sont exclues du calcul. Le calcul fonctionne uniquement avec les types de données numériques.
Note
Veuillez noter que la fonction AverageNonNull fonctionne différemment de la fonction Average(n1, …).
AverageNonNull
exclut les valeurs nulles du calcul de la moyenne. Il s'agit du même comportement que l'action Moyenne disponible via l' outil Agréger .Average
traite les valeurs nulles comme des 0.
Pour cette raison, les 2 fonctions peuvent renvoyer des résultats différents selon l'entrée.
Exemple
AVERAGENONNULL(Null, 1, 1)
renvoie 1 (vs. 0.666666666666667 avec la fonction Average, qui inclut Null comme 0).AVERAGENONNULL(Null, 1, 2, 3)
renvoie 2 (vs. 1.5 avec la fonction Average).AVERAGENONNULL(Null, 1, 2, 2)
renvoie 1.666666666666667 (vs. 1.25 avec la fonction Average).AVERAGENONNULL(Null, 1.2, 2.345, 3.456789)
renvoie 2.33392966666667 (vs. 1.75044725 avec la fonction Average).AVERAGENONNULL(Null, 1.2, 2.345, 3.456789, Null)
renvoie 2.33392966666667 (vs. 1.4003578 avec la fonction Average).AVERAGENONNULL(Null, Null, Null)
Renvoie Null. Lorsque toutes les valeurs sont nulles, les résultats sont nuls.
CEIL
CEIL(x, [mult])
: renvoie une valeur numérique (x) élevée au plus petit multiple de (mult) supérieur ou égal à x. Le paramètre (mult) doit être un nombre supérieur à 0. Si (mult) n'est pas spécifié, la fonction renvoie le plus petit entier qui est supérieur ou égal à (x).
Note
CEIL(x)
change un double en Int64 si la valeur est comprise dans la plage INT64, sinon il renvoie un double.
Exemple
CEIL(9.567)
renvoie 10 (si on ne fournit pas de paramètre, la fonction renvoie par défaut le plus petit entier supérieur ou égal à x).CEIL(123.456, 10)
renvoie 130 (arrondit au multiple le plus proche de 10).CEIL(-110, 100)
renvoie -100 (arrondit au multiple le plus proche de 100).CEIL(123, Null)
renvoie une valeur nulle (si un paramètre comprend une valeur nulle, le résultat est une valeur nulle).CEIL(9.123, 0.01)
renvoie 9.13 (arrondit au multiple le plus proche de 0.01).CEIL(7, 5)
renvoie 10 (arrondit au multiple le plus proche de 5).
COS
COS(x)
: renvoie le cosinus d'un angle donné (x). x doit être en radians.
Exemple
COS(1)
renvoie 0.54030230586814.
COSH
COSH(x)
: renvoie le cosinus hyperbolique d'un nombre (x).
Exemple
COSH(1)
renvoie 0.54030230586814.
DISTANCE
DISTANCE(from_Lat,from_Lon, to_Lat, to_Lon)
: renvoie la distance entre (lat1,lon1) et (lat2,lon2).
Exemple
DISTANCE(42, -90, 43, -80)
renvoie une valeur de 513.473706 miles
EXP
EXP(x)
: renvoie la constante e élevée à la puissance (x) d'un exposant (e^x).
FACTORIAL
FACTORIAL(x)
: renvoie la factorielle d'une valeur numérique (x) via le calcul (n! = n x (n-1) x … x 1). Par exemple, la factorielle de 4 est calculée comme suit : 4! = 4 x 3 x 2 x 1 = 24.
Cette fonction accepte uniquement les entiers positifs.
Cette fonction ne prend pas en charge les nombres décimaux.
En raison des limites de taille du type de données numérique, la valeur maximale autorisée pour (x) dans la fonction factorielle est 170.
Note
Bien que la représentation mathématique de la factorielle soit désignée par x!, la fonction Alteryx reconnaît les factorielles uniquement via Factorial(x).
Exemple
FACTORIAL(0)
renvoie 1.FACTORIAL(1)
renvoie 1.FACTORIAL(Null)
Renvoie Null.FACTORIAL(5)
renvoie 120 (5 * 4 * 3 * 2 * 1).FACTORIAL(8)
renvoie 40320 (8 * 7 * 6 * 5 * 4 * 3 * 2 * 1).
FLOOR
FLOOR(x, [mult])
: renvoie une valeur numérique (x) abaissée au plus grand multiple de (mult) inférieur ou égal à x. Le paramètre (mult) doit être un nombre supérieur à 0. Si (mult) n'est pas spécifié, la fonction renvoie le plus grand entier qui est inférieur ou égal à (x), comme indiqué dans l'exemple ci-dessous.
Note
FLOOR(x)
change un double en Int64 si la valeur est comprise dans la plage INT64, sinon il renvoie un double.
Exemple
FLOOR(4.567)
renvoie 4 (si vous ne fournissez pas de paramètre, la fonction renvoie par défaut le plus grand entier inférieur ou égal à x).FLOOR(4.567, 0.01)
renvoie 4.56 (arrondit au centième près).FLOOR(-15.75, 0.1)
renvoie -15.8 (arrondit au dixième près).FLOOR(Null, 10)
renvoie une valeur nulle (si un paramètre comprend une valeur nulle, le résultat est une valeur nulle).FLOOR(13, 5)
renvoie 10 (arrondit à 10, qui est le multiple le plus proche de 5 qui est inférieur ou égal à 13).
LOG
LOG(x)
: renvoie le logarithme naturel d'un nombre (x). x doit être un nombre positif.
Exemple
LOG(1)
renvoie 0LOG(14)
renvoie 2.639057
LOG10
LOG10(x)
: renvoie le logarithme décimal d'un nombre (x). x doit être un nombre positif.
Exemple
LOG10(1)
renvoie 0LOG10(14)
renvoie 1.146128.
Median
Median(…)
: calcule la médiane d'une ou de plusieurs valeurs (éventuellement non triées).
Exemple
Median (5, 4, 3, 7, 6)
renvoie 5.
Mod
Mod(n,d)
: modulo d'un nombre (n) divisé par un nombre (d) (opération d'entiers).
L'opération Modulo trouve le reste de 1 nombre entier (n) divisé par un entier diviseur (d).
Si (n) est positif, le résultat est positif.
Si (n) est négatif, le résultat est négatif.
Si vous utilisez des valeurs décimales, la décimale est tronquée. Cela peut entraîner une erreur « Divisé par 0 » si le diviseur est un nombre décimal inférieur à 1.
Exemple
MOD(6,4)
renvoie 2.MOD(6,-4)
renvoie 2.MOD(-6,4)
renvoie -2.MOD(-6,-4)
renvoie -2.MOD(6,.4)
renvoie [Null].
PI
PI()
: renvoie la valeur de la constante PI avec une précision à 15 chiffres.
Exemple
PI()
renvoie 3.141593.
POW
POW(x, e)
: renvoie un nombre (x) élevé à la puissance (e).
Exemple
POW(2, 3)
est équivalent à 2
3
et renvoie 8.
RAND
RAND()
: renvoie un nombre aléatoire supérieur ou égal à 0 et inférieur à 1.
Exemple
RAND()
renvoie un nombre aléatoire tel que 0.256.
RandInt
RandInt(n)
: renvoie un entier aléatoire compris entre 0 et le paramètre spécifié (n).
Exemple
RandInt(10)
renvoie 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ou 10RandInt(5000)
renvoie un nombre entier aléatoire compris entre 0 et 5 000, par exemple 741
Round
Round(x, mult)
: renvoie un nombre (x) arrondi au multiple le plus proche de (mult).
Note
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.
Exemple
Round(55.34, 2)
renvoie la valeur 56.Round(39.88, 10)
renvoie la valeur 40.Round(41.1, 10)
renvoie la valeur 40.Round(1.25, 0.1)
renvoie la valeur 1.3.Round(1.227, 0.01)
renvoie la valeur 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)
: renvoie le sinus d'un angle donné (x). x doit être en radians.
Exemple
SIN(90)
renvoie 0.893996663600558.
SINH
SINH(x)
: renvoie le sinus hyperbolique d'un nombre (x).
SmartRound
SmartRound(x)
: renvoie un nombre (x) arrondi au multiple le plus proche d'une valeur déterminée dynamiquement à partir de la taille de (x).
SQRT
SQRT(x)
: renvoie la racine carrée d'un nombre (x).
Exemple
SQRT(100)
renvoie une valeur de 10
TAN
TAN(x)
: renvoie la tangente d'un angle donné (x). x doit être en radians.
Exemple
TAN(1)
renvoie 1.5574077246549.
TANH
TANH(x)
: renvoie la tangente hyperbolique d'un nombre (x).
Exemple
TANH(90)
renvoie 1.