Skip to main content

Riferimento alle funzioni del flusso di lavoro

In questo articolo sono illustrate le funzioni per la trasformazione dei dati disponibili in Live Query. Il tipo di dati determina le funzioni che è possibile utilizzare.

Per ulteriori informazioni, consulta la sezione Tipi di dati supportati.

Puoi usare questa guida per individuare rapidamente le funzioni utilizzabili nell'Editor espressioni di Live Query. Per ulteriori informazioni ed esempi, consulta le pagine specifiche delle diverse categorie collegate all'interno di ogni sezione.

Condizionale

Le funzioni condizionali consentono di eseguire un'azione o un calcolo utilizzando un'istruzione IF. Per parametri ed esempi, consulta la sezione Funzioni condizionali del flusso di lavoro.

IF condizione THEN t ELSE f ENDIF

IF c THEN t ELSE f ENDIF: restituisce t se la condizione c è True, altrimenti restituisce f.

IF c THEN t1 ELSEIF c2 THEN t2 ELSE f ENDIF

IF c THEN t1 ELSEIF c2 THEN t2 ELSE f ENDIFIF c THEN t ELSE f ENDIF: restituisce t1 se c è True e t2 se la condizione c2 è True, altrimenti restituisce f.

IIF

IIF(bool, x, y): restituisce x se il valore booleano è True, altrimenti restituisce y.

Switch

Switch(Value,Default,Case1,Result1,...,CaseN,ResultN): confronta un valore rispetto a un elenco di casi e restituisce il risultato corrispondente.

Conversione

Le funzioni di conversione convertono i numeri in stringhe o le stringhe in numeri. Per parametri ed esempi, consulta la sezione Funzioni di conversione del flusso di lavoro.

CharFromInt

CharFromInt(x): restituisce il carattere Unicode® corrispondente al numero di input x.

Nota

Questa funzione non è disponibile per Live Query for Databricks.

ToDegrees

ToDegrees(x): converte un valore radiante numerico (x) in gradi tramite il calcolo (x)rad x 180/π. Tieni presente che x deve essere un valore numerico e non può includere alcun simbolo di radiante (rad).

ToNumber

ToNumber(x, [bIgnoreErrors], [keepNulls], [decimalSeparator]): converte una stringa (x) in un numero.

ToRadians

ToRadians(x): converte un valore numerico in gradi (x) in radianti tramite il calcolo (x)°  × π/180. Tieni presente che x deve essere un valore numerico e non può includere il simbolo del grado (°).

ToString

ToString(x, numDec, [addThousandsSeparator], [decimalSeparator]): converte un parametro numerico (x) in una stringa utilizzando posizioni decimali numDec. La selezione predefinita utilizza un punto come separatore decimale.

Data e ora

Le funzioni Data e ora consentono di eseguire un'azione o un calcolo su un valore di data e ora. Per parametri ed esempi, consulta la sezione Funzioni Data e ora del flusso di lavoro.

DateTimeAdd

DateTimeAdd(dt,i,u): aggiunge un intervallo specifico a un valore di data-ora.

DateTimeDay

DateTimeDay(dt): restituisce il valore numerico del giorno del mese in un valore data-ora.

DateTimeDiff

DateTimeDiff(dt1,dt2,u): sottrae il secondo argomento dal primo e lo restituisce come differenza intera. La durata viene restituita come numero, non come stringa, nelle unità di tempo specificate.

DateTimeFirstOfMonth

DateTimeFirstOfMonth(): restituisce il primo giorno del mese, a mezzanotte.

DateTimeFormat

DateTimeFormat(dt, f): converte il valore di data e ora df nel formato specificato da f.

Nota

Questa funzione non è disponibile per Live Query for Databricks.

DateTimeHour

DateTimeHour(dt): restituisce la porzione dell'ora in un valore data-ora.

DateTimeLastOfMonth

DateTimeLastOfMonth(): restituisce l'ultimo giorno del mese corrente, con l'orologio impostato a un secondo prima della fine del giorno (23:59:59).

DateTimeMinutes

DateTimeMinutes(dt): restituisce la porzione di minuti dell'orario in un valore data-ora.

DateTimeMonth

DateTimeMonth(dt): restituisce il valore numerico del mese in un valore data-ora.

DateTimeNow

DateTimeNow(): restituisce la data e ora di sistema corrente.

DateTimeParse

DateTimeParse(dt, f): converte una stringa di data dal formato e dalla lingua specificati al formato standard ISO (aaaa-mm-gg HH:MM:SS).

Nota

Questa funzione non è disponibile per Live Query for Databricks.

DateTimeQuarter

DateTimeQuarter(dt,[Q1Start]): restituisce il valore numerico per il trimestre dell'anno nel quale rientra un valore data-ora (AAAA-MM-GG). Utilizza il parametro numerico opzionale per indicare il mese di inizio per il primo trimestre (Q1).

DateTimeSeconds

DateTimeSeconds(dt): estrae la porzione dei secondi da un valore di data e ora.

DateTimeToday

DateTimeToday(): restituisce la data odierna.

DateTimeTrim

DateTimeTrim(dt, f): rimuove le porzioni indesiderate di un valore di data e ora, quindi restituisce il valore modificato.

Nota

Questa funzione non è disponibile per Live Query for Databricks.

DateTimeYear

DateTimeYear(dt): restituisce il valore numerico dell'anno in un valore data-ora.

ToDate

ToDate(x): converte una stringa, un numero o un valore data-ora in data.

ToDateTime

DateTimeTrim(ToDateTime(x), t): converte una stringa, un numero o un valore di data in un valore di data e ora.

Finanza

Una funzione finanziaria applica algoritmi finanziari o calcoli matematici. Per ulteriori informazioni, consulta la sezione Funzioni finanziarie del flusso di lavoro.

FinanceCAGR

FinanceCAGR(BeginningValue, EndingValue, NumYears): calcola il tasso di crescita annuale composto, cioè il tasso di crescita con media geometrica su base annua.

FinanceEffectiveRate

FinanceEffectiveRate(NominalRate, PaymentsPerYear): calcola il tasso d'interesse annuale effettivo, cioè il tasso d'interesse su un prestito o un prodotto finanziario ricalcolato dal tasso d'interesse nominale come un tasso d'interesse composto annuale da pagare in via posticipata.

FinanceFV

FinanceFV(Rate, NumPayments, PaymentAmount, PresentValue, PayAtPeriodBegin): calcola il valore futuro di un investimento, cioè il valore di una risorsa in un dato momento nel futuro, ipotizzando un determinato tasso d'interesse o di rendimento.

FinanceIRR

FinanceIRR(Value1, Value2): calcola il tasso di rendimento interno, ovvero il tasso d'interesse a cui il capitale investito genera un rendimento. Ciò significa che tutti i guadagni dell'investimento sono inerenti al valore temporale del denaro e che, con questo tasso d'interesse, l'investimento ha un valore attuale netto pari a zero.

Nota

Questa funzione non è disponibile per Live Query for Databricks.

FinanceNominalRate

FinanceNominalRate(EffectiveRate, PaymentsPerYear): calcola il tasso d'interesse nominale annuale. Un tasso d'interesse è definito nominale quando la frequenza di compounding (ad esempio un mese) non è identica all'unità di tempo di base (normalmente un anno).

FinanceNPER

FinanceNPER(Rate, PaymentAmount, PresentValue, FutureValue, PayAtPeriodBegin): calcola il numero di periodi per un investimento o prestito.

FinancePMT

FinancePMT(Rate, NumPayments, PresentValue, FutureValue, PayAtPeriodBegin): calcola i pagamenti su un prestito.

FinancePV

FinancePV(Rate, NumPayments, PaymentAmount, FutureValue, PayAtPeriodBegin): calcola il valore attuale di un investimento, cioè il valore in una data specifica di un pagamento futuro, o di una serie di pagamenti futuri, ridotto per riflettere il valore temporale del denaro e altri fattori quali il rischio di investimento.

FinanceXIRR

FinanceXIRR(Value1, Date1, Value2, Date2): calcola il tasso di rendimento interno di un investimento con le date.

Nota

Questa funzione non è disponibile per Live Query for Databricks.

FinanceXNPV

FinanceXNPV(Rate, Value1, Date1, Value2, Date2): calcola il valore attuale netto di un investimento con le date.

Matematica

Una funzione matematica esegue calcoli matematici. Per parametri ed esempi, consulta la sezione Funzioni matematiche del flusso di lavoro.

ABS

ABS(x): restituisce il valore assoluto di x. Si tratta della distanza tra 0 e un numero. Il valore è sempre positivo.

ACOS

ACOS(x): restituisce l'arcocoseno o il coseno inverso di un numero (x). L'arcocoseno è l'angolo il cui coseno è (x).

ASIN

ASIN(x): restituisce l'arcoseno o il seno inverso di un numeror (x). L'arcoseno è l'angolo il cui seno è (x).

ATAN

ATAN(x): restituisce l'arcotangente o la tangente inversa di un numero (x). L'arcotangente è l'angolo la cui tangente è (x). L'angolo viene restituito in radianti con un valore compreso nell'intervallo da -pi/2 a pi/2.

ATAN2

ATAN2(y, x): restituisce l'arcotangente o la tangente inversa di y e x (Arco - tangente di (y/x)).

Media

Average(n1, ...): restituisce la media di un elenco di numeri. I valori NULL sono trattati come 0 e presi in considerazione nel calcolo del valore medio.

AverageNonNull

AverageNonNull(n1, ...): restituisce la media di un elenco di numeri. I valori null sono esclusi dal calcolo. Il calcolo funziona solo con i tipi di dati numerici.

CEIL

.CEIL(x, [mult]): restituisce un valore numerico (x) elevato al più piccolo multiplo di (mult) che sia maggiore o uguale a x. Il parametro (mult) deve essere un numero maggiore di 0. Quando il parametro (mult) non è specificato, la funzione restituisce il numero intero più piccolo maggiore o uguale a (x).

COS

COS(x): restituisce il coseno di un angolo (x), dove x è un valore in radianti.

EXP

EXP(x): restituisce il valore "e" elevato all'esponente "x".

FLOOR

FLOOR(x, [mult]): restituisce un valore numerico (x) ridotto al multiplo più grande di (mult), minore o uguale a x. Il parametro (mult) deve essere un numero maggiore di 0. Se il parametro (mult) non è specificato, la funzione restituisce il numero intero più grande minore o uguale a (x), come mostrato nel primo esempio di seguito.

LOG

LOG(x): restituisce il logaritmo naturale di un numero (x). L'argomento x deve essere un valore numerico positivo.

LOG10

LOG10(x): restituisce il logaritmo di base 10 di un numero (x). L'argomento x deve essere un valore numerico positivo.

Median

Median(...): calcola il valore mediano di uno o più valori (verosimilmente non ordinati).

Nota

Questa funzione non è disponibile per Live Query for Databricks.

Mod

Mod(n,d): modulo di un numero (n) diviso per un numero (d) (operazione con numeri interi).

PI

PI(): restituisce il valore della costante PI in 15 cifre di precisione.

POW

POW(x, e): restituisce (x) elevato alla potenza di (e).

RAND

RAND(): restituisce un numero casuale maggiore o uguale a 0 e minore di 1.

RandInt

RandInt(n): restituisce un numero intero casuale compreso tra 0 e il parametro specificato (n).

Round

Round(x, mult): restituisce il valore di x arrotondato al multiplo più vicino del numero specificato da mult.

SIN

SIN(x): restituisce il seno di un angolo (x), dove x è un valore in radianti.

SmartRound

SmartRound(x): restituisce un numero (x) arrotondato al multiplo più vicino di un valore determinato dinamicamente in base alla dimensione di (x).

SQRT

SQRT(x): restituisce la radice quadrata di un numero (x).

TAN

TAN(x): restituisce la tangente di un angolo (x), dove x è un valore in radianti.

TANH

TANH(x): restituisce la tangente iperbolica di un numero (x).

Min/Max

Una funzione minima o massima trova il valore più piccolo e più grande di un set di valori. Per ulteriori informazioni, consulta la sezione Funzioni Min/Max del flusso di lavoro.

Between

BETWEEN(x, min, max): verifica se un valore (x) è compreso tra 2 altri valori (min e max), incluso i valori minimo e massimo. Restituisce TRUE se x è compreso tra min e max. Restituisce FALSE se x non è compreso tra min e max.

Bound

Bound(x, min, max): se (x < min) restituisce min e se (x > max) restituisce max, altrimenti restituisce (x).

Max

Max(v0, v1, ..., vn): restituisce il valore massimo incluso nell'elenco.

Min

Min(v0, v1,..., vn): restituisce il valore minimo dell'elenco.

Operatori

Un operatore è un carattere che rappresenta un'azione. Utilizza un operatore aritmetico per eseguire calcoli matematici o un operatore booleano per lavorare con valori di tipo Vero/Falso. Per ulteriori informazioni, consulta la sezione Operatori del flusso di lavoro.

Addizione

+: addizione.

AND booleano - Parola chiave

AND: permette di combinare 2 valori booleani. Il risultato è vero se entrambi i valori combinati sono true, false se uno dei due è false ma non NULL e NULL se uno dei due è NULL.

Booleano E

&&: permette di combinare 2 valori booleani. Il risultato è vero se entrambi i valori combinati sono true, false se uno dei due è false ma non NULL e NULL se uno dei due è NULL.

NON Booleano - Parola chiave

NOT: accetta 1 input. Se l'input è true, restituisce False. Se l'input è false, restituisce True. Se l'input è NULL, restituisce NULL.

NOT booleano

!: accetta 1 input. Se l'input è true, restituisce False. Se l'input è false, restituisce True. Se l'input è NULL, restituisce NULL.

Boolean OR - Keyword

OR: permette di combinare 2 valori booleani. Restituisce True se uno (o entrambi) i valori sono true. Restituisce NULL se uno dei valori è NULL.

Booleano OR

||: permette di combinare 2 valori booleani. Restituisce True se uno (o entrambi) i valori sono true. Restituisce NULL se uno dei valori è NULL.

Divisione

/: divisione.

Uguale a

=: uguale a.

Maggiore di

>: maggiore di.

Greater Than or Equal

>=: maggiore o uguale a.

Less Than

<: minore di.

Less Than or Equal

<=: minore o uguale a.

Moltiplicazione

*: moltiplicazione.

Not Equal To

!=: non uguale a

Subtraction

-: sottrazione.

Value IN (...)

IN: valore di test incluso nell'elenco.

Value NOT IN (...)

NOT IN: valore di test non incluso nell'elenco.

Specializzato

Queste funzioni eseguono una varietà di azioni specializzate e possono essere utilizzate con tutti i tipi di dati. Per parametri ed esempi, consulta la sezione Funzioni specializzate del flusso di lavoro.

NULL

NULL(): restituisce un valore Null.

Stringa

Una funzione stringa esegue operazioni sui dati di testo. Puoi usare una funzione stringa per pulire i dati, cambiare il formato o la combinazione di maiuscole e minuscole dei dati, calcolare metriche sui dati o eseguire altre manipolazioni. Per parametri ed esempi, consulta la sezione Funzioni stringa del flusso di lavoro.

Contains

Contains(String, Target, CaseInsensitive)1): cerca l'occorrenza di una determinata stringa all'interno di una stringa. Restituisce True se (Stringa) contiene (Target), altrimenti restituisce False.

CountWords

CountWords(string): restituisce il numero di parole nella stringa specificata. Le parole sono definite da caratteri separati da uno spazio.

Nota

Questa funzione non è disponibile per Live Query for Databricks.

EndsWith

EndsWith(String, Target, CaseInsensitive=1): controlla se una stringa termina con una determinata stringa. Restituisce True se (String) termina con (Target), altrimenti restituisce False. Per impostazione predefinita, non fa distinzione tra maiuscole e minuscole.

FindNth

FindNth(Initial String, Target, Instance): trova l'istanza (ennesima occorrenza) di una stringa target nella stringa iniziale e restituisce la posizione con indicizzazione 0 dell'istanza. La funzione distingue tra maiuscole e minuscole e non accetta parametri negativi.

FindString

FindString(String,Target): cerca l'occorrenza di una determinata stringa (Target) all'interno di un'altra stringa (String) e restituisce la posizione numerica di tale occorrenza nella stringa. Restituisce l'indice in base 0 della prima occorrenza di (Target) in (String). Se non ci sono occorrenze, restituisce -1.

GetLeft

GetLeft(String, Delimiter): restituisce la parte sinistra della stringa fornita fino alla prima istanza di 1 o più delimitatori specificati.

GetPart

GetPart(String, Delimiter, Index): utilizza 1 o più delimitatori specificati per dividere la stringa in sottostringhe e restituisce la sottostringa nella posizione specificata nell'indice.

GetRight

GetRight(String, Delimiter): restituisce la parte destra della stringa dopo la prima istanza di 1 o più delimitatori specificati.

GetWord

GetWord(string, n): restituisce l'ennesima parola (in base 0) nella stringa. Le parole sono definite come una raccolta di caratteri separati da uno spazio. Indice in base 0, indica che la prima parola si trova nella posizione 0.

Left

Left(String, len): restituisce i primi (len) caratteri della stringa (String). Se len è minore di 0 o maggiore della lunghezza di String, String rimane invariato.

Length

Length(String): restituisce la lunghezza della stringa (String).

LowerCase

LowerCase(String): converte una stringa in caratteri minuscoli.

PadLeft

PadLeft (String, len, char): consente di riempire la parte sinistra di una stringa con il carattere specificato, fino alla lunghezza indicata. Qualora la spaziatura (carattere) risultasse più lunga di 1 carattere, verrà utilizzato solo il primo carattere.

PadRight

PadRight (String, len, char): consente di riempire la parte destra di una stringa con il carattere specificato, fino alla lunghezza indicata. Qualora la spaziatura (carattere) risultasse più lunga di 1 carattere, verrà utilizzato solo il primo carattere.

REGEX_CountMatches

REGEX_CountMatches(String,pattern,icase): restituisce il numero di corrispondenze al modello all'interno della stringa.

Nota

Questa funzione non è disponibile per Live Query for Databricks.

REGEX_Match

REGEX_Match(String,pattern,icase): cerca un'occorrenza di un'espressione regolare in una stringa. Indica se la stringa corrisponde al modello dal primo carattere alla fine.

Nota

Questa funzione non è disponibile per Live Query for Databricks.

REGEX_Replace

REGEX_Replace(String, pattern, replace, icase): restituisce la stringa risultante dal pattern di ricerca RegEx e sostituisce la stringa.

Nota

Questa funzione non è disponibile per Live Query for Databricks.

Replace

Replace(String, Target, Replacement) : restituisce la stringa (stringa) dopo aver sostituito ogni occorrenza della stringa (Target) con la stringa (sostituzione).

ReplaceChar

ReplaceChar(String, y, z): restituisce la stringa (String) dopo aver sostituito ogni occorrenza del carattere (y) con il carattere (z). Qualora il carattere sostitutivo (z) fosse una stringa con più di 1 carattere, verrà utilizzato solo il primo carattere. Quando (z) è vuoto, ogni carattere (String) che corrisponde a qualsiasi carattere in (y) viene semplicemente rimosso.

ReplaceFirst

ReplaceFirst(String, Target, Replacement): restituisce la stringa (String) dopo aver sostituito la prima occorrenza della stringa (Target) con la stringa (Replacement).

ReverseString

ReverseString(String): inverte tutti i caratteri nella stringa.

Nota

Questa funzione non è disponibile per Live Query for Databricks.

Right

Right(String, len): restituisce gli ultimi caratteri (len) della stringa. Se len è minore di 0 o maggiore della lunghezza di String, la stringa rimane invariata.

StartsWith

StartsWith(String, Target, CaseInsensitive=1): controlla se una stringa inizia con una determinata stringa. Restituisce True se la stringa inizia con una particolare stringa Target, altrimenti restituisce False.

STRCSPN

STRCSPN(String, y): restituisce la lunghezza del segmento iniziale della stringa (String) costituito da caratteri non nella stringa (y).

StripQuotes

StripQuotes(String): rimuove un set corrispondente di virgolette o apostrofi dalle estremità della stringa.

STRSPN

STRSPN(String, y): restituisce la lunghezza del segmento iniziale della stringa (String) costituita da caratteri nella stringa (y).

Substring

Substring(String, start, length) : restituisce la sottostringa di (String) a partire da (start), terminando dopo (length), se fornita.

TitleCase

TitleCase(String): converte una stringa in iniziali maiuscole.

Trim

Trim(String, y): rimuove i caratteri nella stringa (y) dalle estremità della stringa (String). Y è facoltativo e, per impostazione predefinita, rimuove gli spazi vuoti. Nota che, negli esempi di utilizzo della funzione TRIM, i caratteri specificati vengono eliminati. Non importa in che ordine sono i caratteri.

TrimLeft

TrimLeft(String, y): rimuove il carattere nella stringa (y) dall'inizio della stringa (String). Y è facoltativo e, per impostazione predefinita, rimuove gli spazi vuoti.

TrimRight

TrimRight(String, y): rimuove il carattere nella stringa (y) dalla fine della stringa (String). Y è facoltativo e, per impostazione predefinita, rimuove gli spazi vuoti.

Uppercase

Uppercase(String): converte una stringa in caratteri maiuscoli.

Test

Una funzione di test permette di confrontare i dati. Puoi utilizzare una funzione Test per identificare il tipo di dati di un valore o verificare se un determinato valore esiste. Per parametri ed esempi, consulta la sezione Funzioni di test del flusso di lavoro.

CompareDigits

CompareDigits(a, b, nNumDigits): confronta 2 numeri e determina se sono uguali al numero di cifre specificato (nNumDigits).

CompareEpsilon

CompareEpsilon(a, b, epsilon): confronta 2 numeri in virgola mobile e restituisce True quando risultano entro epsilon.

EqualStrings

EqualStrings(a,b): confronta la stringa (a) con la stringa (b) per determinare se corrispondono esattamente. La funzione restituisce True quando tutti i caratteri in entrambe le stringhe a e b sono identici, e False quando uno o più caratteri non sono identici.

IsEmpty

IsEmpty(v): verifica se v è NULL o uguale a "".

IsInteger

IsInteger(v): verifica se (v) contiene un valore che si può convertire in un numero intero. In caso affermativo, restituisce True.

IsLowerCase

IsLowerCase(String): restituisce True quando tutti (uno o più) i caratteri alfabetici di una stringa sono minuscoli, e False quando uno o più caratteri alfabetici sono maiuscoli. La funzione ignora i caratteri non alfabetici. Questa funzione si applica solo ai caratteri con distinzione tra maiuscole e minuscole e potrebbe non essere applicabile ai caratteri di tutte le lingue.

IsNull

IsNull(v): verifica se (v) è NULL. Restituisce True se v è NULL, altrimenti restituisce False.

IsNumber

IsNumber(v): verifica se il tipo di campo per (v) è un numero o meno.

IsString

IsString(v): verifica se il tipo di campo per (v) è una stringa o meno.

IsUpperCase

IsUpperCase(String): restituisce True se tutti (uno o più) i caratteri alfabetici in una stringa sono maiuscoli e False se uno o più caratteri alfabetici sono minuscoli. La funzione ignora i caratteri non alfabetici. Questa funzione si applica solo ai caratteri con distinzione tra maiuscole e minuscole e potrebbe non essere applicabile ai caratteri di tutte le lingue.