---
title: "Funcții matematice"
description: "Funcțiile matematice din scripturile TapHome: MIN, MAX și AVG cu tratarea lui NaN și variantele STRICT, ABS, SIGN, SQRT, POWER, MOD, LOG, LN și DEWPOINT din temperatură și umiditate."
url: "https://taphome.com/ro/docs/script/mathematical-functions/"
language: ro
lastmod: 2026-11-06
generator: hugo
ai:
  topics: ["mathematical-functions","aggregation","rounding","scripting-language"]
  questions: ["Care este diferența dintre funcțiile MIN și MINSTRICT?","Cum tratează TapHome valorile NaN în MIN, MAX și AVG?","Cum se calculează media unor valori într-un script TapHome?","Cum se calculează punctul de rouă din temperatură și umiditate?","Cum se ridică un număr la o putere sau cum se obține restul împărțirii într-un script TapHome?"]
---

# Funcții matematice

Funcțiile matematice ale scripturilor TapHome — MIN, MAX, AVG și variantele lor STRICT, ABS, SIGN, SQRT, POWER, MOD, LOG, LN și DEWPOINT.

Ultima actualizare: 2026-11-06

Funcții pentru agregarea valorilor și pentru aritmetica de bază. `ROUND`, `CEIL`, `FLOOR`, `RAND` și `RANDINT` se găsesc pe pagina [Rotunjire și numere aleatoare](https://taphome.com/ro/docs/script/rounding-and-random/). Operatori precum `+`, `-`, `*` și `/` se găsesc pe pagina [Operatori](https://taphome.com/ro/docs/script/operators/); nu există operatorii `%` sau `**` — în locul lor se folosesc `MOD` și `POWER`.

## MIN

`MIN` returnează cea mai mică dintre valorile date și omite valorile necunoscute (`Null` și `NaN`).

```text
MIN(value1, value2, ...)
MIN(collection)
```

**Parametri** — între 1 și 100 de valori sau exact o colecție. Valorile nu trebuie să fie numere, dar trebuie să fie comparabile între ele, de exemplu valori `datetime`.

**Returnează** — cea mai mică valoare cunoscută. Când nicio valoare nu este cunoscută, rezultatul este `NaN` (`Null` când toate intrările sunt `Null`).

**Exemplu**

```taphome
# valorile necunoscute sunt omise
MIN(40, 80, NaN);
# Result: 40
# funcționează și o colecție
MIN({1, NaN, 3});
# Result: 1
# două valori datetime
VAR d1 := DATETIME(2014, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
VAR d2 := DATETIME(2015, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
# cea mai timpurie dintre cele două date
MIN(d1, d2);
# Result: the value of d1
```

**Erori** — *Collection is empty* pentru o colecție goală.

## MINSTRICT

`MINSTRICT` returnează cea mai mică dintre valorile date, dar imediat ce întâlnește o valoare necunoscută (`Null` sau `NaN`) returnează în schimb acea valoare — se folosește când o singură intrare lipsă trebuie să invalideze întregul rezultat.

```text
MINSTRICT(value1, value2, ...)
MINSTRICT(collection)
```

**Exemplu**

```taphome
# toate valorile sunt cunoscute
MINSTRICT(40, 80);
# Result: 40
# NaN se returnează neschimbat
MINSTRICT(80, NaN);
# Result: NaN
# la fel pentru o colecție
MINSTRICT({1, NaN, 3});
# Result: NaN
```

Argumentele și erorile sunt aceleași ca la [MIN](https://taphome.com/ro/docs/script/mathematical-functions/#min).

## MAX

`MAX` returnează cea mai mare dintre valorile date și omite valorile necunoscute (`Null` și `NaN`); acceptă aceleași argumente ca [MIN](https://taphome.com/ro/docs/script/mathematical-functions/#min).

```text
MAX(value1, value2, ...)
MAX(collection)
```

**Exemplu**

```taphome
MAX(40, 80, NaN);
# Result: 80
MAX({1, NaN, 3});
# Result: 3
```

## MAXSTRICT

`MAXSTRICT` returnează cea mai mare dintre valorile date sau prima valoare necunoscută (`Null` ori `NaN`) pe care o întâlnește.

```text
MAXSTRICT(value1, value2, ...)
MAXSTRICT(collection)
```

**Exemplu**

```taphome
MAXSTRICT(2, 2, 6);
# Result: 6
MAXSTRICT({1, NaN, 3});
# Result: NaN
```

## AVG

`AVG` returnează media aritmetică a valorilor date ca `double` și omite `Null` și `NaN`.

```text
AVG(value1, value2, ...)
AVG(collection)
```

**Returnează** — `double`; `NaN` când nicio valoare nu este cunoscută. Caracterele se mediază după codurile lor, deci `AVG('a', 'c')` este numărul 98, nu caracterul `'b'`.

**Exemplu**

```taphome
# NaN este omis
AVG(40, 80, NaN);
# Result: 60
# media unei colecții
AVG({1, NaN, 3});
# Result: 2
# codurile caracterelor 97 și 99
AVG('a', 'c');
# Result: 98
```

## AVGSTRICT

`AVGSTRICT` returnează media aritmetică a valorilor date sau `NaN` imediat ce una dintre ele este `NaN`.

```text
AVGSTRICT(value1, value2, ...)
AVGSTRICT(collection)
```

**Returnează** — `double`. O intrare `Null` produce o eroare la rulare, nu este o valoare omisă.

**Exemplu**

```taphome
AVGSTRICT(40, 80);
# Result: 60
AVGSTRICT(80, NaN);
# Result: NaN
```

## ABS

`ABS` returnează valoarea absolută a unui număr ca `double`.

```taphome
ABS(-100);
# Result: 100
```

## SIGN

`SIGN` returnează `-1` pentru un număr negativ, `0` pentru zero și `1` pentru un număr pozitiv, ca `int`.

```taphome
SIGN(-22.5);
# Result: -1
```

## SQRT

`SQRT` returnează rădăcina pătrată a unui număr egal cu 0 sau mai mare.

```taphome
SQRT(25);
# Result: 5
```

**Erori** — *Argument for SQRT cannot be less than 0*.

## POWER

`POWER` ridică un număr la exponentul dat; exponentul poate fi negativ sau fracționar.

```text
POWER(number, exponent)
```

**Exemplu**

```taphome
# 2 la puterea a treia
POWER(2, 3);
# Result: 8
# exponent negativ
POWER(10, -3);
# Result: 0.001
# exponent fracționar, rădăcină pătrată
POWER(25, 0.5);
# Result: 5
```

## MOD

`MOD` returnează restul împărțirii unui număr la altul; funcționează și cu numere zecimale.

```text
MOD(dividend, divisor)
```

**Returnează** — `double` cu semnul deîmpărțitului, deci un deîmpărțit negativ dă un rest negativ (spre deosebire de `MOD` din Excel). Un împărțitor 0 dă `NaN`, nu o eroare.

**Exemplu**

```taphome
# numere întregi
MOD(6, 4);
# Result: 2
# împărțitor zecimal
MOD(6, 2.5);
# Result: 1
# semnul deîmpărțitului
MOD(-7, 3);
# Result: -1
```

## LOG

`LOG` returnează logaritmul unui număr pozitiv în baza dată sau în baza 10 când baza este omisă.

```text
LOG(number)
LOG(number, base)
```

**Exemplu**

```taphome
LOG(100);
# Result: 2
LOG(4, 0.5);
# Result: -2
```

**Erori** — *Arguments for LOG cannot be less or equal to 0*; *Second argument for LOG cannot be less or equal to 0 or 1*.

## LN

`LN` returnează logaritmul natural (baza e) al unui număr pozitiv.

```taphome
LN(100);
# Result: 4.605 (rounded)
```

**Erori** — *Argument for LN cannot be less or equal to 0*.

## DEWPOINT

`DEWPOINT` returnează punctul de rouă în °C din temperatura aerului în °C și umiditatea relativă dată ca fracție de la 0 la 1 (0.5 înseamnă 50 %).

```text
DEWPOINT(temperature, relativeHumidity)
```

**Returnează** — `double`, calculat cu formula Magnus ([ecuația](http://bmcnoldy.rsmas.miami.edu/Humidity.html)). Când un argument nu este deloc număr (de exemplu `Null` sau text), rezultatul este `-40`.

**Exemplu**

```taphome
DEWPOINT(20, 0.5);
# Result: 9.26 (rounded)
DEWPOINT(0, 1);
# Result: 0
```

> [!WARNING]
> Umiditatea se transmite ca fracție. `DEWPOINT(20, 50)` returnează 103.17, o valoare fără sens, fără nicio eroare. O umiditate în procente, de exemplu o valoare brută citită dintr-un registru Modbus, trebuie împărțită mai întâi la 100.
