TapHome

Funzioni matematiche

Funzioni matematiche dello script TapHome — MIN, MAX, AVG (e varianti STRICT), ROUND, ABS, DEWPOINT, POWER, MOD, CEIL, FLOOR, RAND, RANDINT, SIGN, SQRT, LOG, LN.

MIN

La funzione MIN restituisce il minimo tra i valori numerici forniti. Accetta tra 1 e 100 argomenti o una singola collezione. I valori NaN e NULL sono ignorati.

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

Esempi:

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)			... Risultato è d1

MINSTRICT

La funzione MINSTRICT restituisce il minimo tra i valori numerici forniti. Accetta tra 1 e 100 argomenti o una singola collezione. Se uno qualsiasi dei valori forniti è NaN o NULL, la funzione restituisce NaN/NULL.

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

Esempi:

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)		... Risultato è NULL

MAX

La funzione MAX restituisce il massimo tra i valori numerici forniti. Accetta tra 1 e 100 argomenti o una singola collezione. NaN e NULL sono ignorati.

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

Esempi:

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)				... Risultato è d2

MAXSTRICT

La funzione MAXSTRICT restituisce il massimo tra i valori numerici forniti. Accetta tra 1 e 100 argomenti o una singola collezione. Se uno qualsiasi dei valori forniti è NaN o NULL, la funzione restituisce NaN/NULL.

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

Esempi:

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)		... Risultato è NULL

AVG

La funzione AVG calcola la media aritmetica dei valori numerici forniti. Accetta tra 1 e 100 argomenti o una singola collezione. I valori NaN sono ignorati.

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

Esempi:

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

La funzione AVGSTRICT calcola la media dei valori numerici forniti. Accetta tra 1 e 100 argomenti o una singola collezione. Se uno dei valori forniti non è un numero, la funzione restituisce NaN.

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

Esempi:

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)

Restituisce il valore arrotondato.

Esempio 1: ROUND(2.01)   (Risultato è 2)
Esempio 2: ROUND(2.49)   (Risultato è 2)
Esempio 3: ROUND(2.5)    (Risultato è 3)
Esempio 4: ROUND(2.99)   (Risultato è 3)

ABS

La funzione ABS restituisce il valore assoluto (cioè il modulo) di qualsiasi numero fornito.

ABS(number)

Esempi:

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

DEWPOINT

DEWPOINT(temperature, relativeHumidity)

Restituisce la temperatura del punto di rugiada data la temperatura attuale e l’umidità relativa. Il punto di rugiada è calcolato secondo questa equazione.

Example 1: DEWPOINT(20, 0.50) (Result is ~9.26)
Example 2: DEWPOINT(0, 1.00) (Result is 0)

POWER

La funzione POWER calcola un numero dato elevato a una potenza fornita.

POWER(number, power)

Esempi:

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

MOD

La funzione MOD restituisce il resto di una divisione tra due numeri forniti.

MOD(number, divisor)

Argomenti:

  • number - Il numero da dividere.
  • divisor - Il valore per cui si divide il numero.

Esempi:

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

CEIL

La funzione CEIL arrotonda un numero fornito per eccesso, al multiplo di un numero dato.

CEIL(number, significance)

Argomenti:

  • number - Il numero da arrotondare.
  • significance (optional) - Il multiplo al quale il numero fornito deve essere arrotondato. Se non specificato, significance = 1. (Questo dovrebbe avere lo stesso segno aritmetico, positivo o negativo, del numero fornito)

Esempi:

  • 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

La funzione FLOOR arrotonda un numero fornito verso zero, al multiplo di una significatività specificata.

FLOOR(number, significance)

Argomenti:

  • number - Il numero da arrotondare.
  • significance (optional) - Il multiplo al quale il numero fornito deve essere arrotondato. Se non specificato, è uguale a 1. (Questo dovrebbe avere lo stesso segno aritmetico, positivo o negativo, del numero fornito)

Esempi:

  • 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

La funzione RAND genera un numero reale casuale tra 0 e 1.

RAND()

Esempi:

  • RAND()

RANDINT

La funzione RANDINT genera un intero casuale tra due interi forniti.

RANDINT(bottom, top)

Esempi:

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

SIGN

La funzione SIGN restituisce il segno aritmetico (+1, -1 o 0) di un numero fornito. Ad es. se il numero è positivo, SIGN restituisce +1, se è negativo restituisce -1 e se è 0 restituisce 0.

SIGN(number)

Esempi:

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

SQRT

La funzione SQRT calcola la radice quadrata positiva di un numero fornito.

SQRT(number)

Esempi:

  • SQRT(25) … 5

LOG

La funzione LOG calcola il logaritmo di un numero dato, con una base fornita.

LOG(number, base)

Argomenti:

  • number - Il numero reale positivo di cui si vuole calcolare il logaritmo.
  • base (optional) - Argomento opzionale che specifica la base a cui calcolare il logaritmo. Se non specificato, la base di default è 10.

Esempi:

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

LN

La funzione LN calcola il logaritmo naturale di un numero dato.

LN(number)

dove l’argomento è il numero reale positivo di cui si vuole calcolare il logaritmo naturale.

Esempi:

  • LN(100) … 4,60517