[comment]: # attributes: notoc

[comment]: # ({666e2f6b-ef4bef6c})
# 6 Fonctions mathématiques

Toutes les fonctions répertoriées ici sont prises en charge dans :

-   [Expressions de déclencheur](/manual/config/triggers/expression)
-   [Éléments calculés](/manual/config/items/itemtypes/calculated)
-   [Macros d'expression](/manual/config/macros/expression_macros)

Les fonctions mathématiques sont prises en charge avec les types de valeurs flottant et entier,
sauf indication contraire.

Les fonctions sont répertoriées sans informations supplémentaires. Cliquez sur la fonction pour voir les détails complets.

|Function|Description|
|--|--------|
|[abs](#abs)|La valeur absolue d'une valeur.|
|[acos](#acos)|L'arccosinus d'une valeur, en tant qu'angle exprimé en radians.|
|[asin](#asin)|L'arcsinus d'une valeur, en tant qu'angle exprimé en radians.|
|[atan](#atan)|L'arctangente d'une valeur, en tant qu'angle exprimé en radians.|
|[atan2](#atan2)|L'arctangente des coordonnées d'ordonnée (valeur) et d'abscisse spécifiées, en tant qu'angle exprimé en radians.|
|[avg](#avg)|La valeur moyenne des valeurs de l'élément référencé.|
|[cbrt](#cbrt)|La racine cubique d'une valeur.|
|[ceil](#ceil)|Arrondit la valeur à l'entier supérieur le plus proche ou égal.|
|[cos](#cos)|Le cosinus d'une valeur, où la valeur est un angle exprimé en radians.|
|[cosh](#cosh)|Le cosinus hyperbolique d'une valeur.|
|[cot](#cot)|La cotangente d'une valeur, où la valeur est un angle exprimé en radians.|
|[degrees](#degrees)|Convertit une valeur de radians en degrés.|
|[e](#e)|Le nombre d'Euler (2.718281828459045).|
|[exp](#exp)|Le nombre d'Euler élevé à la puissance d'une valeur.|
|[expm1](#expm1)|Le nombre d'Euler élevé à la puissance d'une valeur moins 1.|
|[floor](#floor)|Arrondit la valeur à l'entier inférieur le plus proche ou égal.|
|[log](#log)|Le logarithme naturel.|
|[log10](#log10)|Le logarithme décimal.|
|[max](#max)|La valeur la plus élevée des valeurs de l'élément référencé.|
|[min](#min)|La valeur la plus faible des valeurs de l'élément référencé.|
|[mod](#mod)|Le reste de la division.|
|[pi](#pi)|La constante Pi (3.14159265358979).|
|[power](#power)|La puissance d'une valeur.|
|[radians](#radians)|Convertit une valeur de degrés en radians.|
|[rand](#rand)|Retourne une valeur entière aléatoire.|
|[round](#round)|Arrondit la valeur au nombre de décimales indiqué.|
|[signum](#signum)|Retourne '-1' si une valeur est négative, '0' si une valeur est nulle, '1' si une valeur est positive.|
|[sin](#sin)|Le sinus d'une valeur, où la valeur est un angle exprimé en radians.|
|[sinh](#sinh)|Le sinus hyperbolique d'une valeur, où la valeur est un angle exprimé en radians.|
|[sqrt](#sqrt)|La racine carrée d'une valeur.|
|[sum](#sum)|La somme des valeurs de l'élément référencé.| 
|[tan](#tan)|La tangente d'une valeur.|
|[truncate](#truncate)|Tronque la valeur au nombre de décimales indiqué.|

[comment]: # ({/666e2f6b-ef4bef6c})

[comment]: # ({e635e2a6-f932d69d})
### Détails des fonctions

Quelques remarques générales sur les paramètres de fonction :

-   Les paramètres de fonction sont séparés par une virgule
-   Les expressions sont acceptées comme paramètres
-   Les paramètres de fonction optionnels (ou parties de paramètres) sont indiqués par
    `<` `>`

[comment]: # ({/e635e2a6-f932d69d})

[comment]: # ({39973c9a-89cbc486})
##### abs(value) {#abs}

La valeur absolue (à partir de 0) d’une valeur.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, la valeur absolue de « 3 » ou de « -3 » sera « 3 ».

Exemple :

    abs(last(/host/key))>10

[comment]: # ({/39973c9a-89cbc486})

[comment]: # ({754d73c7-f40a2e61})
##### acos(value) {#acos}

L’arccosinus d’une valeur sous forme d’angle, exprimé en radians.

Paramètre : 

-   **value** - la valeur à vérifier

La valeur doit être comprise entre -1 et 1. Par exemple, l’arccosinus de la valeur « 0.5 » sera « 2.0943951 ».

Exemple :

    acos(last(/host/key))

[comment]: # ({/754d73c7-f40a2e61})

[comment]: # ({f32d79d9-b44dbca5})
##### asin(value) {#asin}

L’arcsinus d’une valeur sous forme d’angle, exprimé en radians.

Paramètre : 

-   **value** - la valeur à vérifier

La valeur doit être comprise entre -1 et 1. Par exemple, l’arcsinus d’une valeur « 0.5 » sera « -0.523598776 ».

Exemple :

    asin(last(/host/key))

[comment]: # ({/f32d79d9-b44dbca5})

[comment]: # ({debc5495-08e0843c})
##### atan(value) {#atan}

L'arc tangente d'une valeur sous forme d'angle, exprimée en radians.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, l'arc tangente d'une valeur « 1 » sera « 0.785398163 ».

Exemple :

    atan(last(/hôte/key))

[comment]: # ({/debc5495-08e0843c})

[comment]: # ({1c279561-6df7b343})
##### atan2(value,abscissa) {#atan2}

L’arctangente de l’ordonnée (value) et des coordonnées de l’abscisse, spécifiée sous forme d’angle, exprimée en radians.

Paramètres : 

-   **value** - la valeur à vérifier ;
-   **abscissa** - la valeur de l’abscisse.

Par exemple, l’arctangente des coordonnées de l’ordonnée et de l’abscisse d’une valeur « 1 » sera « 2.21429744 ».

Exemple :

    atan2(last(/host/key),2)

[comment]: # ({/1c279561-6df7b343})

[comment]: # ({94ba0bc0-6d42ceda})
##### avg(<value1>,<value2>,...) {#avg}

La valeur moyenne des valeurs d’élément référencées.

Paramètre : 

-   **valueX** - la valeur renvoyée par une autre fonction qui fonctionne avec l’historique des éléments.

Exemple :

    avg(avg(/host/key,1h),avg(/host2/key2,1h))

[comment]: # ({/94ba0bc0-6d42ceda})

[comment]: # ({ef0cb9ef-65742fe9})
##### cbrt(value) {#cbrt}

La racine cubique d'une valeur.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, la racine cubique de « 64 » sera « 4 », celle de « 63 » sera « 3.97905721 ».

Exemple :

    cbrt(last(/host/key))

[comment]: # ({/ef0cb9ef-65742fe9})

[comment]: # ({696b523c-4290a457})
##### ceil(value) {#ceil}

Arrondit la valeur à l’entier supérieur ou égal le plus proche.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, « 2.4 » sera arrondi à « 3 ». Voir aussi [floor()](#floor).

Exemple :

    ceil(last(/host/key))

[comment]: # ({/696b523c-4290a457})

[comment]: # ({dee428c3-b07f5dfa})
##### cos(value) {#cos}

Le cosinus d’une valeur, où la valeur est un angle exprimé en radians.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, le cosinus d’une valeur « 1 » sera « 0.54030230586 ».

Exemple :

    cos(last(/host/key))

[comment]: # ({/dee428c3-b07f5dfa})

[comment]: # ({a9e4704e-4df693f6})
##### cosh(value) {#cosh}

Le cosinus hyperbolique d’une valeur.
Renvoie la valeur sous forme de nombre réel, et non en notation scientifique.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, le cosinus hyperbolique de la valeur « 1 » sera « 1.54308063482 ».

Exemple :

    cosh(last(/host/key))

[comment]: # ({/a9e4704e-4df693f6})

[comment]: # ({b169abdb-7b0480bb})
##### cot(value) {#cot}

La cotangente d’une valeur, où la valeur est un angle exprimé en radians.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, la cotangente d’une valeur « 1 » sera « 0.54030230586 ».

Exemple :

    cot(last(/host/key))

[comment]: # ({/b169abdb-7b0480bb})

[comment]: # ({49d843a0-552d8ac9})
##### degrees(value) {#degrees}

Convertit une valeur de radians en degrés.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, une valeur « 1 » convertie en degrés donnera « 57.2957795 ».

Exemple :

    degrees(last(/host/key))

[comment]: # ({/49d843a0-552d8ac9})

[comment]: # ({7078d3f3-790837bf})
##### e {#e}

Le nombre d’Euler (2.718281828459045).

Exemple :

    e()

[comment]: # ({/7078d3f3-790837bf})

[comment]: # ({329513b5-5f0104cf})
##### exp(value) {#exp}

Le nombre d’Euler élevé à la puissance d’une valeur.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, le nombre d’Euler élevé à la puissance de la valeur « 2 » sera « 7.38905609893065 ».

Exemple :

    exp(last(/host/key))

[comment]: # ({/329513b5-5f0104cf})

[comment]: # ({ae4a884c-fa7bce72})
##### expm1(value) {#expm1}

Le nombre d’Euler élevé à la puissance d’une valeur, moins 1.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, le nombre d’Euler élevé à la puissance de la valeur « 2 », moins 1, sera « 6.38905609893065 ».

Exemple :

    expm1(last(/host/key))

[comment]: # ({/ae4a884c-fa7bce72})

[comment]: # ({d6651028-367cea41})
##### floor(value) {#floor}

Arrondit la valeur à l’entier inférieur ou égal le plus proche.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, « 2.6 » sera arrondi à « 2 ». Voir aussi [ceil()](#ceil).

Exemple :

    floor(last(/host/key))

[comment]: # ({/d6651028-367cea41})

[comment]: # ({fb4ffc82-02960b00})
##### log(value) {#log}

Le logarithme naturel.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, le logarithme naturel d'une valeur « 2 » sera « 0.69314718055994529 ».

Exemple :

    log(last(/host/key))

[comment]: # ({/fb4ffc82-02960b00})

[comment]: # ({e44235f6-9eb02241})
##### log10(value) {#log10}

Le logarithme décimal.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, le logarithme décimal d’une valeur « 5 » sera « 0.69897000433 ».

Exemple :

    log10(last(/host/key))

[comment]: # ({/e44235f6-9eb02241})

[comment]: # ({3b20d32e-9b8efc17})
##### max(<value1>,<value2>,...) {#max}

La valeur la plus élevée des valeurs d'élément référencées.

Paramètre : 

-   **valueX** - la valeur renvoyée par une autre fonction qui fonctionne avec l'historique des éléments.

Exemple :

    max(avg(/host/key,1h),avg(/host2/key2,1h))

[comment]: # ({/3b20d32e-9b8efc17})

[comment]: # ({f8d47c9b-5e82e822})
##### min(<value1>,<value2>,...) {#min}

La valeur la plus faible des valeurs d'élément référencées.

Paramètre : 

-   **valueX** - la valeur renvoyée par une autre fonction qui fonctionne avec l'historique des éléments.

Exemple :

    min(avg(/host/key,1h),avg(/host2/key2,1h))

[comment]: # ({/f8d47c9b-5e82e822})

[comment]: # ({0c1c211e-120dd48b})
##### mod(value,denominator) {#mod}

Le reste de la division.

Paramètres : 

-   **value** - la valeur à vérifier ;
-   **denominator** - le dénominateur de la division.

Par exemple, le reste de la division d’une valeur « 5 » par le dénominateur « 2 » sera « 1 ».

Exemple :

    mod(last(/host/key),2)

[comment]: # ({/0c1c211e-120dd48b})

[comment]: # ({5fae5f18-d8cd6290})
##### pi {#pi}

La constante Pi (3.14159265358979).

Exemple :

    pi()

[comment]: # ({/5fae5f18-d8cd6290})

[comment]: # ({e5f39714-617a0fc5})
##### power(valeur,valeur de puissance) {#power}

La puissance d'une valeur.

Paramètres : 

-   **valeur** - la valeur à vérifier ;
-   **valeur de puissance** - la puissance N à utiliser.

Par exemple, la 3e puissance d'une valeur « 2 » sera « 8 ».

Exemple :

    power(last(/host/key),3)

[comment]: # ({/e5f39714-617a0fc5})

[comment]: # ({2e3144c2-c94a9d57})
##### radians(value) {#radians}

Convertit une valeur de degrés en radians.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, une valeur « 1 » convertie en radians sera « 0.0174532925 ».

Exemple :

    radians(last(/host/key))

[comment]: # ({/2e3144c2-c94a9d57})

[comment]: # ({91941daf-16f1713f})
##### rand {#rand}

Renvoie une valeur entière aléatoire. Il s’agit d’un nombre pseudo-aléatoire généré en utilisant le temps comme graine (suffisant à des fins mathématiques, mais pas pour la cryptographie).

Exemple :

    rand()

[comment]: # ({/91941daf-16f1713f})

[comment]: # ({d95689d5-e19fd7cb})
##### round(value,decimal places) {#round}

Arrondit la valeur au nombre de décimales spécifié.

Paramètres : 

-   **value** - la valeur à vérifier ;
-   **decimal places** - spécifiez le nombre de décimales pour l’arrondi (0 est également possible).

Par exemple, une valeur « 2.5482 » arrondie à 2 décimales deviendra « 2.55 ».

Exemple :

    round(last(/host/key),2)

[comment]: # ({/d95689d5-e19fd7cb})

[comment]: # ({12a89282-9668b2dc})
##### signum(value) {#signum}

Renvoie '-1' si une valeur est négative, '0' si une valeur est nulle, '1' si une valeur est positive.

Paramètre : 

-   **value** - la valeur à vérifier.

Exemple :

    signum(last(/host/key))

[comment]: # ({/12a89282-9668b2dc})

[comment]: # ({8b506ba0-1c54e7c1})
##### sin(value) {#sin}

Le sinus d’une valeur, où la valeur est un angle exprimé en radians.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, le sinus d’une valeur « 1 » sera « 0.8414709848 ».

Exemple :

    sin(last(/host/key))

[comment]: # ({/8b506ba0-1c54e7c1})

[comment]: # ({8e4e9ad3-f2223e46})
##### sinh(value) {#sinh}

Le sinus hyperbolique d'une valeur.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, le sinus hyperbolique d'une valeur « 1 » sera « 1.17520119364 ».

Exemple :

    sinh(last(/host/key))

[comment]: # ({/8e4e9ad3-f2223e46})

[comment]: # ({b3339bb1-a732b60e})
##### sqrt(value) {#sqrt}

La racine carrée d'une valeur.<br>
Cette fonction échouera avec une valeur négative.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, la racine carrée d'une valeur « 3.5 » sera « 1.87082869339 ».

Exemple :

    sqrt(last(/host/key))

[comment]: # ({/b3339bb1-a732b60e})

[comment]: # ({f850beb9-0bbc007d})
##### sum(<value1>,<value2>,...) {#sum}

La somme des valeurs des éléments référencés.

Paramètre : 

-   **valueX** - la valeur renvoyée par une autre fonction qui fonctionne avec l'historique des éléments.

Exemple :

    sum(avg(/host/key,1h),avg(/host2/key2,1h))

[comment]: # ({/f850beb9-0bbc007d})

[comment]: # ({f06f407d-49e10a41})
##### tan(value) {#tan}

La tangente d’une valeur.

Paramètre : 

-   **value** - la valeur à vérifier

Par exemple, la tangente d’une valeur « 1 » sera « 1.55740772465 ».

Exemple :

    tan(last(/host/key))

[comment]: # ({/f06f407d-49e10a41})

[comment]: # ({4a3d082a-53de5a0f})
##### truncate(value,decimal places) {#truncate}

Tronquer la valeur au nombre de décimales spécifié.

Paramètres : 

-   **value** - la valeur à vérifier ;
-   **decimal places** - spécifiez le nombre de décimales pour la troncature (0 est également possible).

Par exemple, une valeur « 2.5482 » tronquée à 2 décimales deviendra « 2.54 ».

Exemple :

    truncate(last(/host/key),2)

[comment]: # ({/4a3d082a-53de5a0f})

[comment]: # ({544a48ff-92620b8c})
Voir [toutes les fonctions prises en charge](/manual/appendix/functions).

[comment]: # ({/544a48ff-92620b8c})