[comment]: # attributes: notoc

[comment]: # (terms: abs, acos, asin, atan, atan2, avg, cbrt, ceil, cos, cosh, cot, degrees, e, exp, expm1, floor, log, log10, max, min, mod, pi, power, radians, rand, round, signum, sin, sinh, sqrt, sum, tan, truncate )

[comment]: # ({666e2f6b-ef4bef6c})
# 6 Funkcje matematyczne

Wszystkie funkcje wymienione tutaj są obsługiwane w:

-   [Wyrażeniach wyzwalaczy](/manual/config/triggers/expression)
-   [Pozycjach obliczanych](/manual/config/items/itemtypes/calculated)
-   [Makrach wyrażeń](/manual/config/macros/expression_macros)

Funkcje matematyczne są obsługiwane dla typów wartości float i integer,
o ile nie zaznaczono inaczej.

Funkcje są wymienione bez dodatkowych informacji. Kliknij funkcję, aby zobaczyć pełne szczegóły.

|Function|Description|
|--|--------|
|[abs](#abs)|Wartość bezwzględna wartości.|
|[acos](#acos)|Arcus cosinus wartości jako kąt wyrażony w radianach.|
|[asin](#asin)|Arcus sinus wartości jako kąt wyrażony w radianach.|
|[atan](#atan)|Arcus tangens wartości jako kąt wyrażony w radianach.|
|[atan2](#atan2)|Arcus tangens współrzędnych rzędnej (wartości) i odciętej określonych jako kąt wyrażony w radianach.|
|[avg](#avg)|Średnia wartość odwołanych wartości pozycji.|
|[cbrt](#cbrt)|Pierwiastek sześcienny z wartości.|
|[ceil](#ceil)|Zaokrągla wartość w górę do najbliższej większej lub równej liczby całkowitej.|
|[cos](#cos)|Cosinus wartości, gdzie wartość jest kątem wyrażonym w radianach.|
|[cosh](#cosh)|Cosinus hiperboliczny wartości.|
|[cot](#cot)|Cotangens wartości, gdzie wartość jest kątem wyrażonym w radianach.|
|[degrees](#degrees)|Konwertuje wartość z radianów na stopnie.|
|[e](#e)|Liczba Eulera (2.718281828459045).|
|[exp](#exp)|Liczba Eulera podniesiona do potęgi wartości.|
|[expm1](#expm1)|Liczba Eulera podniesiona do potęgi wartości minus 1.|
|[floor](#floor)|Zaokrągla wartość w dół do najbliższej mniejszej lub równej liczby całkowitej.|
|[log](#log)|Logarytm naturalny.|
|[log10](#log10)|Logarytm dziesiętny.|
|[max](#max)|Najwyższa wartość odwołanych wartości pozycji.|
|[min](#min)|Najniższa wartość odwołanych wartości pozycji.|
|[mod](#mod)|Reszta z dzielenia.|
|[pi](#pi)|Stała Pi (3.14159265358979).|
|[power](#power)|Potęga wartości.|
|[radians](#radians)|Konwertuje wartość ze stopni na radiany.|
|[rand](#rand)|Zwraca losową wartość całkowitą.|
|[round](#round)|Zaokrągla wartość do określonej liczby miejsc po przecinku.|
|[signum](#signum)|Zwraca '-1', jeśli wartość jest ujemna, '0', jeśli wartość wynosi zero, '1', jeśli wartość jest dodatnia.|
|[sin](#sin)|Sinus wartości, gdzie wartość jest kątem wyrażonym w radianach.|
|[sinh](#sinh)|Sinus hiperboliczny wartości, gdzie wartość jest kątem wyrażonym w radianach.|
|[sqrt](#sqrt)|Pierwiastek kwadratowy z wartości.|
|[sum](#sum)|Suma odwołanych wartości pozycji.| 
|[tan](#tan)|Tangens wartości.|
|[truncate](#truncate)|Obcina wartość do określonej liczby miejsc po przecinku.|

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

[comment]: # ({e635e2a6-f932d69d})
### Szczegóły funkcji

Kilka ogólnych uwag dotyczących parametrów funkcji:

-   Parametry funkcji są oddzielone przecinkiem
-   Wyrażenia są akceptowane jako parametry
-   Opcjonalne parametry funkcji (lub części parametrów) są oznaczone przez
    `<` `>`

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

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

Wartość bezwzględna (od 0) wartości.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład wartość bezwzględna zarówno „3”, jak i „-3” będzie wynosić „3”.

Przykład:

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

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

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

Arcus cosinus wartości jako kąta, wyrażony w radianach.

Parametr:

-   **value** - wartość do sprawdzenia

Wartość musi mieścić się w zakresie od -1 do 1. Na przykład arcus cosinus wartości „0.5” będzie wynosił „2.0943951”.

Przykład:

    acos(last(/host/key))

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

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

Arcus sinus wartości jako kąt wyrażony w radianach.

Parametr:

-   **value** - wartość do sprawdzenia

Wartość musi mieścić się w zakresie od -1 do 1. Na przykład arcus sinus wartości „0.5” będzie wynosić „-0.523598776”.

Przykład:

    asin(last(/host/key))

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

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

Arcus tangens wartości jako kąt wyrażony w radianach.

Parametr:

-   **value** - wartość do sprawdzenia

Na przykład arcus tangens wartości „1” będzie wynosił „0.785398163”.

Przykład:

    atan(last(/host/key))

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

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

Arcus tangens współrzędnych rzędnej (value) i odciętej, określony jako kąt wyrażony w radianach.

Parametry: 

-   **value** - wartość do sprawdzenia;
-   **abscissa** - wartość odciętej.

Na przykład arcus tangens współrzędnych rzędnej i odciętej dla wartości „1” będzie wynosić „2.21429744”.

Przykład:

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

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

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

Średnia wartość wartości pozycja, do których istnieje odwołanie.

Parametr: 

-   **valueX** — wartość zwracana przez inną funkcję, która działa na historii pozycji.

Przykład:

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

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

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

Pierwiastek sześcienny z wartości.

Parametr:

-   **value** - wartość do sprawdzenia

Na przykład pierwiastek sześcienny z „64” wyniesie „4”, a z „63” — „3.97905721”.

Przykład:

    cbrt(last(/host/key))

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

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

Zaokrągla wartość w górę do najbliższej większej lub równej liczby całkowitej.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład „2.4” zostanie zaokrąglone w górę do „3”. Zobacz także [floor()](#floor).

Przykład:

    ceil(last(/host/key))

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

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

Cosinus wartości, gdzie wartość jest kątem wyrażonym w radianach.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład cosinus wartości „1” będzie wynosił „0.54030230586”.

Przykład:

    cos(last(/host/key))

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

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

Cosinus hiperboliczny wartości.
Zwraca wartość jako liczbę rzeczywistą, a nie w notacji naukowej.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład cosinus hiperboliczny wartości „1” wyniesie „1.54308063482”.

Przykład:

    cosh(last(/host/key))

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

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

Cotangens wartości, gdzie wartość jest kątem wyrażonym w radianach.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład cotangens wartości „1” będzie wynosił „0.54030230586”.

Przykład:

    cot(last(/host/key))

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

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

Konwertuje wartość z radianów na stopnie.

Parametr:

-   **value** - wartość do sprawdzenia

Na przykład wartość „1” po konwersji na stopnie będzie wynosić „57.2957795”.

Przykład:

    degrees(last(/host/key))

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

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

Liczba Eulera (2.718281828459045).

Przykład:

    e()

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

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

Liczba Eulera podniesiona do potęgi wartości.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład liczba Eulera podniesiona do potęgi wartości „2” będzie równa „7.38905609893065”.

Przykład:

    exp(last(/host/key))

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

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

Liczba Eulera podniesiona do potęgi wartości minus 1.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład liczba Eulera podniesiona do potęgi wartości „2” minus 1 będzie równa „6.38905609893065”.

Przykład:

    expm1(last(/host/key))

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

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

Zaokrągla wartość w dół do najbliższej mniejszej lub równej liczby całkowitej.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład „2.6” zostanie zaokrąglone w dół do „2”. Zobacz także [ceil()](#ceil).

Przykład:

    floor(last(/host/key))

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

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

Logarytm naturalny.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład logarytm naturalny wartości „2” wyniesie „0.69314718055994529”.

Przykład:

    log(last(/host/key))

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

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

Logarytm dziesiętny.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład logarytm dziesiętny wartości „5” wyniesie „0.69897000433”.

Przykład:

    log10(last(/host/key))

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

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

Najwyższa wartość spośród wartości referencyjnych pozycji.

Parametr: 

-   **valueX** - wartość zwracana przez inną funkcję, która działa na historii pozycji.

Przykład:

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

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

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

Najniższa wartość spośród wartości referencyjnych pozycji.

Parametr: 

-   **valueX** - wartość zwracana przez inną funkcję, która działa na historii pozycji.

Przykład:

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

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

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

Reszta z dzielenia.

Parametry: 

-   **value** - wartość do sprawdzenia;
-   **denominator** - mianownik dzielenia.

Na przykład reszta z dzielenia wartości '5' przez mianownik dzielenia '2' będzie wynosić '1'.

Przykład:

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

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

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

Stała Pi (3.14159265358979).

Przykład:

    pi()

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

[comment]: # ({e5f39714-617a0fc5})
##### power(value,power value) {#power}

Potęga wartości.

Parametry: 

-   **value** - wartość do sprawdzenia;
-   **power value** - wykładnik potęgi do użycia.

Na przykład trzecia potęga wartości „2” będzie równa „8”.

Przykład:

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

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

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

Konwertuje wartość ze stopni na radiany.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład wartość „1” po konwersji na radiany będzie wynosić „0.0174532925”.

Przykład:

    radians(last(/host/key))

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

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

Zwraca losową wartość całkowitą. Jest to liczba pseudolosowa generowana z użyciem czasu jako ziarna (wystarczająca do celów matematycznych, ale nie do kryptografii).

Przykład:

    rand()

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

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

Zaokrągla wartość do określonej liczby miejsc dziesiętnych.

Parametry: 

-   **value** - wartość do sprawdzenia;
-   **decimal places** - określa liczbę miejsc dziesiętnych do zaokrąglenia (możliwe jest również 0).

Na przykład wartość „2.5482” zaokrąglona do 2 miejsc dziesiętnych będzie wynosić „2.55”.

Przykład:

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

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

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

Zwraca '-1', jeśli wartość jest ujemna, '0', jeśli wartość jest równa zero, oraz '1', jeśli wartość jest dodatnia.

Parametr: 

-   **value** - wartość do sprawdzenia.

Przykład:

    signum(last(/host/key))

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

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

Sinus wartości, gdzie wartość jest kątem wyrażonym w radianach.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład sinus wartości „1” wyniesie „0.8414709848”.

Przykład:

    sin(last(/host/key))

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

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

Sinus hiperboliczny wartości.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład sinus hiperboliczny wartości „1” wyniesie „1.17520119364”.

Przykład:

    sinh(last(/host/key))

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

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

Pierwiastek kwadratowy z wartości.<br>
Ta funkcja zakończy się niepowodzeniem dla wartości ujemnej.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład pierwiastek kwadratowy z wartości „3.5” będzie wynosił „1.87082869339”.

Przykład:

    sqrt(last(/host/key))

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

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

Suma wartości referencyjnych pozycji.

Parametr: 

-   **valueX** - wartość zwracana przez inną funkcję, która pracuje z historią pozycji.

Przykład:

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

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

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

Tangens wartości.

Parametr: 

-   **value** - wartość do sprawdzenia

Na przykład tangens wartości „1” wyniesie „1.55740772465”.

Przykład:

    tan(last(/host/key))

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

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

Obetnij wartość do określonej liczby miejsc dziesiętnych.

Parametry: 

-   **value** - wartość do sprawdzenia;
-   **decimal places** - określ liczbę miejsc dziesiętnych do obcięcia (możliwe jest również 0).

Na przykład wartość „2.5482” obcięta do 2 miejsc dziesiętnych będzie wynosić „2.54”.

Przykład:

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

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

[comment]: # ({544a48ff-92620b8c})
Zobacz [wszystkie obsługiwane funkcje](/manual/appendix/functions).

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