Passer au contenu principal
Adaptive Planning
Dernière mise à jour : 2023-06-23
Référence : opérateurs et fonctions pour les calculs

Référence : opérateurs et fonctions pour les calculs

Règles de syntaxe

  • Comptes, calculs et métriques personnalisées. Obligatoire. Utilisez le code du compte (pas le nom) ou le code du calcul dans les expressions.
    • Doit être placé entre crochets. Eexemple:
      [1000_Assets]
      ou
      [My_Quick_Ratio]
      .
  • Versions. Facultatif. Utilisez la syntaxe suivante :
    [code](version = [version name])
    pour référencer n'importe quelle version d'un compte, d'un calcul ou d'une métrique personnalisée définie dans votre instance. Par exemple :
    [headcount_FTE](version = [Forecast 2018])
    , où
    Effectif_ETP
    est le compte et
    Prévisions 2018
    est la version. Si aucune option n'est indiquée, la version par défaut est utilisée. Voir Concept : calculs dans les graphiques pour en savoir plus sur
    les Versions et l'ordre de priorité
    .
    • Doit être mis entre parenthèses.
    • Des crochets sont requis lorsque le nom de la version comporte des espaces. Par exemple,
      Budget de travail
      doit être placé entre crochets.
      Budgetdetravail
      ne doit pas être placé entre crochets.
  • Priorité des opérateurs : évalue de gauche à droite ou clôtured entre parenthèses pour calculer en premier.

Opérateurs mathématiques

Opérateur
Description
Syntaxe
+
Additionne deux valeurs.
[metric1] + [metric2]
-
Soustrait deux valeurs.
[metric1] - [metric2]
/
Divise deux valeurs.
[metric1] / [metric2]
*
Multiplie deux valeurs.
[metric1] * [metric2]
%
Calcule le reste (modulo) lors de la division de deux valeurs.
[metric1] % [metric2]
^
Augmente la valeur de gauche à la puissance de la valeur de droite. Par exemple, 5^2 = 25.
[metric1] ^2

Opérateurs de comparaison

Utilisez les opérateurs de comparaison avec la fonction iif. Eexemple:
iif([30_Net_Income] <= ([41_laptopRev] + [42_desktopRev] + [43_tabletRev]), [30_Net_Income], 40_Product_Revenue])
.
Opérateur
Description
Syntaxe
=
Vérifie si deux valeurs sont égales.
[metric1] = [metric2]
<>
Vérifie si deux valeurs ne sont pas égales.
[metric1] <> [metric2]
<
Vérifie si la valeur de gauche est inférieure à la valeur de droite.
[metric1] < [metric2]
<=
Vérifie si la valeur de gauche est inférieure ou égale à la valeur de droite.
[metric1] <= [metric2]
>
Vérifie si la valeur de gauche est supérieure à la valeur de droite.
[metric1] > [metric2]
>=
Vérifie si la valeur de gauche est supérieure ou égale à la valeur de droite.
[metric1] >= [metric2]
BETWEEN
Vérifie si une valeur est comprise entre deux autres valeurs. Les valeurs minimum et maximum sont incluses dans la plage. Utilisez-le avec l'opérateur AND.
[metric1] BETWEEN 0 AND [metric2]
NOT BETWEEN
Vérifie si une valeur n'est pas comprise entre les deux autres valeurs. Les valeurs minimum et maximum sont incluses dans la plage. Utilisez-le avec l'opérateur AND.
[metric1] NOT BETWEEN 0 AND [metric2]
AND
Compare deux expressions et renvoie true (vrai) si les deux expressions sont vraies.
([metric1] >= [metric2]) AND ([metric1] >= [metric3])
OR
Compare deux expressions et renvoie true (vrai) si l'une des expressions est vraie.
([metric1] >= [metric2]) OR ([metric1] >= [metric3])

Fonction de comparaison

Fonction
Description
Exemple
iif(
comparaison
,
expression true
,
expression false
)
Évalue l'expression de
comparaison
. Si true (vrai), renvoie l'
expression true.
Autrement, renvoie l'
expression
false
.
iif([metric1] > 10 AND [metric1] < 20, [metric2], [metric3])

Fonctions de calcul

Fonction
Description
Exemple
min(
expression
,
expression
)
Renvoie la plus petite valeur de deux expressions.
min([metric1], [metric2])
max(
expression
,
expression
)
Renvoie la plus grande valeur de deux expressions.
max([metric1], [metric2])
sin(
expression
)
Renvoie le sinus d'une métrique ou d'une expression. Utilisé en trigonométrie.
sin([metric1])
cos(
expression
)
Renvoie le cosinus d'une métrique ou d'une expression. Utilisé en trigonométrie.
cos([metric1])
tan(
expression
)
Renvoie la tangente d'une métrique ou d'une expression. Utilisé en trigonométrie.
tan([metric1])
abs(
expression
)
Renvoie la valeur absolue d'une métrique ou d'une expression. Permet de convertir les nombres négatifs en nombres positifs.
abs([metric1])
sqrt(
expression
)
Renvoie la racine carrée d'une métrique ou d'une expression.
sqrt([metric1])
round(
expression
)
Arrondit une valeur numérique au nombre entier le plus proche. Le point médian est arrondi. Exemples :
  • round(10.2) est arrondi à 10
  • round(10.5) est arrondi à 11
  • round(10.7) est arrondi à 11
round([metric1])
round(
expression
,
digits
)
Arrondit une valeur numérique à un nombre spécifié de chiffres.
Chiffres
positifs arrondis au nombre spécifié de décimales.
Chiffres
négatifs arrondis au multiple de 10 le plus proche. Exemples :
  • round(2.15, 1) est arrondi à 2.2
  • round(70, -2) est arrondi à 100
round([metric1], 1)
floor(
expression
)
Renvoie une valeur numérique arrondie en direction de zéro. Exemples :
  • floor(10.2) est arrondi à 10
  • floor(10.5) est arrondi à 10
  • floor(10.7) est arrondi à 10
floor([metric1], 2)
floor(
expression
,
expression
)
Renvoie une valeur numérique arrondie en direction de zéro, au multiple d'intérêt le plus proche. Exemples :
  • floor(3.5, 2) est arrondi à 2
floor([metric1], 2)
ceiling(
expression
)
Renvoie un nombre arrondi éloigné de zéro. Exemples :
  • ceiling(10) est arrondi à 11
  • ceiling(10.5) est arrondi à 11
  • ceiling(10.7) est arrondi à 11
ceiling([metric1])
ceiling(
expression
,
expression
)
Renvoie le nombre arrondi, éloigné de zéro, au multiple d'intérêt le plus proche. Exemples :
  • ceiling(10, 1) est arrondi à 11
  • ceiling(10.5, 2) est arrondi à 13
  • ceiling(10.7, 2) est arrondi à 13
ceiling([metric1], 2)

Fonctions de validation

Fonction
Description
Exemple
isnull(
expression
,
expression nulle
)
Vérifie si l'
expression
est nulle. Si true (vrai), renvoie l'
expression nulle
.
Sinon, renvoie l'
expression
valeur.
isnull([metric1], [metric2])
isinfinity(
expression
,
expression infinie
)
Vérifie si
l'expression
est infinie (diviser)d par zéro). Si true (vrai), renvoie l'
expression infinie
valeur. Sinon, renvoie la valeur de l'
expression
.
isinfinity([metric1], [metric2])
isnan(
expression
,
expression NaN
)
Vérifie si l'
expression
n'est pas un nombre (zéro divisé par zéro). Si true (vrai), renvoie l'
expression NaN
valeur. Sinon, renvoie l'
expression
valeur.
isnan([metric1], [metric2])
isnrn(
expression
,
expression NrN
)
Vérifie si l'
expression
est un nombre réel, tel que infini, NaN ou nul. Si true (vrai), renvoiele
Expression NrN
valeur. Sinon, renvoie l'
expression
valeur.
isnan([metric1], [metric2])