TapHome

Funcții matematice

Funcțiile matematice ale scriptului TapHome — MIN, MAX, AVG (și variantele STRICT), ROUND, ABS, DEWPOINT, POWER, MOD, CEIL, FLOOR, RAND, RANDINT, SIGN, SQRT, LOG, LN.

MIN

Funcția MIN returnează minimul din valorile numerice furnizate. Acceptă între 1 și 100 de argumente sau o singură colecție. Valorile NaN și NULL sunt ignorate.

MIN( n1, n2, n3, …)
MIN( collection )

Exemple:

MIN(40, 80)  		= 40
MIN(2, 2, 6) 		= 2
MIN(80, NAN)		= 80
MIN(NAN, NAN)		= NaN

VAR data := {10, 20, 30}; MIN(data) 	= 10
MIN({1, 2, 3})							= 1
MIN({1, NaN, 3})						= 1

VAR d1 := DATETIME(2014, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
VAR d2 := DATETIME(2015, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
MIN(d1, d2)			... Result is d1

MINSTRICT

Funcția MINSTRICT returnează minimul din valorile numerice furnizate. Acceptă între 1 și 100 de argumente sau o singură colecție. Dacă oricare dintre valorile furnizate este NaN sau NULL, funcția returnează NaN/NULL.

MINSTRICT( n1, n2, n3, …)
MINSTRICT( collection )

Exemple:

MINSTRICT(40, 80)  		= 40
MINSTRICT(2, 2, 6) 		= 2
MINSTRICT(80, NAN)		= NaN
MINSTRICT(NAN, NAN)		= NaN

VAR data := {10, 20, 30}; MINSTRICT(data) 	= 10
MINSTRICT({1, 2, 3})						= 1
MINSTRICT({1, NaN, 3})						= NaN

VAR d1 := DATETIME(2014, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
VAR d2 := DATETIME(2015, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
MINSTRICT(d1, NULL, d2)		... Result is NULL

MAX

Funcția MAX returnează maximul din valorile numerice furnizate. Acceptă între 1 și 100 de argumente sau o singură colecție. Valorile NaN și NULL sunt ignorate.

MAX( n1, n2, n3, …)
MAX( collection )

Exemple:

MAX(40, 80)  			= 80
MAX(2, 2, 6) 			= 6
MAX(80, NAN)			= 80
MAX(NAN, NAN)			= NaN

VAR data := {10, 20, 30}; MAX(data) = 30
MAX({1, 2, 3})						= 3
MAX({1, NaN, 3})					= 3

VAR d1 := DATETIME(2014, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
VAR d2 := DATETIME(2015, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
MAX(d1, d2)				... Result is d2

MAXSTRICT

Funcția MAXSTRICT returnează maximul din valorile numerice furnizate. Acceptă între 1 și 100 de argumente sau o singură colecție. Dacă oricare dintre valorile furnizate este NaN sau NULL, funcția returnează NaN/NULL.

MAXSTRICT( n1, n2, n3, …)
MAXSTRICT( collection )

Exemple:

MAXSTRICT(40, 80)  			= 80
MAXSTRICT(2, 2, 6) 			= 6
MAXSTRICT(80, NAN)			= NaN
MAXSTRICT(NAN, NAN)			= NaN

VAR data := {10, 20, 30}; MAXSTRICT(data) 	= 30
MAXSTRICT({1, 2, 3})				= 3
MAXSTRICT({1, NaN, 3})				= NaN

VAR d1 := DATETIME(2014, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
VAR d2 := DATETIME(2015, 12, 8, 0, 0, 0, 0, DateTimeKind.Utc);
MAXSTRICT(d1, NULL, d2)		... Result is NULL

AVG

Funcția AVG calculează media aritmetică a valorilor numerice furnizate. Acceptă între 1 și 100 de argumente sau o singură colecție. Valorile NaN sunt ignorate.

AVG( n1, n2, n3, …)
AVG( collection )

Exemple:

AVG(40, 80)  		= 60
AVG(2, 2, 6) 		= 3.3333
AVG(80, NAN)		= 80
AVG(‘a’, ‘c’)		= ‘b’
AVG(NAN, NAN)		= NaN

VAR data := {10, 20, 30}; AVG(data) 	= 20
AVG({1, 2, 3})							= 2
AVG({1, NaN, 3})						= 2

AVGSTRICT

Funcția AVGSTRICT calculează media aritmetică a valorilor numerice furnizate. Acceptă între 1 și 100 de argumente sau o singură colecție. Dacă oricare dintre valori nu este un număr, funcția returnează NaN.

AVGSTRICT( n1, n2, n3, …)
AVGSTRICT( collection )

Exemple:

AVGSTRICT(40, 80)  		= 60
AVGSTRICT(2, 2, 6) 		= 3.3333
AVGSTRICT(80, NAN)		= NaN
AVGSTRICT(NAN, NAN)		= NaN

VAR data := {10, 20, 30}; AVGSTRICT(data) 	= 20
AVGSTRICT({1, 2, 3})						= 2
AVGSTRICT({1, NaN, 3})						= NaN

ROUND

ROUND(value1)    

Returnează valoarea rotunjită.

Exemplul 1: ROUND(2.01)   (Rezultatul este 2)
Exemplul 2: ROUND(2.49)   (Rezultatul este 2)
Exemplul 3: ROUND(2.5)   (Rezultatul este 3)
Exemplul 4: ROUND(2.99)   (Rezultatul este 3)

ABS

Funcția ABS returnează valoarea absolută (modulul) oricărui număr furnizat.

ABS(number)

Exemple:

ABS(100)  ...   100
ABS(-100)   ...   100

DEWPOINT

DEWPOINT(temperature, relativeHumidity)

Returnează temperatura punctului de rouă pe baza temperaturii curente și a umidității relative. Punctul de rouă se calculează conform acestei ecuații.

Exemplul 1: DEWPOINT(20, 0.50) (Rezultatul este ~9.26)
Exemplul 2: DEWPOINT(0, 1.00) (Rezultatul este 0)

POWER

Funcția POWER ridică un număr dat la puterea specificată.

POWER(number, power)

Exemple:

  • POWER(2,3) … 2^3 = 8
  • POWER(10, -3) … 0,001
  • POWER(25, 0) … 1

MOD

Funcția MOD returnează restul împărțirii a două numere furnizate.

MOD(number, divisor)

Argumente:

  • number - Numărul care urmează să fie împărțit.
  • divisor - Valoarea la care se împarte argumentul number.

Exemple:

  • MOD(6, 4) … 2
  • MOD(6, 2.5) … 1

CEIL

Funcția CEIL rotunjește un număr furnizat în sus, la cel mai apropiat multiplu al valorii specificate (significance); un număr negativ cu significance negativ se rotunjește în direcția opusă lui zero.

CEIL(number, significance)

Argumente:

  • number - Numărul care urmează să fie rotunjit.
  • significance (opțional) - Multiplul la care trebuie rotunjit numărul furnizat. Dacă argumentul significance nu este specificat, este egal cu 1. (Acest argument ar trebui să aibă în general același semn aritmetic (pozitiv sau negativ) ca și argumentul number)

Exemple:

  • CEIL(22.25,0.1) … 22.3
  • CEIL(22.25,1) … 23
  • CEIL(22.25) … 23
  • CEIL(-22.25,-1) … -23
  • CEIL(-22.25,1) … -22
  • CEIL(-22.25) … -22
  • CEIL(-22.25,-5) … -25

FLOOR

Funcția FLOOR rotunjește un număr furnizat în jos, la cel mai apropiat multiplu al valorii specificate (significance); un număr negativ cu significance negativ se rotunjește spre zero.

FLOOR(number, significance)

Argumente:

  • number - Numărul care urmează să fie rotunjit.
  • significance (opțional) - Multiplul la care trebuie rotunjit numărul furnizat. Dacă argumentul significance nu este specificat, este egal cu 1. (Acest argument ar trebui să aibă în general același semn aritmetic (pozitiv sau negativ) ca și argumentul number)

Exemple:

  • FLOOR(22.25,0.1)… 22.2
  • FLOOR(22.25,1) … 22
  • FLOOR(22.25) … 22
  • FLOOR(-22.25,-1) … -22
  • FLOOR(-22.25,1) … -23
  • FLOOR(-22.25) … -23
  • FLOOR(-22.25,-5) … -20

RAND

Funcția RAND generează un număr real aleatoriu între 0 și 1.

RAND()

Exemple:

  • RAND()

RANDINT

Funcția RANDINT generează un număr întreg aleatoriu între două numere întregi furnizate.

RANDINT(bottom, top)

Exemple:

  • RANDINT(1,5)
  • RANDINT(-2,2)

SIGN

Funcția SIGN returnează semnul aritmetic (+1, -1 sau 0) al unui număr furnizat. Dacă numărul este pozitiv, funcția returnează +1; dacă numărul este negativ, funcția returnează -1; dacă numărul este 0 (zero), funcția returnează 0.

SIGN(number)

Exemple:

  • SIGN(100) … 1
  • SIGN(0) … 0
  • SIGN(-100) … -1

SQRT

Funcția SQRT calculează rădăcina pătrată pozitivă a unui număr furnizat.

SQRT(number)

Exemple:

  • SQRT(25) … 5

LOG

Funcția LOG calculează logaritmul unui număr dat în baza specificată.

LOG(number, base)

Argumente:

  • number - Numărul real pozitiv al cărui logaritm se calculează.
  • base (opțional) - Argument opțional care specifică baza în care se calculează logaritmul. Dacă argumentul nu este specificat, se folosește valoarea implicită 10.

Exemple:

  • LOG(4,0.5) … -2
  • LOG(100) … 2

LN

Funcția LN calculează logaritmul natural al unui număr dat.

LN(number)

unde argumentul number este numărul real pozitiv al cărui logaritm natural se calculează.

Exemple:

  • LN(100) … 4,60517