Funzioni predefinite per le espressioni adattive

SI APPLICA A: SDK v4

Questo articolo elenca le funzioni predefinite disponibili ordinate in base al loro utilizzo generico. Per informazioni sugli operatori usati nelle funzioni predefinite e nella sintassi delle espressioni, vedere Operatori.

Le espressioni predefinite sono divise nei tipi di funzione seguenti:

• Stringa
• Raccolta
• Confronto logico
• Conversione
• Matematiche
• Data
• Timex
• Analisi dell'URI
• Manipolazione e costruzione di oggetti
• Espressione regolare
• Controllo del tipo

È anche possibile visualizzare l'elenco in ordine alfabetico.

Funzioni di stringa

Funzione	Spiegazione
length	Restituisce la lunghezza di una stringa.
replace	Sostituisce una sottostringa con la stringa specificata e restituisce la stringa aggiornata. Questa funzione fa distinzione tra maiuscole e minuscole.
replaceIgnoreCase	Sostituisce una sottostringa con la stringa specificata e restituisce la stringa aggiornata. La funzione non fa distinzione tra maiuscole e minuscole.
split	Restituisce una matrice contenente sottostringhe in base al delimitatore specificato.
substring	Restituisce i caratteri di una stringa.
toLower	Restituisce una stringa in minuscolo in un formato delle impostazioni locali facoltativo.
toUpper	Restituisce una stringa in maiuscolo in un formato delle impostazioni locali facoltativo.
Trim	Rimuove gli spazi iniziali e finali da una stringa.
addOrdinal	Restituisce il numero ordinale del numero di input.
endsWith	Verifica se una stringa termina con una sottostringa specifica. Restituisce true se la substring viene trovata, in caso contrario restituisce false. La funzione non fa distinzione tra maiuscole e minuscole.
startsWith	Verifica se una stringa inizia con una sottostringa specifica. Restituisce true se la substring viene trovata, in caso contrario restituisce false. La funzione non fa distinzione tra maiuscole e minuscole.
countWord	Restituisce il numero di parole nella stringa specificata.
concat	Combina due o più stringhe e restituisce la stringa risultante.
newGuid	Restituisce una nuova stringa Guid.
indexOf	Restituisce la posizione iniziale o il valore di indice di una sottostringa oppure cerca l'oggetto specificato e restituisce l'indice in base zero della prima occorrenza all'interno dell'intero elenco. Questa funzione non fa distinzione tra maiuscole e minuscole e gli indici iniziano con il numero 0.
lastIndexOf	Restituisce la posizione iniziale o il valore di indice dell'ultima occorrenza di una sottostringa oppure cerca l'oggetto specificato e restituisce l'indice in base zero dell'ultima occorrenza all'interno dell'intervallo di elementi dell'elenco. Questa funzione non fa distinzione tra maiuscole e minuscole e gli indici iniziano con il numero 0.
sentenceCase	In maiuscolo la prima lettera della prima parola in una stringa in un formato locale facoltativo.
titleCase	In maiuscolo la prima lettera di ogni parola in una stringa in un formato di impostazioni locali facoltativo.
ordinamento inverso	Invertire l'ordine degli elementi in una stringa o in una matrice.

Funzioni di raccolta

Funzione	Spiegazione
contains	Consente di trovare un elemento in una stringa, un elemento in una matrice o un parametro in un oggetto complesso. Esempi: contains('hello world', 'hello') contains(createArray('1','2'), '1') contains(json("{'foo':'bar'}"), 'foo')
first	Restituisce il primo elemento della raccolta.
join	Restituisce una stringa con tutti gli elementi di una matrice, in cui ogni carattere è separato da un delimitatore. Esempio: join(createArray('a','b'), '.') = "a.b"
last	Restituisce l'ultimo elemento della raccolta.
count	Restituisce il numero di elementi presenti nella raccolta.
foreach	Opera su ogni elemento e restituisce la nuova raccolta.
union	Restituisce una raccolta che contiene tutti gli elementi delle raccolte specificate.
skip	Rimuove gli elementi dall'inizio di una raccolta e restituisce gli elementi rimanenti.
take	Restituisce gli elementi dall'inizio di una raccolta.
intersection	Restituisce una raccolta che contiene solo gli elementi comuni alle raccolte specificate.
subArray	Restituisce una matrice secondaria dalle posizioni iniziale e finale specificate. I valori di Indice iniziano con il numero 0.
select	Opera su ogni elemento e restituisce la nuova raccolta di elementi trasformati.
where	Filtra in base a ogni elemento e restituire la nuova raccolta di elementi filtrati che soddisfano la condizione specificata.
sortBy	Ordina gli elementi della raccolta in ordine crescente e restituisce la raccolta ordinata.
sortByDescending	Ordina gli elementi della raccolta in ordine decrescente e restituisce la raccolta ordinata.
indicesAndValues	Converte una matrice o un oggetto in una matrice di oggetti con proprietà index e value.
flatten	Rende flat le matrici in una matrice con valori non matrice.
unique	Rimuove tutti i duplicati da una matrice.
qualsiasi	Determina se gli elementi di una sequenza soddisfano una condizione.
tutto	Determinare se tutti gli elementi di una sequenza soddisfano una condizione.
ordinamento inverso	Invertire l'ordine degli elementi in una stringa o in una matrice.
merge	Unisce più oggetti o elementi JSON in una matrice.

Funzioni di confronto logico

Funzione	Spiegazione
e	and logico. Restituisce true se tutte le espressioni specificate restituiscono true.
equals	Operatore di confronto uguale a. Restituisce true se i valori specificati sono uguali.
empty	Controlla se la destinazione è vuota.
greater	Operatore di confronto maggiore di. Restituisce true se il primo valore è maggiore; restituisce false se è minore.
greaterOrEquals	Operatore di confronto maggiore o uguale a. Restituisce true se il primo valore è maggiore o uguale; restituisce false se è minore.
if	Verifica se un'espressione è true o false. In base al risultato, restituisce un valore specificato.
less	Confronto minore dell'operazione. Restituisce true se il primo valore è minore, restituisce false se è maggiore.
lessOrEquals	Operatore di confronto minore o uguale a. Restituisce true se il primo valore è minore o uguale; restituisce false se è maggiore.
not	Operatore not logico. Restituisce true se l'espressione è false; restituisce false se è true.
oppure	Logica o operazione. Restituisce true se almeno un'espressione è true o false se tutte le espressioni sono false.
exists	Valuta la veridicità di un'espressione.

Funzioni di conversione

Funzione	Spiegazione
float	Restituisce la rappresentazione a virgola mobile della stringa specificata.
int	Restituisce la rappresentazione integer della stringa specificata.
string	Restituisce la versione stringa del valore specificato in un formato di impostazioni locali facoltativo.
bool	Restituisce la rappresentazione booleana dell'oggetto specificato.
createArray	Crea una matrice da più input.
json	Restituisce il valore o l'oggetto di tipo JSON (JavaScript Object Notation) di una stringa o un elemento XML.
base64	Restituisce la versione con codifica base64 di una matrice di stringhe o di byte.
base64ToBinary	Restituisce la versione binaria di una stringa con codifica base64.
base64ToString	Restituisce la versione stringa di una stringa con codifica base64.
binary	Restituisce la versione binaria di un valore di input.
dataUri	Restituisce l'URI di un valore di input.
dataUriToBinary	Restituisce la versione binaria di un URI di dati.
dataUriToString	Restituisce la versione stringa di un URI di dati.
uriComponent	Restituisce la versione codificata in formato URI per un valore di input sostituendo i caratteri non sicuri dell'URL con caratteri di escape.
uriComponentToString	Restituisce la versione stringa di una stringa con codifica URI.
xml	Restituisce la versione XML di una stringa.
formatNumber	Formattare un valore al numero più vicino al numero specificato di cifre frazionarie e alle impostazioni locali specificate facoltative.
jsonStringify	Restituisce la stringa JSON di un valore.
stringOrValue Eseguire il wrapping dell'interpolazione di stringhe per ottenere il valore reale. Ad esempio, restituisce stringOrValue('${1}') il numero 1, mentre stringOrValue('${1} item') restituisce la stringa "1 elemento".

Funzioni matematiche

Funzione	Spiegazione
abs	Restituisce il valore assoluto del numero specificato.
add	Somma matematica. Restituisce il risultato dall'aggiunta di due numeri (maiuscolo puro) o dalla concatenazione di due o più stringhe.
div	Divisione matematica. Restituisce il risultato intero della divisione di due numeri.
max	Restituisce il valore più grande di una raccolta.
min	Restituisce il valore più piccolo di una raccolta.
mod	Restituisce il resto della divisione di due numeri.
mul	Moltiplicazione matematica. Restituisce il prodotto della moltiplicazione di due numeri.
rand	Restituisce un numero casuale compreso tra i valori minimo e massimo specificati.
sqrt	Restituisce la radice quadrata di un numero specificato.
sub	Sottrazione matematica. Restituisce il risultato della sottrazione del secondo numero dal primo.
sum	Restituisce la somma dei numeri in una matrice.
range	Restituisce una matrice di valori interi che inizia da un valore intero specificato.
exp	Restituisce l'elevamento a potenza di un numero a un altro.
average	Restituisce il valore medio di una matrice numerica.
floor	Restituisce il valore integrale più grande minore o uguale al numero specificato.
Soffitto	Restituisce il valore integrale più piccolo maggiore o uguale al numero specificato.
round	Arrotondare un valore all'intero più vicino o al numero specificato di cifre frazionarie.

Funzioni di data e ora

Funzione	Spiegazione
addDays	Aggiungere un numero di giorni specificati a un timestamp specificato in un formato di impostazioni locali facoltativo.
addHours	Aggiungere un numero specificato di ore a un timestamp specificato in un formato di impostazioni locali facoltativo.
addMinutes	Aggiungere un numero specificato di minuti a un timestamp specificato in un formato di impostazioni locali facoltativo.
addSeconds	Aggiunge un numero specificato di secondi a un timestamp specifico.
dayOfMonth	Restituisce il giorno del mese per un timestamp o un'espressione Timex specifica.
dayOfWeek	Restituisce il giorno della settimana per un timestamp specifico.
dayOfYear	Restituisce il giorno dell'anno per un timestamp specifico.
formatDateTime	Restituisce un timestamp in un formato di impostazioni locali facoltativo.
formatEpoch	Restituisce un timestamp in un formato di impostazioni locali facoltativo dall'ora unix (ora UNIX, ora POSIX).
formatTicks	Restituisce un timestamp in un formato delle impostazioni locali facoltativo dai tick.
subtractFromTime	Sottrarre un numero di unità di tempo da un timestamp in un formato di impostazioni locali facoltativo.
utcNow	Restituisce il timestamp corrente in un formato di impostazioni locali facoltativo come stringa.
dateReadBack	Usa la libreria di funzioni data-ora per consentire il read-back di una data.
month	Restituisce il mese per il timestamp specificato.
date	Restituisce la data per il timestamp specificato.
year	Restituisce l'anno per il timestamp specificato.
getTimeOfDay	Restituisce l'ora del giorno per un timestamp specificato.
getFutureTime	Restituisce il timestamp corrente in un formato delle impostazioni locali facoltativo più le unità di tempo specificate.
getPastTime	Restituisce il timestamp corrente in un formato di impostazioni locali facoltativo meno le unità di tempo specificate.
addToTime	Aggiungere un numero di unità di tempo a un timestamp in un formato di impostazioni locali facoltativo.
convertFromUTC	Convertire un timestamp in un formato di impostazioni locali facoltativo da Utc (Universal Time Coordinated).
convertToUTC	Convertire un timestamp in un formato di impostazioni locali facoltativo in UTC (Universal Time Coordinated).
startOfDay	Restituisce l'inizio del giorno per un timestamp in un formato delle impostazioni locali facoltativo.
startOfHour	Restituisce l'inizio dell'ora per un timestamp in un formato di impostazioni locali facoltativo.
startOfMonth	Restituisce l'inizio del mese per un timestamp in un formato delle impostazioni locali facoltativo.
ticks	Restituisce il valore della proprietà ticks di un timestamp specificato.
ticksToDays	Convertire un valore della proprietà ticks nel numero di giorni.
ticksToHours	Convertire un valore della proprietà ticks nel numero di ore.
ticksToMinutes	Convertire un valore della proprietà ticks nel numero di minuti.
dateTimeDiff	Restituisce la differenza tra due timestamp.
getPreviousViableDate	Restituisce la data valida precedente di un'espressione Timex in base alla data corrente e a un fuso orario facoltativamente specificato.
getNextViableDate	Restituisce la data valida successiva di un'espressione Timex in base alla data corrente e a un fuso orario facoltativamente specificato.
getPreviousViableTime	Restituisce l'ora valida precedente di un'espressione Timex in base all'ora corrente e a un fuso orario specificato facoltativamente.
getNextViableTime	Restituisce l'ora valida successiva di un'espressione Timex in base all'ora corrente e a un fuso orario specificato facoltativamente.

Funzioni Timex

Funzione	Spiegazione
isPresent	Restituisce true se l'espressione TimexProperty o Timex si riferisce al presente.
isDuration	Restituisce true se l'espressione TimexProperty o Timex si riferisce a una durata.
isTime	Restituisce true se l'espressione TimexProperty o Timex si riferisce a un'ora.
isDate	Restituisce true se l'espressione TimexProperty o Timex si riferisce a una data.
isTimeRange	Restituisce true se l'espressione TimexProperty o Timex si riferisce a un intervallo di tempo.
isDateRange	Restituisce true se l'espressione TimexProperty o Timex si riferisce a un intervallo di date.
isDefinite	Restituisce true se l'espressione TimexProperty o Timex si riferisce a un giorno definito.
Risolvere	Restituisce una stringa di un'espressione TimexProperty o Timex specificata se fa riferimento a un'ora valida. Il tempo valido contiene ore, minuti e secondi.

Funzioni di analisi URI

Funzione	Spiegazione
uriHost	Restituisce il valore relativo all'host di un URI (Uniform Resource Identifier).
uriPath	Restituisce il valore del percorso di un URI (Uniform Resource Identifier).
uriPathAndQuery	Restituisce i valori relativi a percorso e query per un URI (Uniform Resource Identifier).
uriPort	Restituisce il valore relativo alla porta di un URI (Uniform Resource Identifier).
uriQuery	Retur0sn il valore della query di un URI (Uniform Resource Identifier).
uriScheme	Restituisce il valore relativo allo schema di un URI (Uniform Resource Identifier).

Funzioni di manipolazione e costruzione di oggetti

Funzione	Spiegazione
addProperty	Aggiunge una proprietà e il suo valore, o una coppia nome-valore, a un oggetto JSON e restituisce l'oggetto aggiornato.
removeProperty	Rimuove una proprietà da un oggetto JSON e restituisce l'oggetto aggiornato.
setProperty	Imposta il valore di una proprietà di un oggetto JSON e restituisce l'oggetto aggiornato.
getProperty	Restituisce il valore di una proprietà o di una proprietà radice specificata da un oggetto JSON.
coalesce	Restituisce il primo valore non Null da uno o più parametri.
xPath	Verifica nel codice XML la presenza di nodi o valori che corrispondono a un'espressione XPath (XML Path Language) e restituisce i nodi o i valori corrispondenti.
jPath	Controlla all'interno di codice JSON o di una stringa JSON la presenza di nodi o di un valore corrispondente a un'espressione di percorso e restituisce i nodi corrispondenti.
setPathToValue	Imposta il valore di un percorso specifico e restituisce il valore.

Funzioni per le espressioni regolari

Funzione	Spiegazione
isMatch	Restituisce true se una stringa corrisponde a un modello regex comune.

Funzioni di controllo del tipo

Funzione	Spiegazione
EOL	Restituisce il testo della sequenza di fine riga (EOL).
isInteger	Restituisce true se l'input specificato è un numero intero
isFloat	Restituisce true se l'input specificato è un numero a virgola mobile
isBoolean	Restituisce true se l'input specificato è un valore booleano.
isArray	Restituisce true se l'input specificato è una matrice.
isObject	Restituisce true se l'input specificato è un oggetto.
isDateTime	Restituisce true se l'input specificato è un timestamp in formato ISO UTC.
isString	Restituisce true se l'input specificato è una stringa.

Funzioni predefinite ordinate alfabeticamente

abs

Restituisce il valore assoluto del numero specificato.

abs(<number>)

Parametro	Obbligatorio	Type	Descrizione
<number>	Sì	number	Numero per ottenere il valore assoluto di

Valore restituito	Tipo	Descrizione
<result>	number	Risultato del calcolo del valore assoluto.

Esempi

Questi esempi calcolano il valore assoluto:

abs(3.12134)
abs(-3.12134)

Entrambi restituiscono il risultato 3.12134.

add (aggiungi)

Restituisce il risultato dall'aggiunta di due o più numeri (numero puro) o dalla concatenazione di due o più stringhe (altro caso).

add(<item1>, <item2>, ...)

Parametro	Obbligatorio	Type	Descrizione
<item1>, <item2>,...	Sì	qualsiasi	articoli

Valore restituito	Tipo	Descrizione
<result-sum>	numero o stringa	Risultato della somma dei numeri specificati o della concatenazione.

Esempio

Questo esempio somma i numeri specificati:

add(1, 1.5)

E restituisce il risultato 2.5.

In questo esempio vengono concatenati gli elementi specificati:

add('hello',null)
add('hello','world')

E vengono restituiti i risultati

• hello
• helloworld

addDays

Aggiungere un numero di giorni a un timestamp in un formato di impostazioni locali facoltativo.

addDays('<timestamp>', <days>, '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa che contiene il timestamp che deve essere nel formato ISO UTC standard YYYY-MM-DDTHH:mm:ss.fffZ
<days>	Sì	integer	Numero positivo o negativo di giorni da aggiungere
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<updated-timestamp>	string	Timestamp con l'aggiunta del numero di giorni specificato

Esempio 1

In questo esempio vengono aggiunti 10 giorni al timestamp specificato:

addDays('2018-03-15T13:00:00.000Z', 10)

E restituisce il risultato 2018-03-25T00:00:00.000Z.

Esempio 2

Questo esempio sottrae cinque giorni dal timestamp specificato:

addDays('2018-03-15T00:00:00.000Z', -5)

E restituisce il risultato 2018-03-10T00:00:00.000Z.

Esempio 3

Questo esempio aggiunge 1 giorno al timestamp specificato nelle impostazioni locali de-DE :

addDays('2018-03-15T13:00:00.000Z', 1, '', 'de-dE')

E restituisce il risultato 16.03.18 13:00:00.

addHours

Aggiungere un numero di ore a un timestamp in un formato di impostazioni locali facoltativo.

addHours('<timestamp>', <hours>, '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp
<hours>	Sì	integer	Numero positivo o negativo di ore da aggiungere
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<updated-timestamp>	string	Timestamp con l'aggiunta del numero di ore specificato

Esempio 1

In questo esempio vengono aggiunte 10 ore al timestamp specificato:

addHours('2018-03-15T00:00:00.000Z', 10)

E restituisce il risultato 2018-03-15T10:00:00.000Z.

Esempio 2

Questo esempio sottrae cinque ore dal timestamp specificato:

addHours('2018-03-15T15:00:00.000Z', -5)

E restituisce il risultato 2018-03-15T10:00:00.000Z.

Esempio 3

In questo esempio vengono aggiunte 2 ore al timestamp specificato nelle impostazioni locali de-DE :

addHours('2018-03-15T13:00:00.000Z', 2, '', 'de-DE')

E restituisce il risultato 15.03.18 15:00:00.

addMinutes

Aggiungere un numero di minuti a un timestamp in un formato di impostazioni locali facoltativo.

addMinutes('<timestamp>', <minutes>, '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp
<minutes>	Sì	integer	Numero positivo o negativo di minuti da aggiungere
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<updated-timestamp>	string	Timestamp con l'aggiunta del numero di minuti specificato

Esempio 1

Questo esempio aggiunge 10 minuti al timestamp specificato:

addMinutes('2018-03-15T00:10:00.000Z', 10)

E restituisce il risultato 2018-03-15T00:20:00.000Z.

Esempio 2

Questo esempio sottrae cinque minuti dal timestamp specificato:

addMinutes('2018-03-15T00:20:00.000Z', -5)

E restituisce il risultato 2018-03-15T00:15:00.000Z.

Esempio 3

In questo esempio vengono aggiunti 30 minuti al timestamp specificato nelle impostazioni locali de-DE :

addMinutes('2018-03-15T00:00:00.000Z', 30, '', 'de-DE')

E restituisce il risultato 15.03.18 13:30:00.

addOrdinal

Restituisce il numero ordinale del numero di input.

addOrdinal(<number>)

Parametro	Obbligatorio	Type	Descrizione
<number>	Sì	integer	Numeri da convertire in un numero ordinale

Valore restituito	Tipo	Descrizione
<result>	string	Numero ordinale convertito dal numero di input

Esempio

addOrdinal(11)
addOrdinal(12)
addOrdinal(13)
addOrdinal(21)
addOrdinal(22)
addOrdinal(23)

E restituiscono rispettivamente i risultati seguenti:

• 11°
• 12°
• 13°
• 21°
• 22°
• 23°

addProperty

Aggiunge una proprietà e il suo valore o una coppia nome-valore a un oggetto JSON e restituisce l'oggetto aggiornato. Se l'oggetto esiste già in runtime, la funzione genera un errore.

addProperty('<object>', '<property>', value)

Parametro	Obbligatorio	Type	Descrizione
<object>	Sì	oggetto	Oggetto JSON a cui si vuole aggiungere una proprietà
<property>	Sì	string	Nome della proprietà da aggiungere
<value>	Sì	qualsiasi	Valore della proprietà

Valore restituito	Tipo	Descrizione
<updated-object>	oggetto	Oggetto JSON aggiornato dopo l'aggiunta di una nuova proprietà

Esempio

Questo esempio aggiunge la proprietà accountNumber all'oggetto customerProfile, che viene convertito nel formato JSON con la funzione json(). La funzione assegna un valore generato dalla funzione newGuid() e restituisce l'oggetto aggiornato:

addProperty(json('customerProfile'), 'accountNumber', newGuid())

addSeconds

Aggiunge un numero di secondi a un timestamp.

addSeconds('<timestamp>', <seconds>, '<format>'?)

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp
<seconds>	Sì	integer	Numero positivo o negativo di secondi da aggiungere
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	string	Timestamp con l'aggiunta del numero di secondi specificato

Esempio 1

Questo esempio aggiunge 10 secondi al timestamp specificato:

addSeconds('2018-03-15T00:00:00.000Z', 10)

E restituisce il risultato 2018-03-15T00:00:10.000Z.

Esempio 2

Questo esempio sottrae cinque secondi dal timestamp specificato:

addSeconds('2018-03-15T00:00:30.000Z', -5)

E restituisce il risultato 2018-03-15T00:00:25.000Z.

addToTime

Aggiungere un numero di unità di tempo a un timestamp in un formato di impostazioni locali facoltativo. Vedere anche getFutureTime().

addToTime('<timestamp>', '<interval>', <timeUnit>, '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp
<interval>	Sì	integer	Numero di unità di tempo specificate da aggiungere
<timeUnit>	Sì	string	Unità di tempo da usare con interval. Le unità possibili sono "Second", "Minute", "Hour", "Day", "Week", "Month" e "Year".
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<updated-timestamp>	string	Timestamp più il numero di unità di tempo specificate con il formato indicato.

Esempio 1

Questo esempio aggiunge un giorno al timestamp specificato.

addToTime('2018-01-01T00:00:00.000Z', 1, 'Day')

E restituisce il risultato 2018-01-02T00:00:00.000Z.

Esempio 2

Questo esempio aggiunge due settimane al timestamp specificato.

addToTime('2018-01-01T00:00:00.000Z', 2, 'Week', 'MM-DD-YY')

E restituisce il risultato nel formato 'MM-DD-YY' come 01-15-18.

tutto

Determinare se tutti gli elementi di una sequenza soddisfano una condizione.

all(<sequence>, <item>, <condition>)

Parametro	Obbligatorio	Type	Descrizione
<Sequenza>	Sì	oggetto	Sequenza da valutare.
<item>	Sì	string	Fa riferimento agli elementi da valutare nella sequenza.
<condition>	Sì	expression	Espressione da valutare la condizione.

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se tutti gli elementi soddisfano una condizione. Restituisce false se almeno uno non lo fa.

Esempi

Questi esempi determinano se tutti gli elementi di una sequenza soddisfano una condizione:

all(createArray(1, 'cool'), item, isInteger(item))
all(createArray(1, 2), item => isInteger(item))

E restituiscono rispettivamente i risultati seguenti:

• false, perché entrambi gli elementi nella sequenza non sono numeri interi.
• true, perché entrambi gli elementi della sequenza sono numeri interi.

e

Verifica se tutte le espressioni sono true. Restituisce true se tutte le espressioni sono true o false se almeno un'espressione è false.

and(<expression1>, <expression2>, ...)

Parametro	Obbligatorio	Type	Descrizione
<expression1>, <expression2>, ...	Sì	Booleano	Espressioni da verificare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se tutte le espressioni sono true. Restituisce false se almeno un'espressione è false.

Esempio 1

Questi esempi verificano se i valori booleani specificati sono tutti true:

and(true, true)
and(false, true)
and(false, false)

E restituiscono rispettivamente i risultati seguenti:

• Entrambe le espressioni sono true, quindi la funzione restituisce true.
• Un'espressione è false, quindi la funzione restituisce false.
• entrambe le espressioni sono false, quindi la funzione restituisce false.

Esempio 2

Questi esempi verificano se le espressioni specificate sono tutte true:

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

E restituiscono rispettivamente i risultati seguenti:

• Entrambe le espressioni sono true, quindi la funzione restituisce true.
• Un'espressione è false, quindi la funzione restituisce false.
• Entrambe le espressioni sono false, quindi la funzione restituisce false.

qualsiasi

Determinare se gli elementi di una sequenza soddisfano una condizione.

all(<sequence>, <item>, <condition>)

Parametro	Obbligatorio	Type	Descrizione
<Sequenza>	Sì	oggetto	Sequenza da valutare.
<item>	Sì	string	Fa riferimento agli elementi da valutare nella sequenza.
<condition>	Sì	expression	Espressione da valutare la condizione.

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se tutti gli elementi soddisfano la condizione. Restituisce false se almeno uno non lo fa.

Esempi

Questi esempi determinano se tutti gli elementi di una sequenza soddisfano una condizione:

any(createArray(1, 'cool'), item, isInteger(item))
any(createArray('first', 'cool'), item => isInteger(item))

E restituiscono rispettivamente i risultati seguenti:

• true, perché almeno un elemento nella sequenza è un numero intero
• false, perché nessun elemento nella sequenza è un numero intero.

average

Restituisce la media dei numeri di una matrice numerica.

average(<numericArray>)

Parametro	Obbligatorio	Type	Descrizione
<numericArray>	Sì	matrice di valori numero	Matrice di input per il calcolo della media

Valore restituito	Tipo	Descrizione
<average-of-array>	number	Valore medio della matrice specificata

Esempio

Questo esempio calcola la media della matrice in createArray():

average(createArray(1,2,3))

E restituisce il risultato 2.

base64

Restituisce la versione con codifica base64 di una matrice di stringhe o di byte.

base64('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	matrice di stringhe o di byte	Stringa di input

Valore restituito	Tipo	Descrizione
<base64-string>	string	Versione con codifica base64 della stringa di input

Esempio 1

Questo esempio converte la stringa hello in una stringa con codifica base64:

base64('hello')

E restituisce il risultato "aGVsbG8=".

Esempio 2

Questo esempio accetta byteArr, che è uguale a new byte[] { 3, 5, 1, 12 }:

base64('byteArr')

E restituisce il risultato "AwUBDA==".

base64ToBinary

Restituisce la matrice binaria di una stringa con codifica base64.

base64ToBinary('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	string	Stringa con codifica base64 da convertire

Valore restituito	Tipo	Descrizione
<binary-for-base64-string>	matrice di byte	Versione binaria della stringa con codifica base64

Esempio

Questo esempio converte la stringa con codifica base64 AwUBDA== in una stringa binaria:

base64ToBinary('AwUBDA==')

E restituisce il risultato new byte[] { 3, 5, 1, 12 }.

base64ToString

Restituisce la versione stringa di una stringa con codifica base64, decodificando in modo efficace la stringa base64.

base64ToString('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	string	Stringa con codifica base64 da decodificare

Valore restituito	Tipo	Descrizione
<decoded-base64-string>	string	Versione stringa di una stringa con codifica base64

Esempio

Questo esempio converte la stringa con codifica base64 aGVsbG8= in una stringa decodificata:

base64ToString('aGVsbG8=')

E restituisce il risultato hello.

binary

Restituisce la versione binaria di una stringa.

binary('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	string	Stringa da convertire

Valore restituito	Tipo	Descrizione
<binary-for-input-value>	matrice di byte	Versione binaria della stringa specificata

Esempio

Questo esempio converte la stringa hello in una stringa binaria:

binary('hello')

E restituisce il risultato new byte[] { 104, 101, 108, 108, 111 }.

bool

Restituisce la versione booleana di un valore.

bool(<value>)

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	qualsiasi	Valore da convertire

Valore restituito	Tipo	Descrizione
true o false	Booleano	Versione booleana del valore specificato

Esempio

Questi esempi convertono i valori specificati in valori booleani:

bool(1)
bool(0)

E restituiscono rispettivamente i risultati seguenti:

• true
• false

ceiling

Restituisce il valore integrale più grande minore o uguale al numero specificato.

ceiling('<number>')

Parametro	Obbligatorio	Type	Descrizione
<number>	Sì	number	Numero di input

Valore restituito	Tipo	Descrizione
<integer-value>	integer	Valore integrale più grande maggiore o uguale al numero di input

Esempio

In questo esempio viene restituito il valore integrale più grande minore o uguale al numero 10,333:

ceiling(10.333)

E restituisce l'intero 11.

coalesce

Restituisce il primo valore non Null da uno o più parametri. Stringhe vuote, matrici vuote e oggetti vuoti sono non null.

coalesce(<object**1>, <object**2>, ...)

Parametro	Obbligatorio	Type	Descrizione
<object**1>, <object**2>, ...	Sì	qualsiasi (tipi misti accettabili)	Uno o più elementi da verificare per determinare se sono Null

Valore restituito	Tipo	Descrizione
<first-non-null-item>	qualsiasi	Primo elemento o valore che non è Null. Se tutti i parametri sono Null, questa funzione restituisce Null.

Esempio

Questi esempi restituiscono il primo valore non Null dai valori specificati oppure Null quando tutti i valori sono Null:

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

E rispettivamente restituiscono:

• true
• hello
• Null

concat

Combinare due o più oggetti e restituire gli oggetti combinati in un elenco o in una stringa.

concat('<text1>', '<text2>', ...)

Parametro	Obbligatorio	Type	Descrizione
<object1>, <object2>, ...	Sì	qualsiasi	Almeno due oggetti da concat.

Valore restituito	Tipo	Descrizione
<object1object2...>	stringa o elenco	Stringa o elenco combinati. I valori Null vengono ignorati.

Valori restituiti previsti:

• Se tutti gli elementi sono elenchi, verrà restituito un elenco.
• Se esiste un elemento che non è un elenco, verrà restituita una stringa.
• Se un valore è Null, viene ignorato e non concatenato.

Esempio

Questo esempio combina le stringhe Hello e World:

concat('Hello', 'World')

E restituisce il risultato HelloWorld.

Esempio 2

Questo esempio combina gli elenchi [1,2] e [3,4]:

concat([1,2],[3,4])

E restituisce il risultato [1,2,3,4].

Esempio 3

Questi esempi combinano oggetti di tipi diversi:

concat('a', 'b', 1, 2)
concat('a', [1,2])

E restituiscono rispettivamente i risultati seguenti:

• Stringa ab12.
• Oggetto aSystem.Collections.Generic.List 1[System.Object]. Questo è illeggibile e migliore da evitare.

Esempio 4

Questi esempi combinano oggetti null:

concat([1,2], null)
concat('a', 1, null)

E restituiscono rispettivamente i risultati seguenti:

• Elenco [1,2].
• Stringa a1.

contains

Verifica se una raccolta include un elemento specifico. Restituisce true se l'elemento viene trovato; in caso contrario, restituisce false. Questa funzione fa distinzione tra maiuscole e minuscole.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

Questa funzione può essere usata con i tipi di raccolta seguenti:

• Una stringa per trovare una sottostringa
• Una matrice per trovare un valore
• Un dizionario per trovare una chiave

Parametro	Obbligatorio	Type	Descrizione
<collection>	Sì	string, array o dictionary	Raccolta da verificare
<value>	Sì	string, array o dictionary, rispettivamente	Elemento da trovare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se l'elemento viene trovato. Restituisce false se non viene trovato.

Esempio 1

Questo esempio controlla nella stringa hello world la presenza della sottostringa world:

contains('hello world', 'world')

E restituisce il risultato true.

Esempio 2

Questo esempio controlla nella stringa hello world la presenza della sottostringa universe:

contains('hello world', 'universe')

E restituisce il risultato false.

numero

Restituisce il numero di elementi in una raccolta.

count('<collection>')
count([<collection>])

Parametro	Obbligatorio	Type	Descrizione
<collection>	Sì	Stringa o matrice	Raccolta con gli elementi da contare

Valore restituito	Tipo	Descrizione
<length-or-count>	integer	Numero di elementi nella raccolta

Esempi:

Questi esempi contano il numero di elementi in queste raccolte:

count('abcd')
count(createArray(0, 1, 2, 3))

Ed entrambi restituiscono il risultato 4.

countWord

Restituisce il numero di parole in una stringa

countWord('<text>')

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	string	Stringa da contare

Valore restituito	Tipo	Descrizione
<count>	integer	Numero di parole nella stringa

Esempio

Questo esempio conta il numero di parole nella stringa hello world:

countWord("hello word")

E restituisce il risultato 2.

convertFromUTC

Convertire un timestamp in un formato di impostazioni locali facoltativo da Utc (Universal Time Coordinated) a un fuso orario di destinazione.

convertFromUTC('<timestamp>', '<destinationTimeZone>', '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp
<destinationTimeZone>	Sì	string	Nome del fuso orario di destinazione. Supporta i fusi orari di Windows e IANA.
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato "o", aaaaa-MM-ggTHH:mm:ss.fffffffK, conforme a ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<converted-timestamp>	string	Timestamp convertito nel fuso orario di destinazione

Esempi:

Questi esempi eseguono la conversione da UTC al fuso orario Ora solare Pacifico:

convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time', 'MM-DD-YY')
convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time')

E restituiscono rispettivamente i risultati seguenti:

• 02-01-18
• 2018-01-01T18:00:00.00000000

Esempio 2

Questo esempio converte un timestamp nelle impostazioni locali en-US da UTC a Pacific Standard Time:

convertFromUTC('2018-01-02T02:00:00.000Z', 'Pacific Standard Time', 'D', 'en-US')

E restituisce il risultato lunedì 1 gennaio 2018.

convertToUTC

Convertire un timestamp in un formato di impostazioni locali facoltativo in Utc (Universal Time Coordinated) dal fuso orario di origine.

convertToUTC('<timestamp>', '<sourceTimeZone>', '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp
<sourceTimeZone>	Sì	string	Nome del fuso orario di destinazione. Supporta i fusi orari di Windows e IANA.
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<converted-timestamp>	string	Timestamp convertito nel fuso orario di destinazione

Esempio

In questo esempio viene convertito un timestamp in utc dall'ora solare del Pacifico

convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time')

E restituisce il risultato 2018-01-01T08:00:00.000Z.

Esempio 2

In questo esempio viene convertito un timestamp nelle impostazioni locali de-DE in formato UTC dall'ora solare del Pacifico:

convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time', '', 'de-DE')

E restituisce il risultato 01.01.18 08:00:00.

createArray

Restituisce una matrice da più input.

createArray('<object1>', '<object2>', ...)

Parametro	Obbligatorio	Type	Descrizione
<object1>, <object2>, ...	Sì	qualsiasi, ma non sono possibili combinazioni di tipi	Almeno due elementi per creare la matrice

Valore restituito	Tipo	Descrizione
[<object1>, <object2>, ...]	array	Matrice creata da tutti gli elementi di input

Esempio

Questo esempio crea una matrice dagli input seguenti:

createArray('h', 'e', 'l', 'l', 'o')

E restituisce il risultato [h ,e, l, l, o].

dataUri

Restituisce un URI (Uniform Resource Identifier) dati di una stringa.

dataUri('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	string	Stringa da convertire

Valore restituito	Tipo	Descrizione
[<date-uri>]	string	URI di dati per la stringa di input

Esempio

dataUri('hello')

Restituisce il risultato data:text/plain;charset=utf-8;base64,aGVsbG8=.

dataUriToBinary

Restituisce la versione binaria di un URI (Uniform Resource Identifier) di dati.

dataUriToBinary('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	string	URI di dati da convertire

Valore restituito	Tipo	Descrizione
[<binary-for-data-uri>]	matrice di byte	Versione binaria dell'URI di dati

Esempio

Questo esempio crea una versione binaria dell'URI di dati seguente:

dataUriToBinary('aGVsbG8=')

E restituisce il risultato new byte[] { 97, 71, 86, 115, 98, 71, 56, 61 }.

dataUriToString

Restituisce la versione stringa di un URI (Uniform Resource Identifier) di dati.

dataUriToString('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	string	URI di dati da convertire

Valore restituito	Tipo	Descrizione
[<string-for-data-uri>]	string	Versione stringa dell'URI di dati

Esempio

Questo esempio crea una stringa dall'URI di dati seguente:

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

E restituisce il risultato hello.

data

Restituisce la data di un timestamp specificato nel formato m/dd/yyyy.

date('<timestramp>')

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp

Valore restituito	Tipo	Descrizione
<date>	string	Data del timestamp specificato

date('2018-03-15T13:00:00.000Z')

Restituisce il risultato 3-15-2018.

dateReadBack

Usa la libreria di funzioni data-ora per consentire il read-back di una data.

dateReadBack('<currentDate>', '<targetDate>')

Parametro	Obbligatorio	Type	Descrizione
<currentDate>	Sì	string	Stringa contenente la data corrente
<targetDate>	Sì	string	Stringa contenente la data di destinazione

Valore restituito	Tipo	Descrizione
<date-readback>	string	Read-back tra la data corrente e la data di destinazione

Esempio 1

dateReadBack('2018-03-15T13:00:00.000Z', '2018-03-16T13:00:00.000Z')

Restituisce il risultato tomorrow.

dateTimeDiff

Restituisce la differenza tra due timestamp.

dateTimeDiff('<timestamp1>', '<timestamp2>')

Parametro	Obbligatorio	Type	Descrizione
<timestamp1>	Sì	string	La prima stringa di timestamp da confrontare
<timestamp2>	Sì	string	Seconda stringa di timestamp da confrontare

Valore restituito	Tipo	Descrizione
<ticks>	number	Differenza nei tick tra due timestamp

Esempio 1

In questo esempio viene restituita la differenza tra due timestamp:

dateTimeDiff('2019-01-01T08:00:00.000Z','2018-01-01T08:00:00.000Z')

E restituisce il numero 315360000000000.

Esempio 2

In questo esempio viene restituita la differenza tra due timestamp:

dateTimeDiff('2018-01-01T08:00:00.000Z', '2019-01-01T08:00:00.000Z')

Restituisce il risultato -315360000000000. Il valore è un numero negativo.

dayOfMonth

Restituisce il giorno del mese da un timestamp.

dayOfMonth('<timestamp>')

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp

Valore restituito	Tipo	Descrizione
<day-of-month>	integer	Giorno del mese dal timestamp specificato

Esempio

Questo esempio restituisce il numero del giorno del mese dal timestamp seguente:

dayOfMonth('2018-03-15T13:27:36Z')

E restituisce il risultato 15.

dayOfWeek

Restituisce il giorno della settimana da un timestamp.

dayOfWeek('<timestamp>')

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp

Valore restituito	Tipo	Descrizione
<day-of-week>	integer	Giorno della settimana dal timestamp specificato. La domenica corrisponde a 0, lunedì a 1 e così via.

Esempio

Questo esempio restituisce il numero del giorno della settimana dal timestamp seguente:

dayOfWeek('2018-03-15T13:27:36Z')

E restituisce il risultato 3.

dayOfYear

Restituisce il giorno dell'anno da un timestamp.

dayOfYear('<timestamp>')

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp

Valore restituito	Tipo	Descrizione
<day-of-year>	integer	Giorno dell'anno dal timestamp specificato

Esempio

Questo esempio restituisce il numero del giorno dell'anno dal timestamp seguente:

dayOfYear('2018-03-15T13:27:36Z')

E restituisce il risultato 74.

div

Restituisce il risultato intero della divisione di due numeri. Per ottenere il resto, vedere mod().

div(<dividend>, <divisor>)

Parametro	Obbligatorio	Type	Descrizione
<dividend>	Sì	number	Numero da dividere per l'oggetto divisor
<divisor>	Sì	number	Numero che divide l'oggetto dividend. Non può essere 0.

Valore restituito	Tipo	Descrizione
<quotient-result>	number	Risultato della divisione del primo numero per il secondo numero

Esempio

Entrambi gli esempi dividono il primo numero per il secondo numero:

div(10, 5)
div(11, 5)

E restituisce il risultato 2.

Esiste un divario tra Javascript e .NET SDK. Ad esempio, l'espressione seguente restituirà risultati diversi in Javascript e .NET SDK:

Se uno dei parametri è float, il risultato sarà anche float con .NET SDK.

Esempio

div(11.2, 2)

Restituisce il risultato 5.6.

Se uno dei parametri è float, il risultato sarà un INT con Javascript SDK.

Esempio

div(11.2, 2)

Restituisce il risultato 5.

La soluzione alternativa per Javascript per mantenere un determinato numero di posizioni decimali nei risultati consiste nell'usare tale espressione. Ad esempio, per mantenere 3 posizioni decimali:

float(concat(string(div(a, b)),'.',string(mod(div(a*1000, b), 1000))))

empty

Controlla se un'istanza è vuota. Restituisce true se l'input è vuoto. Per vuoto si intende che:

• l'input è Null o non definito
• l'input è una stringa vuota o Null
• l'input è una raccolta di dimensioni pari a zero
• l'input è un oggetto senza proprietà.

empty('<instance>')
empty([<instance>])

Parametro	Obbligatorio	Type	Descrizione
<instance>	Sì	qualsiasi	Istanza da verificare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se l'istanza è vuota.

Esempio

In questi esempi viene verificato se l'istanza specificata è vuota:

empty('')
empty('abc')
empty([1])
empty(null)

E restituiscono rispettivamente i risultati seguenti:

• passa una stringa vuota, quindi la funzione restituisce true.
• passa la stringa abc, quindi la funzione restituisce false.
• Passa la raccolta con un solo elemento, in modo che la funzione restituisca false.
• Passa l'oggetto Null, di conseguenza la funzione restituisce true.

endsWith

Verifica se una stringa termina con una sottostringa specifica. Restituisce true se la substring viene trovata, in caso contrario restituisce false. La funzione non fa distinzione tra maiuscole e minuscole.

endsWith('<text>', '<searchText>')

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	string	Stringa da verificare
<searchText>	Sì	string	Sottostringa finale da trovare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se la sottostringa finale viene trovata. Restituisce false se non viene trovata

Esempio 1

Questo esempio verifica se la stringa hello world termina con la stringa world:

endsWith('hello world', 'world')

E restituisce il risultato true.

Esempio 2

Questo esempio verifica se la stringa hello world termina con la stringa universe:

endsWith('hello world', 'universe')

E restituisce il risultato false.

EOL

Restituisce il testo della sequenza di fine riga (EOL).

EOL()

Valore restituito	Tipo	Descrizione
<IsOSPlatform>	string	Restituisce \r\n in Windows e \n in Mac e Linux.

Esempio

In questo esempio viene verificata la fine del testo della sequenza di riga:

EOL()

E restituisce le stringhe seguenti:

• Windows: \r\n
• Mac o Linux: \n

uguale a

Verifica se entrambi i valori, le espressioni o gli oggetti sono equivalenti. Restituisce true se entrambi gli elementi sono equivalenti; in caso contrario, restituisce false.

equals('<object1>', '<object2>')

Parametro	Obbligatorio	Type	Descrizione
<object1>, <object2>	Sì	qualsiasi	Valori, espressioni o oggetti da confrontare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se entrambi sono equivalenti. Restituisce false se non sono equivalenti.

Esempio

Questi esempi verificano se gli input specificati sono equivalenti:

equals(true, 1)
equals('abc', 'abcd')

E restituiscono rispettivamente questi risultati:

• entrambi i valori sono equivalenti, quindi la funzione restituisce true.
• entrambi i valori non sono equivalenti, quindi la funzione restituisce false.

esiste

Valuta la veridicità di un'espressione.

exists(expression)

Parametro	Obbligatorio	Type	Descrizione
expression	Sì	expression	Espressione di cui valutare la veridicità

Valore restituito	Tipo	Descrizione
<true o false>	Booleano	Risultato della valutazione dell'espressione

Esempio

Questo esempio valuta la veridicità di foo = {"bar":"value"}:

exists(foo.bar)
exists(foo.bar2)

E restituiscono rispettivamente i risultati seguenti:

• true
• false

exp

Restituisce l'elevamento a potenza di un numero a un altro.

exp(realNumber, exponentNumber)

Parametro	Obbligatorio	Type	Descrizione
realNumber	Sì	number	Numero reale di cui calcolare l'esponente
exponentNumber	Sì	number	Esponente

Valore restituito	Tipo	Descrizione
<result-exp>	number	Risultato del calcolo dell'esponente di realNumber

Esempio

Questo esempio calcola l'esponente:

exp(2, 2)

E restituisce il risultato 4.

primo

Restituisce il primo elemento di una stringa o una matrice.

first('<collection>')
first([<collection>])

Parametro	Obbligatorio	Type	Descrizione
<collection>	Sì	Stringa o matrice	Raccolta in cui trovare il primo elemento

Valore restituito	Tipo	Descrizione
<first-collection-item>	qualsiasi	Primo elemento nella raccolta

Esempio

Questi esempi trovano il primo elemento nelle raccolte seguenti:

first('hello')
first(createArray(0, 1, 2))

E restituiscono rispettivamente i risultati seguenti:

• h
• 0

flatten

Rende flat una matrice in valori non di matrice. Facoltativamente è possibile impostare la profondità massima.

flatten([<collection>], '<depth>')

Parametro	Obbligatorio	Type	Descrizione
<collection>	Sì	array	Raccolta da rendere flat
<depth>	No	number	Profondità massima dell'operazione. Il valore predefinito è infinita.

Valore restituito	Tipo	Descrizione
<new-collection>	array	Nuova raccolta i cui elementi sono stati resi flat in un elemento non matrice alla profondità specificata

Esempio 1

Questo esempio rende flat la matrice seguente:

flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)))

E restituisce il risultato [1, 2, 3, 4, 5, 6].

Esempio 2

Questo esempio rende flat la matrice a una profondità pari a 1:

flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)), 1)

E restituisce il risultato [1, 2, [3, 4], [5, 6]].

float

Converte la versione stringa di un numero a virgola mobile in un numero a virgola mobile. È possibile usare questa funzione solo quando si passano parametri personalizzati a un'app, ad esempio un'app per la logica. Se la stringa non può essere convertita in float, verrà generata un'eccezione.

float('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	string	Stringa con un numero a virgola mobile valido in cui deve essere convertita

Valore restituito	Tipo	Descrizione
<float-value>	float	Numero a virgola mobile della stringa specificata

Esempio

In questo esempio viene convertita la versione float di una stringa:

float('10.333')

E restituisce il float 10.333.

floor

Restituisce il valore integrale più grande minore o uguale al numero specificato.

floor('<number>')

Parametro	Obbligatorio	Type	Descrizione
<number>	Sì	number	Numero di input

Valore restituito	Tipo	Descrizione
<integer-value>	integer	Valore integrale più grande minore o uguale al numero di input

Esempio

In questo esempio viene calcolato il valore floor del numero 10,333:

floor(10.333)

E restituisce l'intero 10.

foreach

Opera su ogni elemento e restituisce la nuova raccolta.

foreach([<collection/instance>], <iteratorName>, <function>)

Parametro	Obbligatorio	Type	Descrizione
<collection/instance>	Sì	matrice o oggetto	Raccolta con gli elementi
<iteratorName>	Sì	nome iteratore	Elemento chiave della funzione arrow
<function>	Sì	expression	Funzione che contiene iteratorName

Valore restituito	Tipo	Descrizione
<new-collection>	array	Nuova raccolta in cui ogni elemento è stato valutato dalla funzione

Esempio 1

Questo esempio genera una nuova raccolta:

foreach(createArray(0, 1, 2, 3), x, x + 1)

E restituisce il risultato [1, 2, 3, 4].

Esempio 2

Questi esempi generano una nuova raccolta:

foreach(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
foreach(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))

E restituiscono il risultato ['name:jack', 'age:15']. Si noti che la seconda espressione è un'espressione lambda, che alcuni trovano più leggibili.

formatDateTime

Restituisce un timestamp in un formato di impostazioni locali facoltativo.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<reformatted-timestamp>	string	Timestamp aggiornato nel formato specificato

Esempio 1

Questo esempio converte un timestamp nel formato specificato:

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

E restituisce il risultato 2018-03-15T12:00:00.

Esempio 2

In questo esempio viene convertito un timestamp nelle impostazioni locali de-DE :

formatDateTime('2018-03-15', '', 'de-DE')

E restituisce il risultato 15.03.18 00:00:00.

formatEpoch

Restituisce un timestamp in un formato delle impostazioni locali facoltativo nel formato specificato dall'ora UNIX (noto anche come ora epoche, ora POSIX, ora unix).

formatEpoch('<epoch>', '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<epoch>	Sì	number	Numero del periodo
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<reformatted-timestamp>	string	Timestamp aggiornato nel formato specificato

Esempio

In questo esempio viene convertito un timestamp Unix nel formato specificato:

formatEpoch(1521118800, 'yyyy-MM-ddTHH:mm:ss.fffZ)'

E restituisce il risultato 2018-03-15T12:00:00.000Z.

Esempio

In questo esempio viene convertito un timestamp Unix nelle impostazioni locali de-DE :

formatEpoch(1521118800, '', 'de-DE')

E restituisce il risultato 15.03.18 13:00:00.

formatNumber

Formattare un valore per il numero specificato di cifre frazionarie e le impostazioni locali facoltative specificate.

formatNumber('<number>', '<precision-digits>', '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<number>	Sì	number	Numero di input
<cifre di precisione>	Sì	integer	Numero specificato di cifre frazionarie
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<return-value>	number	Valore restituito dell'input formattato in corrispondenza di un numero specificato di cifre frazionarie e impostazioni locali specificate

Esempio 1

Questo esempio formatta il numero da 10,333 a 2 cifre frazionarie:

formatNumber(10.333, 2)

E restituisce la stringa 10.33.

Esempio 2

Questi esempi formattano i numeri in base a un numero specificato di cifre nelle impostazioni locali en-US :

formatNumber(12.123, 2, 'en-US')
formatNumber(1.551, 2, 'en-US')
formatNumber(12.123, 4, 'en-US')

E restituiscono rispettivamente i risultati seguenti:

• 12.12
• 1.55
• 12.1230

formatTicks

Restituisce un timestamp in un formato delle impostazioni locali facoltativo nel formato specificato dai segni di graduazione.

formatTicks('<ticks>', '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<epoch>	Sì	numero (o bigint in JavaScript)	Numero di tick
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<reformatted-timestamp>	string	Timestamp aggiornato nel formato specificato

Esempio 1

Questo esempio converte i tick nel formato specificato:

formatTicks(637243624200000000, 'yyyy-MM-ddTHH:mm:ss.fffZ')

E restituisce il risultato 2020-05-06T11:47:00.000 Z.

Esempio 2

Questo esempio converte i tick nel formato specificato nelle impostazioni locali de-DE :

formatTicks(637243624200000000, '', 'de-DE')

E restituisce il risultato 06.05.20 11:47:00.

getFutureTime

Restituisce il timestamp corrente in un formato delle impostazioni locali facoltativo più le unità di tempo specificate.

getFutureTime(<interval>, <timeUnit>, '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<interval>	Sì	integer	Numero di unità di tempo specifiche da aggiungere
<timeUnit>	Sì	string	Unità di tempo da usare con interval. Le unità possibili sono "Second", "Minute", "Hour", "Day", "Week", "Month" e "Year".
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<updated-timestamp>	string	Timestamp corrente con l'aggiunta del numero di unità di tempo specificato

Esempio 1

Si supponga che il timestamp corrente sia 2019-03-01T00:00:00.000Z. L'esempio riportato di seguito aggiunge cinque giorni al timestamp:

getFutureTime(2, 'Week')

E restituisce il risultato 2019-03-15T00:00:00.000Z.

Esempio 2

Si supponga che il timestamp corrente sia 2018-03-01T00:00:00.000Z. L'esempio riportato di seguito aggiunge cinque giorni al timestamp e converte il risultato nel formato MM-DD-YY:

getFutureTime(5, 'Day', 'MM-DD-YY')

E restituisce il risultato 03-06-18.

Esempio 3

Si supponga che il timestamp corrente sia 2020-05-01T00:00:00.000Z e che le impostazioni locali siano de-DE. L'esempio seguente aggiunge 1 giorno al timestamp:

getFutureTime(1,'Day', '', 'de-DE')

E restituisce il risultato 02.05.20 00:00:00.

getNextViableDate

Restituisce la data valida successiva di un'espressione Timex in base alla data corrente e a un fuso orario facoltativamente specificato.

getNextViableDate(<timexString>, <timezone>?)

Parametro	Obbligatorio	Type	Descrizione
<timexString>	Sì	string	Stringa Timex della data da valutare.
<timezone>	No	string	Fuso orario facoltativo.

Valore restituito	Tipo	Descrizione
<nextViableTime>	string	Data valida successiva.

Esempi

Si supponga che la data sia 2020-06-12 e l'ora corrente sia 15:42:21.

Questi esempi valutano la stringa Timex per la data valida successiva in base alla data e all'ora precedenti:

getPreviousViableDate("XXXX-12-20", "America/Los_Angeles")
getPreviousViableDate("XXXX-02-29")

E restituiscono le stringhe seguenti rispettivamente:

• 2020-12-20
• 2024-02-29

getNextViableTime

Restituisce l'ora valida successiva di un'espressione Timex in base all'ora corrente e a un fuso orario specificato facoltativamente.

getNextViableTime(<timexString>, <timezone>?)

Parametro	Obbligatorio	Type	Descrizione
<timexString>	Sì	string	Stringa Timex del tempo da valutare.
<timezone>	No	string	Fuso orario facoltativo.

Valore restituito	Tipo	Descrizione
<nextViableTime>	string	La prossima ora valida.

Esempi

Si supponga che la data sia 2020-06-12 e l'ora corrente sia 15:42:21.

Questi esempi valutano una stringa Timex per l'ora valida successiva in base alla data e all'ora precedenti:

getNextViableTime("TXX:12:14", "Asia/Tokyo")
getNextViableTime("TXX:52:14")

E restituiscono le stringhe seguenti rispettivamente:

• T16:12:14
• T15:52:14

getPastTime

Restituisce il timestamp corrente meno le unità di tempo specificate.

getPastTime(<interval>, <timeUnit>, '<format>'?)

Parametro	Obbligatorio	Type	Descrizione
<interval>	Sì	integer	Numero di unità di tempo specifiche da sottrarre
<timeUnit>	Sì	string	Unità di tempo da usare con interval. Le unità possibili sono "Second", "Minute", "Hour", "Day", "Week", "Month" e "Year".
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.

Valore restituito	Tipo	Descrizione
<updated-timestamp>	string	Timestamp corrente meno il numero di unità di tempo specificato

Esempio 1

Si supponga che il timestamp corrente sia 2018-02-01T00:00:00.000Z. Questo esempio sottrae cinque giorni dal timestamp:

getPastTime(5, 'Day')

E restituisce il risultato 2019-01-27T00:00:00.000Z.

Esempio 2

Si supponga che il timestamp corrente sia 2018-03-01T00:00:00.000Z. In questo esempio vengono sottratti cinque giorni al timestamp nel formato MM-GG-YY :

getPastTime(5, 'Day', 'MM-DD-YY')

E restituisce il risultato 02-26-18.

Esempio 3

Si supponga che il timestamp corrente sia 2020-05-01T00:00:00.000Z e che le impostazioni locali siano de-DE. L'esempio seguente sottrae 1 giorno dal timestamp:

getPastTime(1,'Day', '', 'de-DE')

E restituisce il risultato 31.04.20 00:00:00.

getPreviousViableDate

Restituisce la data valida precedente di un'espressione Timex in base alla data corrente e a un fuso orario facoltativamente specificato.

getPreviousViableDate(<timexString>, <timezone>?)

Parametro	Obbligatorio	Type	Descrizione
<timexString>	Sì	string	Stringa Timex della data da valutare.
<timezone>	No	string	Fuso orario facoltativo.

Valore restituito	Tipo	Descrizione
<previousViableDate>	string	Data valida precedente.

Esempi

Si supponga che la data sia 2020-06-12 e l'ora corrente sia 15:42:21.

Questi esempi valutano una stringa Timex per la data valida precedente in base alla data e all'ora precedenti:

getPreviousViableDate("XXXX-12-20", "Eastern Standard Time")
getPreviousViableDate("XXXX-02-29")

E restituiscono le stringhe seguenti rispettivamente:

• 2019-12-20
• 2020-02-29

getPreviousViableTime

Restituisce l'ora valida precedente di un'espressione Timex in base alla data corrente e a un fuso orario specificato facoltativamente.

getPreviousViableTime(<timexString>, <timezone>?)

Parametro	Obbligatorio	Type	Descrizione
<timexString>	Sì	string	Stringa Timex del tempo da valutare.
<timezone>	No	string	Fuso orario facoltativo.

Valore restituito	Tipo	Descrizione
<previousViableTime>	string	Tempo praticabile precedente.

Esempi

Si supponga che la data sia 2020-06-12 e l'ora corrente sia 15:42:21.

Questi esempi valutano una stringa Timex per l'ora valida precedente in base alla data e all'ora precedenti:

getPreviousViableTime("TXX:52:14")
getPreviousViableTime("TXX:12:14", 'Europe/London')

E restituiscono le stringhe seguenti rispettivamente:

• T14:52:14
• T15:12:14

getProperty

Restituisce il valore di una proprietà specificata o della proprietà radice da un oggetto JSON.

Restituire il valore di una proprietà specificata

getProperty(<JSONObject>, '<propertyName>')

Parametro	Obbligatorio	Type	Descrizione
<JSONObject>	Sì	oggetto	Oggetto JSON contenente la proprietà e i valori.
<propertyName>	No	string	Nome della proprietà facoltativa da cui accedere ai valori.

Valore restituito	Tipo	Descrizione
value	string	Valore della proprietà specificata nell'oggetto JSON.

Esempio

Si supponga di avere l'oggetto JSON seguente:

{
   "a:b" : "a:b value",
   "c":
   {
        "d": "d key"
    }
}

Questo esempio recupera una proprietà specificata dall'oggetto JSON precedente:

getProperty({"a:b": "value"}, 'a:b')
getProperty(c, 'd')

E restituiscono le stringhe seguenti rispettivamente:

• valore a:b
• d key

Restituire la proprietà radice

getProperty('<propertyName>')

Parametro	Obbligatorio	Type	Descrizione
<propertyName>	Sì	string	Nome della proprietà facoltativa per accedere ai valori dall'ambito della memoria radice.

Valore restituito	Tipo	Descrizione
value	string	Valore della proprietà radice in un oggetto JSON.

Esempio

Si supponga di avere l'oggetto JSON seguente:

{
   "a:b" : "a:b value",
   "c":
   {
        "d": "d key"
    }
}

Questo esempio recupera la proprietà radice dall'oggetto JSON precedente:

getProperty("a:b")

E restituisce la stringa a:b value.

getTimeOfDay

Restituisce l'ora del giorno per un timestamp specificato.

getTimeOfDay('<timestamp>')

L'ora restituita è una delle stringhe seguenti:

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp specificato

Valore restituito	Tipo	Descrizione
<time-of-day>	string	Ora del giorno per il timestamp specificato

Di seguito sono elencate le stringhe associate all'ora del giorno:

Ora del giorno	Timestamp:
mezzanotte	00.00
morning	00.01-11.59
afternoon	12.00
evening	18.00-22.00
notte	22.01-23.59

Esempio

getTimeOfDay('2018-03-15T08:00:00.000Z')

Restituisce il risultato morning.

greater

Verifica se il primo valore è maggiore del secondo valore. Restituisce true se il primo valore è maggiore; restituisce false se è minore.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	Integer, float o string	Primo valore da verificare per determinare se è maggiore del secondo
<compareTo>	Sì	Integer, float o string, rispettivamente	Valore di confronto

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se il primo valore è maggiore del secondo valore. Restituisce false se il primo valore è uguale o minore del secondo.

Esempio

Questi esempi verificano se il primo valore è maggiore del secondo:

greater(10, 5)
greater('apple', 'banana')

E restituiscono rispettivamente i risultati seguenti:

• true
• false

greaterOrEquals

Verifica se il primo valore è maggiore o uguale al secondo valore. Restituisce true se il primo valore è maggiore o uguale; restituisce false se è minore.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	Integer, float o string	Primo valore da verificare per determinare se è maggiore o uguale al secondo
<compareTo>	Sì	Integer, float o string, rispettivamente	Valore di confronto

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se il primo valore è maggiore o uguale al secondo valore. Restituisce false se il primo valore è minore del secondo valore.

Esempio

Questi esempi verificano se il primo valore è maggiore o uguale al secondo:

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

E restituiscono rispettivamente i risultati seguenti:

• true
• false

if

Verifica se un'espressione è true o false. In base al risultato, restituisce un valore specificato.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Parametro	Obbligatorio	Type	Descrizione
<expression>	Sì	Booleano	Espressione da verificare
<valueIfTrue>	Sì	qualsiasi	Valore da restituire se l'espressione è true
<valueIfFalse>	Sì	qualsiasi	Valore da restituire se l'espressione è false

Valore restituito	Tipo	Descrizione
<specified-return-value>	qualsiasi	Valore specificato restituito a seconda del fatto che l'espressione sia true o false

Esempio

Questo esempio valuta se equals(1,1) è true:

if(equals(1, 1), 'yes', 'no')

E restituisce yes perché l'espressione specificata restituisce true. In caso contrario, l'esempio restituisce no.

indexOf

Restituisce la posizione iniziale o il valore di indice di una sottostringa. Questa funzione non fa distinzione tra maiuscole e minuscole e gli indici iniziano con il numero 0.

indexOf('<text>', '<searchText>')

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	Stringa o matrice	Stringa che contiene la sottostringa da trovare
<searchText>	Sì	string	Sottostringa da trovare

Valore restituito	Tipo	Descrizione
<index-value>	integer	Posizione iniziale o valore di indice della sottostringa specificata.
Se la stringa non viene trovata, restituire il numero -1.

Esempio 1

Questo esempio trova il valore di indice iniziale della sottostringa world nella stringa hello world:

indexOf('hello world', 'world')

E restituisce il risultato 6.

Esempio 2

Questo esempio trova il valore di indice iniziale della sottostringa def nella matrice ['abc', 'def', 'ghi']:

indexOf(createArray('abc', 'def', 'ghi'), 'def')

E restituisce il risultato 1.

indicesAndValues

Converte una matrice o un oggetto in una matrice di oggetti con proprietà index (indice corrente) e value. Per le matrici, l'indice è la posizione nella matrice. Per gli oggetti, è la chiave per il valore.

indicesAndValues('<collection or object>')

Parametro	Obbligatorio	Type	Descrizione
<collection or object>	Sì	matrice o oggetto	Matrice o oggetto originale

Valore restituito	Tipo	Descrizione
<collection>	array	Nuova matrice. Ogni elemento ha due proprietà: l'indice con la posizione in una matrice o la chiave per un oggetto e il valore corrispondente.

Esempio 1

Si supponga di avere l'elenco { items: ["zero", "one", "two"] }. La funzione seguente accetta l'elenco:

indicesAndValues(items)

E restituisce un nuovo elenco:

[
  {
    index: 0,
    value: 'zero'
  },
  {
    index: 1,
    value: 'one'
  },
  {
    index: 2,
    value: 'two'
  }
]

Esempio 2

Si supponga di avere l'elenco { items: ["zero", "one", "two"] }. La funzione seguente accetta l'elenco:

where(indicesAndValues(items), elt, elt.index >= 1)

E restituisce un nuovo elenco:

[
  {
    index: 1,
    value: 'one'
  },
  {
    index: 2,
    value: 'two'
  }
]

Esempio 3

Si supponga di avere l'elenco { items: ["zero", "one", "two"] }. La funzione seguente accetta l'elenco:

join(foreach(indicesAndValues(items), item, item.value), ',')

E restituisce il risultato zero,one,two. Questa espressione ha lo stesso effetto di join(items, ',').

Esempio 4

Si supponga di avere un oggetto { user: {name: 'jack', age: 20} }. La funzione seguente accetta l'oggetto:

indicesAndValues(user)

E restituisce un nuovo oggetto:

[
  {
    index: 'name',
    value: 'jack'
  },
  {
    index: 'age',
    value: 20
  }
]

int

Restituisce la versione Integer di una stringa. Se la stringa non può essere convertita in un numero intero, verrà generata un'eccezione.

int('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	string	Stringa da convertire

Valore restituito	Tipo	Descrizione
<integer-result>	integer	Versione Integer della stringa specificata

Esempio

Questo esempio crea una versione Integer per la stringa 10:

int('10')

E restituisce il risultato come Integer 10.

intersection

Restituisce una raccolta che contiene solo gli elementi comuni alle raccolte specificate. Per essere incluso nel risultato, un elemento deve essere presente in tutte le raccolte passate alla funzione. Se uno o più elementi hanno lo stesso nome, nel risultato viene incluso l'ultimo elemento con tale nome.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Parametro	Obbligatorio	Type	Descrizione
<collection1>, <collection2>	Sì	matrice o oggetto, ma non entrambi i tipi	Raccolte da cui ottenere solo gli elementi comuni

Valore restituito	Tipo	Descrizione
<common-items>	matrice o oggetto, rispettivamente	Raccolta che contiene solo gli elementi comuni alle raccolte specificate

Esempio

Questo esempio trova gli elementi comuni tra le matrici seguenti:

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

E restituisce una matrice con i soli elementi [1, 2].

isArray

Restituisce true se l'input specificato è una matrice.

isArray('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	qualsiasi	Input da testare

Valore restituito	Tipo	Descrizione
<Boolean-result>	Booleano	Restituisce true se un determinato input è una matrice o restituisce false se non è una matrice.

Esempi

Gli esempi seguenti controllano se l'input è una matrice:

isArray('hello')
isArray(createArray('hello', 'world'))

E restituiscono rispettivamente i risultati seguenti:

• L'input è una stringa, quindi la funzione restituisce false.
• L'input è una matrice, quindi la funzione restituisce true.

isBoolean

Restituisce true se l'input specificato è booleano.

isBoolean('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	qualsiasi	Input da testare

Valore restituito	Tipo	Descrizione
<Boolean-result>	Booleano	Restituisce true se l'input specificato è un valore booleano; restituisce false se non è un valore booleano.

Esempi

Gli esempi seguenti controllano se l'input è un valore booleano:

isBoolean('hello')
isBoolean(32 > 16)

E restituiscono rispettivamente i risultati seguenti:

• L'input è una stringa, quindi la funzione restituisce false.
• L'input è un valore, quindi la funzione restituisce true.

isDate

Restituisce true se l'espressione TimexProperty o Timex fa riferimento a una data valida. Le date valide contengono month e dayOfMonth oppure contengono dayOfWeek.

isDate('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	oggetto o stringa	Oggetto TimexProperty di input o la stringa di un'espressione Timex.

Valore restituito	Tipo	Descrizione
<boolean-result>	Booleano	Restituisce true se l'input fa riferimento a una data valida; restituisce false se la data non è valida.

Esempi

Questi esempi controllano se gli input seguenti sono date valide:

isDate('2020-12')
isDate('xxxx-12-21')

E restituiscono i risultati seguenti:

• false
• true

isDateRange

Restituisce true se una determinata espressione TimexProperty o Timex fa riferimento a un intervallo di tempo valido.

isDateRange('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	oggetto o stringa	Oggetto TimexProperty di input o stringa di un'espressione Timex.

Valore restituito	Tipo	Descrizione
<boolean-result>	Booleano	Restituisce true se l'input specificato fa riferimento a un intervallo di date valido o restituisce false se non è un intervallo di date valido.

Esempi

Questi esempi controllano se l'input seguente è un intervallo di tempo valido:

isDateRange('PT30M')
isDateRange('2012-02')

E restituiscono i risultati seguenti:

• false
• true

isDateTime

Restituisce true se un input specificato è una stringa timestamp in formato ISO UTC (YYYY-MM-DDTHH:mm:ss.fffZ).

isDateTime('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	qualsiasi	Input da testare

Valore restituito	Tipo	Descrizione
<Boolean-result>	Booleano	Restituisce true se un determinato input è una stringa di timestamp in formato ISO UTC o restituisce false se non è una stringa di timestamp in formato ISO UTC.

Esempi

Gli esempi seguenti controllano se l'input è una stringa in formato ISO UTC:

isDateTime('hello world!')
isDateTime('2019-03-01T00:00:00.000Z')

E restituiscono rispettivamente i risultati seguenti:

• L'input è una stringa, quindi la funzione restituisce false.
• L'input è una stringa in formato ISO UTC, quindi la funzione restituisce true.

isDefinite

Restituisce true se l'espressione TimexProperty o Timex fa riferimento a una data valida. Le date valide contengono l'anno, il mese e il valore dayOfMonth.

isDefinite('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	oggetto o stringa	Oggetto TimexProperty di input o stringa di un'espressione Timex.

Valore restituito	Tipo	Descrizione
<boolean-result>	Booleano	Restituisce true se l'input specificato fa riferimento a una data completa valida o restituisce false se non fa riferimento a una data completa valida.

Esempi

Si supponga che esista un oggetto TimexProperty validFullDate = new TimexProperty("2020-02-20") e che la proprietà Now sia impostata su true. Gli esempi seguenti verificano se l'oggetto fa riferimento a una data completa valida:

isDefinite('xxxx-12-21')
isDefinite(validFullDate)

E restituiscono rispettivamente i risultati seguenti:

• false
• true

isDuration

Restituisce true se una determinata espressione TimexProperty o Timex fa riferimento a una durata valida.

isDuration('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	oggetto o stringa	Oggetto TimexProperty di input o stringa di un'espressione Timex.

Valore restituito	Tipo	Descrizione
<boolean-result>	Booleano	Restituisce true se l'input fa riferimento a una durata valida, in caso contrario restituisce false.

Esempi

Gli esempi qui sotto controllano se l'input seguente si riferisce a una durata valida:

isDuration('PT30M')
isDuration('2012-02')

E restituiscono rispettivamente i risultati seguenti:

• true
• false

isFloat

Restituisce true se un input specificato è un numero a virgola mobile. A causa dell'allineamento tra C# e JavaScript, un numero con un residuo diverso da zero del modulo 1 verrà trattato come numero a virgola mobile.

isFloat('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	qualsiasi	Input da testare

Valore restituito	Tipo	Descrizione
<Boolean-result>	Booleano	Restituisce true se un determinato input è un numero a virgola mobile o restituisce false se l'input non è un numero a virgola mobile.

Esempi

Gli esempi seguenti controllano se l'input è un numero a virgola mobile:

isFloat('hello world!')
isFloat(1.0)
isFloat(12.01)

E restituiscono rispettivamente i risultati seguenti:

• L'input è una stringa, quindi la funzione restituisce false.
• L'input ha un modulo uguale a 0, quindi la funzione restituisce false.
• L'input è un numero a virgola mobile, quindi la funzione restituisce true.

isInteger

Restituisce true se un dato input è un numero intero. A causa dell'allineamento tra C# e JavaScript, un numero con un residuo zero del modulo 1 verrà trattato come numero intero.

isInteger('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	qualsiasi	Input da testare

Valore restituito	Tipo	Descrizione
<Boolean-result>	Booleano	L'input è un numero intero

Esempi

Gli esempi seguenti controllano se l'input è un numero intero:

isInteger('hello world!')
isInteger(1.0)
isInteger(12)

E restituiscono rispettivamente i risultati seguenti:

• L'input è una stringa, quindi la funzione restituisce false.
• L'input ha un modulo uguale a 0, quindi la funzione restituisce true.
• L'input è un numero intero, quindi la funzione restituisce true.

isMatch

Restituisce true se una determinata stringa corrisponde a un modello di espressione regolare specificato.

isMatch('<target**string>', '<pattern>')

Parametro	Obbligatorio	Type	Descrizione
<target**string>	Sì	string	La stringa da confrontare
<pattern>	Sì	string	Modello di espressione regolare

Valore restituito	Tipo	Descrizione
<Boolean-result>	Booleano	Restituisce true se una determinata stringa corrisponde a un criterio di espressione regolare comune o restituisce false se non corrisponde al criterio.

Esempi

Nell'esempio seguente viene verificato se l'input corrisponde al modello di espressione regolare specificato:

isMatch('ab', '^[a-z]{1,2}$')
isMatch('FUTURE', '(?i)fortune|future')
isMatch('12abc34', '([0-9]+)([a-z]+)([0-9]+)')
isMatch('abacaxc', 'ab.*?c')

E restituiscono lo stesso risultato true.

IsObject

Restituisce true se un determinato input è un oggetto complesso o restituisce false se si tratta di un oggetto primitivo. Gli oggetti primitivi includono stringhe, numeri e valori booleani; i tipi complessi, ad esempio le classi, contengono proprietà.

isObject('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	qualsiasi	Input da testare

Valore restituito	Tipo	Descrizione
<Boolean-result>	Booleano	Restituisce true se un determinato input è un oggetto complesso o restituisce false se si tratta di un oggetto primitivo.

Esempi

Gli esempi seguenti controllano se l'input specificato è un oggetto:

isObject('hello world!')
isObject({userName: "Sam"})

E restituiscono rispettivamente i risultati seguenti:

• L'input è una stringa, quindi la funzione restituisce false.
• L'input è un oggetto, quindi la funzione restituisce true.

IsPresent

Restituisce true se l'espressione TimexProperty o Timex specificata fa riferimento al presente.

isPresent('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	oggetto o stringa	Oggetto TimexProperty di input o stringa di un'espressione Timex

Valore restituito	Tipo	Descrizione
<boolean-result>	Booleano	Restituisce true se l'input fa riferimento al presente o restituisce false se non fa riferimento al presente.

Esempi Si supponga di avere un oggetto TimexProperty validNow = new TimexProperty() { Now = true } e di impostare la proprietà Now su true. Gli esempi qui sotto controllano se l'input seguente si riferisce al presente:

isPresent('PT30M')
isPresent(validNow)

E restituiscono rispettivamente i risultati seguenti:

• false
• true

IsString

Restituisce true se l'input specificato è una stringa.

isString('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	qualsiasi	Input da testare

Valore restituito	Tipo	Descrizione
<Boolean-result>	Booleano	Restituisce true se un determinato input è una stringa, in caso contrario restituisce false.

Esempi

Gli esempi seguenti controllano se l'input specificato è una stringa:

isString('hello world!')
isString(3.14)

E restituiscono rispettivamente i risultati seguenti:

• L'input è una stringa, quindi la funzione restituisce true.
• L'input è un'espressione float, quindi la funzione restituisce false.

isTime

Restituisce true se l'espressione TimexProperty o Timex fa riferimento a un'ora valida. L'ora valida contiene ore, minuti e secondi.

isTime('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	oggetto o stringa	Oggetto TimexProperty di input o stringa di un'espressione Timex

Valore restituito	Tipo	Descrizione
<boolean-result>	Booleano	Restituisce true se l'input fa riferimento a un'ora valida, in caso contrario restituisce false.

Esempi

Questi esempi controllano se l'input seguente fa riferimento a un'ora valida:

isTime('PT30M')
isTime('2012-02-21T12:30:45')

E restituiscono rispettivamente i risultati seguenti:

• false
• true

isTimeRange

Restituisce true se una determinata espressione TimexProperty o Timex fa riferimento a un intervallo di tempo valido Gli intervalli di tempo validi contengono partOfDay.

isTime('<input>')

Parametro	Obbligatorio	Type	Descrizione
<input>	Sì	oggetto o stringa	Oggetto TimexProperty di input o stringa di un'espressione Timex.

Valore restituito	Tipo	Descrizione
<boolean-result>	Booleano	Restituisce true se l'input fa riferimento a un intervallo di tempo valido, in caso contrario restituisce false.

Esempi

Si supponga di avere un oggetto TimexProperty validTimeRange = new TimexProperty() { PartOfDay = "morning" } e di impostare la proprietà Now su true. Questi esempi controllano se gli input seguenti sono intervalli di tempo validi:

isTimeRange('PT30M')
isTimeRange(validTimeRange)

E restituiscono rispettivamente i risultati seguenti:

• false
• true

join

Restituisce una stringa con tutti gli elementi di una matrice, in cui ogni carattere è separato da un delimitatore.

join([<collection>], '<delimiter>')

Parametro	Obbligatorio	Type	Descrizione
<collection>	Sì	array	Matrice contenente gli elementi da aggiungere
<delimiter>	Sì	string	Separatore visualizzato tra ogni carattere nella stringa risultante

Valore restituito	Tipo	Descrizione
<delimitatore char1><delimitatore><> char2...><	string	Stringa risultante creata da tutti gli elementi nella matrice specificata

Esempio

In questo esempio viene creata una stringa da tutti gli elementi di questa matrice con il carattere specificato. Come delimitatore:

join(createArray('a', 'b', 'c'), '.')

E restituisce il risultato a.b.c.

jPath

Verifica all'interno di codice JSON o di una stringa JSON la presenza di nodi o valori che corrispondono a un'espressione di tracciato e restituisce i nodi corrispondenti.

jPath(<json>, '<path>')

Parametro	Obbligatorio	Type	Descrizione
<json>	Sì	qualsiasi	Oggetto o stringa JSON in cui eseguire la ricerca di nodi o valori che corrispondono al valore dell'espressione di tracciato
<path>	Sì	qualsiasi	Espressione di percorso usata per trovare i nodi o i valori JSON corrispondenti

Valore restituito	Tipo	Descrizione
[ <json-node>]	array	Elenco di nodi o valori JSON che corrispondono all'espressione di percorso specificata

Esempio in C#

Si supponga di avere il JSON seguente:

{
    "Stores": [
        "Lambton Quay",
        "Willis Street"
    ],
    "Manufacturers": [
        {
            "Name": "Acme Co",
            "Products": [
                {
                    "Name": "Anvil",
                    "Price": 50
                }
            ]
        },
        {
            "Name": "Contoso",
            "Products": [
                {
                    "Name": "Elbow Grease",
                    "Price": 99.95
                },
                {
                    "Name": "Headlight Fluid",
                    "Price": 4
                }
            ]
        }
    ]
}

L'espressione di percorso è $.. Prodotti[?( @. Prezzo >= 50)]. Nome

jPath(jsonStr, path)

E restituisce il risultato ["Anvil", "Elbow Grease"].

Esempio javaScript

Si supponga di avere il JSON seguente:

{
    "automobiles": [
        {
            "maker": "Nissan",
            "model": "Teana",
            "year": 2011
        },
        {
            "maker": "Honda",
            "model": "Jazz",
            "year": 2010
        },
        {
            "maker": "Honda",
            "model": "Civic",
            "year": 2007
        },
        {
            "maker": "Toyota",
            "model": "Yaris",
            "year": 2008
        },
        {
            "maker": "Honda",
            "model": "Accord",
            "year": 2011
        }
    ],
    "motorcycles": [
        {
            "maker": "Honda",
            "model": "ST1300",
            "year": 2012
        }
    ]
}

L'espressione di percorso è .automobiles{.maker === "Honda" && .year > 2009}.model.

jPath(jsonStr, path)

E restituisce il risultato ['Jazz', 'Accord'].

JSON

Restituisce il valore o l'oggetto di tipo JSON (JavaScript Object Notation) di una stringa o un elemento XML.

json('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	stringa o elemento XML	Stringa o elemento XML da convertire

Valore restituito	Tipo	Descrizione
<JSON-result>	string	Oggetto JSON risultante creato dalla stringa o dal codice XML specificato.

Esempio 1

Questo esempio converte una stringa in JSON:

json('{"fullName": "Sophia Owen"}')

E restituisce il risultato:

{
  "fullName": "Sophia Owen"
}

Esempio 2

Questo esempio converte un elemento XML in JSON:

json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

E restituisce il risultato:

{
   "?xml": { "@version": "1.0" },
   "root": {
      "person": [ {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      } ]
   }
}

jsonStringify

Restituisce la stringa JSON di un valore.

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	oggetto	Oggetto da convertire in una stringa JSON

Valore restituito	Tipo	Descrizione
<JSON-result>	string	Stringa JSON risultante.

Esempi

Questi esempi mostrano gli oggetti convertiti in stringhe JSON:

jsonStringify(null)
jsonStringify({a:'b'})

E restituiscono i risultati stringa seguenti rispettivamente:

• Null
• {"a":"b"}

ultimo

Restituisce l'ultimo elemento di una raccolta.

last('<collection>')
last([<collection>])

Parametro	Obbligatorio	Type	Descrizione
<collection>	Sì	Stringa o matrice	Raccolta in cui trovare l'ultimo elemento

Valore restituito	Tipo	Descrizione
<last-collection-item>	string o array, rispettivamente	Ultimo elemento nella raccolta

Esempio

Questi esempi trovano l'ultimo elemento in queste raccolte:

last('abcd')
last(createArray(0, 1, 2, 3))

E restituiscono rispettivamente i risultati seguenti:

• d
• 3

lastIndexOf

Restituisce la posizione iniziale o il valore di indice dell'ultima occorrenza di una substring. Questa funzione non fa distinzione tra maiuscole e minuscole e gli indici iniziano con il numero 0.

lastIndexOf('<text>', '<searchText>')

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	Stringa o matrice	Stringa che contiene la sottostringa da trovare
<searchText>	Sì	string	Sottostringa da trovare

Valore restituito	Tipo	Descrizione
<ending-index-value>	integer	La posizione iniziale o il valore di indice dell'ultima occorrenza della substring specificata. Se la stringa non viene trovata, restituire il numero -1.

Esempio 1

In questo esempio viene trovato il valore di indice iniziale dell'ultima occorrenza della substring world nella stringa hello world:

lastIndexOf('hello world', 'world')

E restituisce il risultato 6.

Esempio 2

Questo esempio trova il valore di indice iniziale dell'ultima occorrenza della substring def nella matrice ['abc', 'def', 'ghi', 'def'].

lastIndexOf(createArray('abc', 'def', 'ghi', 'def'), 'def')

E restituisce il risultato 3.

length

Restituisce la lunghezza di una stringa.

length('<str>')

Parametro	Obbligatorio	Type	Descrizione
<str>	Sì	string	Stringa da calcolare per la lunghezza

Valore restituito	Tipo	Descrizione
<length>	integer	La lunghezza di questa stringa

Esempi

Questi esempi ottengono la lunghezza delle stringhe:

length('hello')
length('hello world')

E restituiscono rispettivamente i risultati seguenti:

• 5
• 11

less

Verifica se il primo valore è minore del secondo valore. Restituisce true se il primo valore è minore, restituisce false se è maggiore.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	Integer, float o string	Primo valore da verificare per determinare se è minore del secondo
<compareTo>	Sì	Integer, float o string, rispettivamente	Elemento di confronto

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se il primo valore è minore del secondo valore. Restituisce false se il primo valore è maggiore o uguale al secondo valore.

Esempi

Questi esempi verificano se il primo valore è minore del secondo.

less(5, 10)
less('banana', 'apple')

E restituiscono rispettivamente i risultati seguenti:

• true
• false

lessOrEquals

Verifica se il primo valore è minore o uguale al secondo valore. Restituisce true se il primo valore è minore o uguale; restituisce false se è maggiore.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	Integer, float o string	Primo valore da verificare per determinare se è minore o uguale al secondo
<compareTo>	Sì	Integer, float o string, rispettivamente	Elemento di confronto

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se il primo valore è minore o uguale al secondo valore. Restituisce false se il primo valore è maggiore del secondo valore.

Esempio

Questi esempi verificano se il primo valore è minore o uguale al secondo valore.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

E restituiscono rispettivamente i risultati seguenti:

• true
• false

max

Restituisce il valore massimo da un elenco o una matrice. L'elenco o la matrice è inclusiva a entrambe le estremità.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Parametro	Obbligatorio	Type	Descrizione
<number1>, <number2>, ...	Sì	number	Set di numeri da cui si vuole ottenere il valore più alto
[<number1>, <number2>, ...]	Sì	matrice di numeri	Matrice di numeri da cui si vuole ottenere il valore più alto

Valore restituito	Tipo	Descrizione
<max-value>	number	Valore più alto nella matrice o nel set di numeri specificato

Esempi

Questi esempi ottengono il valore più alto dal set di numeri e dalla matrice:

max(1, 2, 3)
max(createArray(1, 2, 3))

E restituisce il risultato 3.

merge

Unisce più oggetti JSON o una matrice di oggetti insieme.

merge(<json1>, <json2>, ...)

Parametro	Obbligatorio	Type	Descrizione
<json1>, <json2>, ...	Sì	oggetti o matrice	Set di oggetti JSON o matrice da unire.

Valore restituito	Tipo	Descrizione
<result>	oggetto	Oggetto JSON combinato o oggetti matrice combinati.

Esempi

Si supponga di avere gli oggetti JSON seguenti:

json1 = @"{
            'FirstName': 'John',
            'LastName': 'Smith',
            'Enabled': false,
            'Roles': [ 'User' ]
          }"
json2 =@"{
            'Enabled': true,
            'Roles': [ 'User', 'Admin' ]
          }"

Questo esempio unisce gli oggetti JSON:

string(merge(json(json1), json(json2)))

E restituisce l'oggetto risultante {"FirstName":"John","LastName":"Smith","Enabled":true,"Roles":["User","Amministrazione"]}.

Si supponga di voler combinare gli oggetti e un elenco di oggetti insieme. L'esempio seguente combina l'oggetto JSON e una matrice di oggetti:

merge({k1:'v1'}, [{k2:'v2'}, {k3: 'v3'}], {k4:'v4'})

E restituisce l'oggetto { "k1": "v1", "k2": "v2", "k3": "v3", "k4": "v4" }.

min

Restituisce il valore più basso di un set di numeri o una matrice.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Parametro	Obbligatorio	Type	Descrizione
<number1>, <number2>, ...	Sì	number	Set di numeri da cui si vuole ottenere il valore più basso
[<number1>, <number2>, ...]	Sì	matrice di numeri	Matrice di numeri da cui si vuole ottenere il valore più basso

Valore restituito	Tipo	Descrizione
<min-value>	number	Valore minimo nella matrice o nel set di numeri specificati

Esempi

Questi esempi ottengono il valore più basso nel set di numeri e nella matrice:

min(1, 2, 3)
min(createArray(1, 2, 3))

E restituisce il risultato 1.

mod

Restituisce il resto della divisione di due numeri. Per ottenere il risultato intero, vedere div().

mod(<dividend>, <divisor>)

Parametro	Obbligatorio	Type	Descrizione
<dividend>	Sì	number	Numero da dividere per l'oggetto divisor
<divisor>	Sì	number	Numero che divide l'oggetto dividend. Non può essere 0.

Valore restituito	Tipo	Descrizione
<modulo-result>	number	Resto della divisione del primo numero per il secondo numero

Esempio

Questo esempio divide il primo numero per il secondo numero:

mod(3, 2)

E restituisce il risultato 1.

mese

Restituisce il mese del timestamp specificato.

month('<timestamp>')

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp

Valore restituito	Tipo	Descrizione
<number-of-month>	integer	Numero del mese nel timestamp specificato

Esempio

month('2018-03-15T13:01:00.000Z')

E restituisce il risultato 3.

mul

Restituisce il prodotto della moltiplicazione di due numeri.

mul(<multiplicand1>, <multiplicand2>)

Parametro	Obbligatorio	Type	Descrizione
<multiplicand1>	Sì	integer o float	Numero da moltiplicare per multiplicand2
<multiplicand2>	Sì	integer o float	Numero che moltiplica multiplicand1

Valore restituito	Tipo	Descrizione
<product-result>	integer o float	Prodotto della moltiplicazione del primo numero per il secondo numero

Esempi

Questi esempi moltiplicano il primo numero per il secondo numero:

mul(1, 2)
mul(1.5, 2)

E restituiscono rispettivamente i risultati seguenti:

• 2
• 3

newGuid

Restituisce una nuova stringa Guid.

newGuid()

Valore restituito	Tipo	Descrizione
<Guid-string>	string	Una nuova stringa GUID, la lunghezza è 36 e ha un aspetto simile a xxxxxxxx-xxxx-4xxx-Yxxx-xxxxxxxxxxxx

Esempio

newGuid()

E restituisce un risultato che segue il formato xxxxxxxx-xxxx-4xxx-Yxxx-xxxxxxxxxxxx.

not

Verifica se un'espressione è false. Restituisce true se l'espressione è false; restituisce false se è true.

not(<expression>)

Parametro	Obbligatorio	Type	Descrizione
<expression>	Sì	Booleano	Espressione da verificare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se l'espressione è false. Restituisce false se l'espressione è true.

Esempio 1

Questi esempi verificano se le espressioni specificate sono false:

not(false)
not(true)

E restituiscono rispettivamente i risultati seguenti:

• l'espressione è false, quindi la funzione restituisce true.
• l'espressione è true, quindi la funzione restituisce false.

Esempio 2

Questi esempi verificano se le espressioni specificate sono false:

not(equals(1, 2))
not(equals(1, 1))

E restituiscono rispettivamente i risultati seguenti:

• l'espressione è false, quindi la funzione restituisce true.
• l'espressione è true, quindi la funzione restituisce false.

oppure

Verifica se almeno un'espressione è true. Restituisce true se almeno un'espressione è true o false se tutte le espressioni sono false.

or(<expression1>, <expression2>, ...)

Parametro	Obbligatorio	Type	Descrizione
<expression1>, <expression2>, ...	Sì	Booleano	Espressioni da verificare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se almeno un'espressione è true. Restituisce false se tutte le espressioni sono false.

Esempio 1

Questi esempi verificano se almeno un'espressione è true:

or(true, false)
or(false, false)

E restituiscono rispettivamente i risultati seguenti:

• almeno un'espressione è true, quindi la funzione restituisce true.
• entrambe le espressioni sono false, quindi la funzione restituisce false.

Esempio 2

Questi esempi verificano se almeno un'espressione è true:

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

E restituiscono rispettivamente i risultati seguenti:

• almeno un'espressione è true, quindi la funzione restituisce true.
• entrambe le espressioni sono false, quindi la funzione restituisce false.

rand

Restituisce un valore intero casuale da un intervallo specificato, che include solo l'estremo inziale.

rand(<minValue>, <maxValue>)

Parametro	Obbligatorio	Type	Descrizione
<minValue>	Sì	integer	Valore intero più basso nell'intervallo
<maxValue>	Sì	integer	Valore intero che segue il valore intero più alto nell'intervallo che la funzione può restituire

Valore restituito	Tipo	Descrizione
<random-result>	integer	Valore intero casuale restituito dall'intervallo specificato

Esempio

Questo esempio ottiene un valore intero casuale dall'intervallo specificato, escluso il valore massimo:

rand(1, 5)

E restituisce 1, 2, 3 o 4 come risultato.

range

Restituisce una matrice di valori interi che inizia da un valore intero specificato.

range(<startIndex>, <count>)

Parametro	Obbligatorio	Type	Descrizione
<startIndex>	Sì	integer	Valore intero che rappresenta il primo elemento da cui inizia la matrice
<count>	Sì	integer	Numero di valori interi nella matrice

Valore restituito	Tipo	Descrizione
<range-result>	integer	Matrice di valori interi a partire dall'indice specificato

Esempio

Questo esempio crea una matrice di valori interi che inizia dall'indice specificato 1 e include il numero di valori interi specificato 4:

range(1, 4)

E restituisce il risultato [1, 2, 3, 4].

removeProperty

Rimuove una proprietà da un oggetto e restituisce l'oggetto aggiornato.

removeProperty(<object>, '<property>')

Parametro	Obbligatorio	Type	Descrizione
<object>	Sì	oggetto	Oggetto JSON in cui si vuole rimuovere una proprietà
<property>	Sì	string	Nome della proprietà da rimuovere

Valore restituito	Tipo	Descrizione
<updated-object>	oggetto	Oggetto JSON aggiornato senza la proprietà specificata

Esempio

Questo esempio rimuove la proprietà accountLocation da un oggetto customerProfile, di cui viene eseguita la conversione in JSON con la funzione json() e restituisce l'oggetto aggiornato:

removeProperty(json('customerProfile'), 'accountLocation')

replace

Sostituisce una sottostringa con la stringa specificata e restituisce la stringa risultante. Questa funzione fa distinzione tra maiuscole e minuscole.

replace('<text>', '<oldText>', '<newText>')

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	string	Stringa che contiene la sottostringa da sostituire
<oldText>	Sì	string	Sottostringa da sostituire
<newText>	Sì	string	Stringa da usare per la sostituzione

Valore restituito	Tipo	Descrizione
<updated-text>	string	Stringa aggiornata dopo la sostituzione della substring. Se la sottostringa non viene trovata, la funzione restituisce la stringa originale.

Esempio 1

Questo esempio trova la substring old in the old string e sostituisce old con new:

replace('the old string', 'old', 'new')

Il risultato è la stringa the new string.

Esempio 2

Quando si gestiscono i caratteri di escape, il motore delle espressioni gestisce automaticamente i caratteri non di escape. Questa funzione sostituisce le stringhe con caratteri di escape.

replace('hello\"', '\"', '\n')
replace('hello\n', '\n', '\\\\')
@"replace('hello\\', '\\', '\\\\')"
@"replace('hello\n', '\n', '\\\\')"

E restituiscono rispettivamente i risultati seguenti:

• hello\n
• Ciao\\
• @"hello\\"
• @"hello\\"

replaceIgnoreCase

Sostituisce una sottostringa con la stringa specificata e restituisce la stringa risultante. La funzione non fa distinzione tra maiuscole e minuscole.

replaceIgnoreCase('<text>', '<oldText>', '<newText>')

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	string	Stringa che contiene la sottostringa da sostituire
<oldText>	Sì	string	Sottostringa da sostituire
<newText>	Sì	string	Stringa da usare per la sostituzione

Valore restituito	Tipo	Descrizione
<updated-text>	string	Stringa aggiornata dopo la sostituzione della substring. Se la sottostringa non viene trovata, restituire la stringa originale.

Esempio

Questo esempio trova la substring old nella stringa the old string e sostituisce old con new:

replace('the old string', 'old', 'new')

E restituisce il risultato the new string.

resolve

Restituisce una stringa di un'espressione TimexProperty o Timex specificata se fa riferimento a un'ora valida. Il tempo valido contiene ore, minuti e secondi.

resolve('<timestamp')

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp.

Valore restituito	Tipo	Descrizione
<return>	string	Stringa dell'espressione TimexProperty o Timex valutata.

Esempi

Questi esempi mostrano se le stringhe indicate fanno riferimento all'ora valida:

resolve(T14)
resolve(2020-12-20)
resolve(2020-12-20T14:20)

E restituiscono rispettivamente i risultati seguenti:

• 14:00:00
• 2020-12-20
• 2020-12-20 14:20:00

ordinamento inverso

Invertire l'ordine degli elementi in una stringa o in una matrice.

reverse(<value>)

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	Stringa o matrice	Stringa da assegnare alla matrice da invertire.

Valore restituito	Tipo	Descrizione
<return>	Stringa o matrice	Elementi invertiti di una stringa o di una matrice.

Esempi

Questi esempi invertono gli elementi di una stringa o di una matrice:

reverse(hello)
reverse(concat(hello,world))

E restituiscono rispettivamente i valori seguenti:

-Stringa olleh. -Stringa dlrowolleh.

round

Arrotondare un valore all'intero più vicino o al numero specificato di cifre frazionarie.

round('<number>', '<precision-digits>')

Parametro	Obbligatorio	Type	Descrizione
<number>	Sì	number	Numero di input
<cifre di precisione>	No	integer	Numero specificato di cifre frazionarie. Il valore predefinito è 0.

Valore restituito	Tipo	Descrizione
<return-value>	number	Valore restituito dell'input arrotondato in corrispondenza di un numero specificato di cifre frazionarie

Esempio 1

In questo esempio viene arrotondato il numero 10.333:

round(10.333)

E restituisce il numero 10.

Esempio 2

Questo esempio arrotonda il numero 10,3313 a 2 cifre frazionarie:

round(10.3313, 2)

E restituisce il numero 10,33.

Proprietà

Opera su ogni elemento e restituisce la nuova raccolta di elementi trasformati.

select([<collection/instance>], <iteratorName>, <function>)

Parametro	Obbligatorio	Type	Descrizione
<collection/instance>	Sì	array	Raccolta con gli elementi
<iteratorName>	Sì	nome iteratore	Elemento chiave
<function>	Sì	expression	La funzione che può contenere iteratorName

Valore restituito	Tipo	Descrizione
<new-collection>	array	Nuova raccolta in cui ogni elemento è stato valutato con la funzione

Esempio 1

Questo esempio genera una nuova raccolta:

select(createArray(0, 1, 2, 3), x, x + 1)

E restituisce il risultato [1, 2, 3, 4].

Esempio 2

Questi esempi generano una nuova raccolta:

select(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
select(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))

E restituiscono il risultato ['name:jack', 'age:15']. Si noti che la seconda espressione è un'espressione lambda, che alcuni trovano più leggibili.

sentenceCase

In maiuscolo la prima lettera della prima parola in una stringa in un formato di impostazioni locali facoltativo.

sentenceCase('<text>', '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	string	Stringa originale
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
stringa di risultato	string	Restituisce il risultato della distinzione tra maiuscole e minuscole

Esempio 1

Questi esempi maiuscolano la prima lettera in una stringa:

sentenceCase('a')
sentenceCase('abc def')
sentenceCase('aBC dEF')

E restituiscono rispettivamente i risultati seguenti:

• A
• Abc def
• Abc def

Esempio 2

Questi esempi maiuscolano la prima lettera in una stringa nel formato delle impostazioni locali specificato:

sentenceCase('a', 'fr-FR')
sentenceCase('abc', 'en-US')
sentenceCase('aBC', 'fr-FR')

E restituiscono rispettivamente i risultati seguenti:

• A
• Abc
• Abc

setPathToValue

Recupera il valore della proprietà specificata dall'oggetto JSON.

setPathToValue(<path>, <value>)

Parametro	Obbligatorio	Type	Descrizione
<Percorso>	Sì	oggetto	Percorso che si vuole impostare
<value>	Sì	oggetto	Valore che si vuole impostare sul percorso

Valore restituito	Tipo	Descrizione
value	oggetto	Valore da impostare

Esempio 1

L'esempio seguente imposta il valore 1 sul percorso:

setPathToValue(path.x, 1)

E restituisce il risultato 1. è impostato su path.x1.

Esempio 2

In questo esempio viene impostato il valore:

setPathToValue(path.array[0], 7) + path.array[0]

E viene restituito il risultato 14.

setProperty

Imposta il valore di una proprietà dell'oggetto e restituisce l'oggetto aggiornato. Per aggiungere una nuova proprietà, usare questa funzione o la funzione addProperty().

setProperty(<object>, '<property>', <value>)

Parametro	Obbligatorio	Type	Descrizione
<object>	Sì	oggetto	Oggetto JSON in cui si vuole impostare una proprietà
<property>	Sì	string	Nome della proprietà da impostare
<value>	Sì	qualsiasi	Valore da impostare per la proprietà specificata

Valore restituito	Tipo	Descrizione
<updated-object>	oggetto	Oggetto JSON aggiornato di cui si imposta la proprietà

Esempio

Questo esempio imposta la proprietà accountNumber per un oggetto customerProfile, che viene convertito in JSON con la funzione json(). La funzione assegna un valore generato dalla funzione newGuid() e restituisce l'oggetto JSON aggiornato:

setProperty(json('customerProfile'), 'accountNumber', newGuid())

skip

Rimuove gli elementi dall'inizio di una raccolta e restituisce tutti gli altri elementi.

skip([<collection>], <count>)

Parametro	Obbligatorio	Type	Descrizione
<collection>	Sì	array	Raccolta da cui rimuovere gli elementi
<count>	Sì	integer	Valore intero positivo per il numero di elementi da rimuovere nella parte iniziale

Valore restituito	Tipo	Descrizione
<updatedCollection>	array	Raccolta aggiornata dopo la rimozione degli elementi specificati

Esempio

Questo esempio rimuove un elemento, il numero 1, dall'inizio della matrice specificata:

skip(createArray(0, 1, 2, 3), 1)

E restituisce una matrice con gli elementi rimanenti: [1,2,3].

sortBy

Ordina gli elementi della raccolta in ordine crescente e restituisce la raccolta ordinata.

sortBy([<collection>], '<property>')

Parametro	Obbligatorio	Type	Descrizione
<collection>	Sì	Stringa o matrice	Raccolta da ordinare
<property>	No	string	Ordina in base a questa proprietà specifica dell'elemento oggetto nella raccolta se impostata

Valore restituito	Tipo	Descrizione
<new-collection>	array	Nuova raccolta i cui elementi sono stati ordinati

Esempio 1

Questo esempio genera l'ordinamento della raccolta seguente:

sortBy(createArray(1, 2, 0, 3))

E restituisce il risultato [0, 1, 2, 3].

Esempio 2

Si supponga di avere la raccolta seguente:

{
  'nestedItems': [
    {'x': 2},
    {'x': 1},
    {'x': 3}
  ]
}

Questo esempio genera una nuova raccolta ordinata in base alla proprietà dell'oggetto x

sortBy(nestedItems, 'x')

E restituisce il risultato:

{
  'nestedItems': [
    {'x': 1},
    {'x': 2},
    {'x': 3}
  ]
}

sortByDescending

Ordina gli elementi della raccolta in ordine decrescente e restituisce la raccolta ordinata.

sortBy([<collection>], '<property>')

Parametro	Obbligatorio	Type	Descrizione
<collection>	Sì	Stringa o matrice	Raccolta da ordinare
<property>	No	string	Ordina in base a questa proprietà specifica dell'elemento oggetto nella raccolta se impostata

Valore restituito	Tipo	Descrizione
<new-collection>	array	Nuova raccolta i cui elementi sono stati ordinati

Esempio 1

Questo esempio genera una nuova raccolta ordinata:

sortByDescending(createArray(1, 2, 0, 3))

E restituisce il risultato [3, 2, 1, 0].

Esempio 2

Si supponga di avere la raccolta seguente:

{
  'nestedItems': [
    {'x': 2},
    {'x': 1},
    {'x': 3}
  ]
}

Questo esempio genera una nuova raccolta ordinata in base alla proprietà dell'oggetto x:

sortByDescending(nestedItems, 'x')

E viene restituito questo risultato:

{
  'nestedItems': [
    {'x': 3},
    {'x': 2},
    {'x': 1}
  ]
}

split

Restituisce una matrice che contiene le sottostringhe, separate da virgole, in base al carattere delimitatore specificato nella stringa originale.

split('<text>', '<delimiter>'?)

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	string	Stringa da suddividere in sottostringhe in base al delimitatore specificato nella stringa originale. Se il testo è un valore null, verrà considerata come una stringa vuota.
<delimiter>	No	string	Carattere nella stringa originale da usare come delimitatore. Se non è stato specificato alcun delimitatore o il delimitatore è un valore null, il valore predefinito sarà una stringa vuota.

Valore restituito	Tipo	Descrizione
[<substring1,substring2><>,...]	array	Matrice che contiene le sottostringhe della stringa originale, separate da virgole

Esempi

Questi esempi creano una matrice con le sottostringhe della stringa specificata in base al carattere delimitatore specificato:

split('a**b**c', '**')
split('hello', '')
split('', 'e')
split('', '')
split('hello')

E restituisce le matrici seguenti rispettivamente come risultato:

• ["a", "b", "c"]
• ["h", "e", "l", "l", "o"]
• [""], [ ]
• ["h", "e", "l", "l", "o"]

sqrt

Restituisce la radice quadrata di un numero specificato.

sqrt(<number>)

Parametro	Obbligatorio	Type	Descrizione
<number>	Sì	number	Numero di cui ottenere la radice quadrata di

Valore restituito	Tipo	Descrizione
<result>	number	Risultato del calcolo della radice quadrata.

Esempi

Questi esempi calcolano la radice quadrata dei numeri specificati:

sqrt(9)
sqrt(0)

E restituiscono rispettivamente i risultati seguenti:

• 3
• 0

startOfDay

Restituisce l'inizio del giorno per un timestamp in un formato delle impostazioni locali facoltativo.

startOfDay('<timestamp>', '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
'<updated-timestamp>'	string	Timestamp specificato, che inizia in corrispondenza della mezzanotte esatta per il giorno

Esempio 1

Questo esempio trova l'inizio del giorno:

startOfDay('2018-03-15T13:30:30.000Z')

E restituisce il risultato 2018-03-15T00:00:00.000Z.

Esempio 2

Questo esempio trova l'inizio del giorno con le impostazioni locali fr-FR:

startOfDay('2018-03-15T13:30:30.000Z', '', 'fr-FR')

E restituisce il risultato 15/03/2018 00:00:00.

startOfHour

Restituisce l'inizio dell'ora per un timestamp in un formato di impostazioni locali facoltativo.

startOfHour('<timestamp>', '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
'<updated-timestamp>'	string	Timestamp specificato, che inizia in corrispondenza dei minuti esatti per il giorno

Esempio 1

Questo esempio trova l'inizio dell'ora:

startOfHour('2018-03-15T13:30:30.000Z')

E restituisce il risultato 2018-03-15T13:00:00.000Z.

Esempio 2

Questo esempio trova l'inizio dell'ora con le impostazioni locali fr-FR:

startOfHour('2018-03-15T13:30:30.000Z', '', 'fr-FR')

E restituisce il risultato 15/03/2018 13:00:00.

startOfMonth

Restituisce l'inizio del mese per un timestamp in un formato delle impostazioni locali facoltativo.

startOfMonth('<timestamp>', '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
'<updated-timestamp>'	string	Timestamp specificato, che inizia il primo giorno del mese in corrispondenza della mezzanotte esatta

Esempio 1

Questo esempio trova l'inizio del mese:

startOfMonth('2018-03-15T13:30:30.000Z')

E restituisce il risultato 2018-03-01T00:00:00.000Z.

Esempio 2

Questo esempio trova l'inizio del mese con le impostazioni locali fr-FR:

startOfMonth('2018-03-15T13:30:30.000Z', '', 'fr-FR')

E restituisce il risultato 01/03/2018 00:00:00.

startsWith

Verifica se una stringa inizia con una sottostringa specifica. Restituisce true se la substring viene trovata, in caso contrario restituisce false. La funzione non fa distinzione tra maiuscole e minuscole.

startsWith('<text>', '<searchText>')

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	string	Stringa da verificare
<searchText>	Sì	string	Substring iniziale da trovare

Valore restituito	Tipo	Descrizione
true o false	Booleano	Restituisce true se la substring iniziale viene trovata. Restituisce false se non viene trovata

Esempio 1

Questo esempio verifica se la stringa hello world inizia con la stringa hello:

startsWith('hello world', 'hello')

E restituisce il risultato true.

Esempio 2

Questo esempio verifica se la stringa hello world inizia con la stringa greeting:

startsWith('hello world', 'greeting')

E restituisce il risultato false.

string

Restituisce la versione stringa di un valore in un formato di impostazioni locali facoltativo.

string(<value>, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	qualsiasi	Valore da convertire
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<string-value>	string	Versione stringa del valore specificato

Esempio 1

Questo esempio crea la versione stringa del numero 10:

string(10)

E restituisce il risultato della stringa 10.

Esempio 2

Questo esempio crea una stringa per l'oggetto JSON specificato e usa il carattere barra rovesciata, \\, come carattere di escape per il carattere virgolette doppie, ".

string( { "name": "Sophie Owen" } )

E restituisce il risultato { "name": "Sophie Owen" }

Esempio 3

Questo esempio crea una versione stringa del numero 10 in impostazioni locali specifiche:

string(100.1, 'fr-FR')
string(100.1, 'en-US')

E restituisce le stringhe seguenti rispettivamente:

• 100,1
• 100.1

stringOrValue

Eseguire il wrapping dell'interpolazione di stringhe per ottenere il valore reale. Ad esempio, restituisce stringOrValue('${1}') il numero 1, mentre stringOrValue('${1} item') restituisce la stringa "1 elemento".

stringOrValue(<string>)

Parametro	Obbligatorio	Type	Descrzione
<string>	Sì	string	Stringa da cui ottenere il valore reale.

Valore restituito	Tipo	Descrizione
<result>	qualsiasi	Risultato del recupero del valore reale della stringa specificata.

Esempi

Questi esempi ottengono il valore reale dalla stringa:

stringOrValue('${one}')
stringOrValue('${one} item')

E restituiscono rispettivamente i risultati seguenti:

• Numero 1,0.
• Elemento stringa 1.

secondario

Restituisce il risultato della sottrazione del secondo numero dal primo.

sub(<minuend>, <subtrahend>)

Parametro	Obbligatorio	Type	Descrizione
<minuend>	Sì	number	Numero da cui sottrarre l'oggetto subtrahend
<subtrahend>	Sì	number	Numero da sottrarre dall'oggetto minuend

Valore restituito	Tipo	Descrizione
<result>	number	Risultato della sottrazione del secondo numero dal primo

Esempio

Questo esempio sottrae il secondo numero dal primo:

sub(10.3, .3)

E restituisce il risultato 10.

subArray

Restituisce una sottomatrice dalle posizioni iniziale e finale specificate. I valori di Indice iniziano con il numero 0.

subArray(<Array>, <startIndex>, <endIndex>)

Parametro	Obbligatorio	Type	Descrizione
<array>	Sì	array	Matrice da cui creare la sottomatrice
<startIndex>	Sì	integer	Numero positivo maggiore o uguale a 0 da usare come posizione iniziale o valore di indice
<endIndex>	Sì	integer	Numero positivo maggiore o uguale a 0 da usare come posizione finale o valore di indice

Valore restituito	Tipo	Descrizione
<subarray-result>	array	Sottomatrice con il numero di elementi specificato, che inizia in corrispondenza della posizione di indice specificata nella stringa di origine

Esempio

Questo esempio crea una sottomatrice dalla matrice specificata:

subArray(createArray('H','e','l','l','o'), 2, 5)

E restituisce il risultato ["l", "l", "o"].

substring

Restituisce i caratteri di una stringa, partendo dalla posizione o dall'indice specificati. I valori di Indice iniziano con il numero 0.

substring('<text>', <startIndex>, <length>)

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	string	Stringa da cui creare la substring
<startIndex>	Sì	integer	Sottomatrice con numero positivo maggiore o uguale a 0 di elementi da usare come posizione iniziale o valore di indice
<length>	Sì	integer	Sottomatrice con numero positivo di caratteri nella substring

Valore restituito	Tipo	Descrizione
<substring-result>	string	Sottostringa con il numero di caratteri specificato, che inizia in corrispondenza della posizione di indice specificata nella stringa di origine

Esempio

Questo esempio crea una sottostringa di cinque caratteri dalla stringa specificata, a partire dal valore di indice 6:

substring('hello world', 6, 5)

E restituisce il risultato world.

subtractFromTime

Sottrarre un numero di unità di tempo da un timestamp in un formato di impostazioni locali facoltativo. Vedere anche getPastTime().

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?, '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp
<interval>	Sì	integer	Numero di unità di tempo specificate da sottrarre
<timeUnit>	Sì	string	Unità di tempo da usare con interval. Le unità possibili sono "Second", "Minute", "Hour", "Day", "Week", "Month" e "Year".
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<updated-timestamp>	string	Timestamp meno il numero di unità di tempo specificato

Esempio 1

In questo esempio viene sottratto un giorno da un timestamp seguente:

subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day')

E restituisce il risultato 2018-01-01T00:00:00.000Z.

Esempio 2

Questo esempio sottrae un giorno da un timestamp usando il formato D :

subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day', 'D')

E restituisce il risultato lunedì, gennaio 1, 2018.

Esempio 3

Questo esempio sottrae 1 ora da un timestamp nelle impostazioni locali de-DE :

subtractFromTime('2018-03-15T13:00:00.000Z', 1, 'Hour', '', 'de-DE')

E restituisce il risultato 15.03.18 12:00:00.

somma

Restituisce il risultato della somma dei numeri di un elenco.

sum([<list of numbers>])

Parametro	Obbligatorio	Type	Descrizione
[<list of numbers>]	Sì	matrice di numeri	Numeri da sommare

Valore restituito	Tipo	Descrizione
<result-sum>	number	Risultato della somma dei numeri specificati

Esempio

Questo esempio somma i numeri specificati:

sum(createArray(1, 1.5))

E restituisce il risultato 2.5.

take

Restituisce gli elementi dall'inizio di una raccolta.

take('<collection>', <count>)
take([<collection>], <count>)

Parametro	Obbligatorio	Type	Descrizione
<collection>	Sì	Stringa o matrice	Raccolta da cui ottenere gli elementi
<count>	Sì	integer	Valore intero positivo per il numero di elementi da ottenere dalla parte iniziale

Valore restituito	Tipo	Descrizione
<subset> o [<subset>]	String o array, rispettivamente	Stringa o matrice con il numero specificato di elementi presi dall'inizio della raccolta originale

Esempio

Questi esempi ottengono il numero specificato di elementi presi dall'inizio di queste raccolte:

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

E restituiscono rispettivamente i risultati seguenti:

• abc
• [0, 1, 2]

ticks

Restituisce il valore della proprietà ticks di un timestamp specificato. Un tick è un intervallo di 100 nanosecondi.

ticks('<timestamp>')

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa per un timestamp

Valore restituito	Tipo	Descrizione
<ticks-number>	integer (bigint in JavaScript)	Numero di tick dal timestamp specificato

Esempio

In questo esempio viene convertito un timestamp nella relativa proprietà ticks:

ticks('2018-01-01T08:00:00.000Z')

E restituisce il risultato 636503904000000000.

ticksToDays

Convertire un valore della proprietà ticks nel numero di giorni.

ticksToDays('ticks')

Parametro	Obbligatorio	Type	Descrizione
<ticks>	Sì	integer	Valore della proprietà ticks da convertire

Valore restituito	Tipo	Descrizione
<numero di giorni>	number	Numero di giorni convertiti dal valore della proprietà ticks

Esempio

In questo esempio viene convertito un valore della proprietà ticks in un numero di giorni:

ticksToDays(2193385800000000)

E restituisce il numero 2538.64097222.

ticksToHours

Convertire un valore della proprietà ticks nel numero di ore.

ticksToHours('ticks')

Parametro	Obbligatorio	Type	Descrizione
<ticks>	Sì	Intero	Valore della proprietà ticks da convertire

Valore restituito	Tipo	Descrizione
<numero di ore>	number	Numero di ore convertite dal valore della proprietà ticks

Esempio

In questo esempio viene convertito un valore della proprietà ticks in un numero di ore:

ticksToHours(2193385800000000)

E restituisce il numero 60927.3833333331.

ticksToMinutes

Convertire un valore della proprietà ticks nel numero di minuti.

ticksToMinutes('ticks')

Parametro	Obbligatorio	Type	Descrizione
<ticks>	Sì	integer	Valore della proprietà ticks da convertire

Valore restituito	Tipo	Descrizione
<numero di minuti>	number	Numero di minuti convertiti dal valore della proprietà ticks

Esempio

In questo esempio viene convertito un valore della proprietà ticks in un numero di minuti:

ticksToMinutes(2193385800000000)

E restituisce il numero 3655643.0185.

titleCase

In maiuscolo la prima lettera di ogni parola in una stringa in un formato locale facoltativo.

titleCase('<text>', '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	string	Stringa originale
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
stringa di risultato	string	Risultato del case del titolo

Esempio 1

Questi esempi maiuscolano la prima lettera di ogni parola in una stringa:

titleCase('a')
titleCase('abc def')
titleCase('aBC dEF')

E restituiscono rispettivamente i risultati seguenti:

• A
• Abc Def
• Abc Def

Esempio 2

Questi esempi maiuscolano la prima lettera in una stringa nel formato en-US :

titleCase('a', 'en-US')
titleCase('aBC dEF', 'en-US')

E restituiscono rispettivamente i risultati seguenti:

• A
• Abc Def

toLower

Restituisce una stringa in minuscolo in un formato delle impostazioni locali facoltativo. Se un carattere nella stringa non ha un equivalente minuscolo, viene incluso senza modifiche nella stringa restituita.

toLower('<text>', '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	string	Stringa da restituire in formato minuscolo
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<lowercase-text>	string	Stringa originale in formato minuscolo

Esempio 1

Questo esempio converte una stringa in caratteri minuscoli:

toLower('Hello World')

E restituisce il risultato hello world.

Esempio 2

Questo esempio converte una stringa in lettere minuscole nel formato fr-FR :

toUpper('Hello World', 'fr-FR')

E restituisce il risultato hello world.

toUpper

Restituisce una stringa in maiuscolo in un formato delle impostazioni locali facoltativo. Se un carattere nella stringa non ha un equivalente maiuscolo, viene incluso senza modifiche nella stringa restituita.

toUpper('<text>', '<locale>'?)

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	string	Stringa da restituire in formato maiuscolo
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<uppercase-text>	string	Stringa originale in formato maiuscolo

Esempio 1

Questo esempio converte una stringa in caratteri maiuscoli:

toUpper('Hello World')

E restituisce il risultato HELLO WORLD.

Esempio 2

Questo esempio converte una stringa in maiuscolo nel formato fr-FR :

toUpper('Hello World', 'fr-FR')

E restituisce il risultato HELLO WORLD.

Trim

Rimuove gli spazi iniziali e finali da una stringa e restituisce la stringa aggiornata.

trim('<text>')

Parametro	Obbligatorio	Type	Descrizione
<Testo>	Sì	string	Stringa da cui rimuovere gli spazi iniziali e finali

Valore restituito	Tipo	Descrizione
<updatedText>	string	Versione aggiornata della stringa originale senza spazi iniziali o finali

Esempio

Questo esempio rimuove gli spazi iniziali e finali dalla stringa " Hello World ":

trim(' Hello World  ')

E restituisce il risultato tagliato Hello World.

union

Restituisce una raccolta che contiene tutti gli elementi delle raccolte specificate. Per essere incluso nel risultato, un elemento può essere presente in qualsiasi raccolta passata alla funzione. Se uno o più elementi hanno lo stesso nome, nel risultato viene incluso l'ultimo elemento con tale nome.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Parametro	Obbligatorio	Type	Descrizione
<collection1>, <collection2>, ...	Sì	matrice o oggetto, ma non entrambi i tipi	Raccolte da cui ottenere tutti gli elementi

Valore restituito	Tipo	Descrizione
<updatedCollection>	matrice o oggetto, rispettivamente	Raccolta con tutti gli elementi delle raccolte specificate. Non vengono aggiunti duplicati.

Esempio

Questo esempio ottiene tutti gli elementi dalle raccolte seguenti:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

E restituisce il risultato [1, 2, 3, 10, 101].

unique

Rimuove tutti i duplicati da una matrice.

unique([<collection>])

Parametro	Obbligatorio	Type	Descrizione
<collection>	Sì	array	Raccolta da modificare

Valore restituito	Tipo	Descrizione
<new-collection>	array	Nuova raccolta con elementi duplicati rimossi

Esempio 1

In questo esempio vengono rimossi gli elementi duplicati dalla matrice seguente:

unique(createArray(1, 2, 1))

E viene restituito il risultato [1, 2].

uriComponent

Restituisce la versione binaria di un componente di un URI (Uniform Resource Identifier).

uriComponent('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	string	Stringa da convertire nel formato con codifica URI

Valore restituito	Tipo	Descrizione
<encoded-uri>	string	Stringa con codifica URI con i caratteri di escape

Esempio

Questo esempio crea una versione con codifica URI di una stringa:

uriComponent('https://contoso.com')

E restituisce il risultato http%3A%2F%2Fcontoso.com.

uriComponentToString

Restituisce la versione stringa di una stringa con codifica URI (Uniform Resource Identifier), decodificando in modo efficace la stringa con codifica URI.

uriComponentToString('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	string	Stringa con codifica URI da decodificare

Valore restituito	Tipo	Descrizione
<binary-for-encoded-uri>	string	Versione decodificata della stringa con codifica URI

Esempio

Questo esempio crea la versione stringa decodificata di una stringa con codifica URI:

uriComponentToString('http%3A%2F%2Fcontoso.com')

E restituisce il risultato https://contoso.com.

uriHost

Restituisce il valore host di un URI (Uniform Resource Identifier).

uriHost('<uri>')

Parametro	Obbligatorio	Type	Descrizione
<uri>	Sì	string	URI di cui si vuole il valore host

Valore restituito	Tipo	Descrizione
<host-value>	string	Valore host dell'URI specificato

Esempio

In questo esempio viene trovato il valore host dell'URI seguente:

uriHost('https://www.localhost.com:8080')

E restituisce il risultato www.localhost.com.

uriPath

Restituisce il valore relativo al percorso per un URI (Uniform Resource Identifier).

uriPath('<uri>')

Parametro	Obbligatorio	Type	Descrizione
<uri>	Sì	string	URI di cui si vuole il valore del percorso

Valore restituito	Tipo	Descrizione
<path-value>	string	Valore del percorso dell'URI specificato

Esempio

In questo esempio viene trovato il valore del percorso dell'URI seguente:

uriPath('http://www.contoso.com/catalog/shownew.htm?date=today')

E viene restituito il risultato /catalog/shownew.htm.

uriPathAndQuery

Restituisce il valore relativo al percorso e alla query per un URI (Uniform Resource Identifier).

uriPathAndQuery('<uri>')

Parametro	Obbligatorio	Type	Descrizione
<uri>	Sì	string	URI di cui si vuole il valore di percorso e query

Valore restituito	Tipo	Descrizione
<path-query-value>	string	Valore di percorso e query dell'URI specificato

Esempio

In questo esempio viene trovato il valore del percorso e della query dell'URI seguente:

uriPathAndQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

E viene restituito il risultato /catalog/shownew.htm?date=today.

uriPort

Restituisce il valore relativo alla porta per un URI (Uniform Resource Identifier).

uriPort('<uri>')

Parametro	Obbligatorio	Type	Descrizione
<uri>	Sì	string	URI di cui si vuole il valore del percorso

Valore restituito	Tipo	Descrizione
<port-value>	string	Valore della porta dell'URI specificato

Esempio

In questo esempio viene trovato il valore della porta dell'URI seguente:

uriPort('http://www.localhost:8080')

E viene restituito il risultato 8080.

uriQuery

Restituisce il valore relativo alla query per un URI (Uniform Resource Identifier).

uriQuery('<uri>')

Parametro	Obbligatorio	Type	Descrizione
<uri>	Sì	string	URI di cui si vuole il valore della query

Valore restituito	Tipo	Descrizione
<query-value>	string	Valore della query dell'URI specificato

Esempio

In questo esempio viene trovato il valore della query dell'URI seguente:

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

E viene restituito il risultato ?date=today.

uriScheme

Restituisce il valore relativo allo schema di un URI (Uniform Resource Identifier).

uriScheme('<uri>')

Parametro	Obbligatorio	Type	Descrizione
<uri>	Sì	string	URI di cui si vuole il valore della query

Valore restituito	Tipo	Descrizione
<scheme-value>	string	Valore dello schema dell'URI specificato

Esempio

In questo esempio viene trovato il valore dello schema dell'URI seguente:

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

E viene restituito il risultato http.

utcNow

Restituisce il timestamp corrente in un formato di impostazioni locali facoltativo come stringa.

utcNow('<format>', '<locale>'?)

Facoltativamente, è possibile specificare un formato diverso con il <parametro format>.

Parametro	Obbligatorio	Type	Descrizione
<format>	No	string	Modello di formato personalizzato. Il formato predefinito per il timestamp è il formato ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, conforme allo standard ISO 8601.
<impostazioni locali>	No	string	Impostazioni locali facoltative delle informazioni sulle impostazioni cultura

Valore restituito	Tipo	Descrizione
<current-timestamp>	string	Data e ora correnti

Esempio 1

Si supponga che la data sia 15 aprile 2018 alle 13:00:00. In questo esempio si ottiene il timestamp:

utcNow()

E viene restituito il risultato 2018-04-15T13:00:00.000Z.

Esempio 2

Si supponga che la data sia 15 aprile 2018 alle 13:00:00. Questo esempio ottiene il timestamp corrente usando il formato D facoltativo:

utcNow('D')

E restituisce il risultato Sunday, April 15, 2018.

Esempio 3

Si supponga che la data sia 15 aprile 2018 alle 13:00:00. Questo esempio ottiene il timestamp corrente usando le impostazioni locali de-DE :

utcNow('', 'de-DE')

E restituisce il risultato 15.04.18 13:00:00.

dove

Filtra in base a ogni elemento e restituire la nuova raccolta di elementi filtrati che soddisfano una condizione specifica.

where([<collection/instance>], <iteratorName>, <function>)

Parametro	Obbligatorio	Type	Descrizione
<collection/instance>	Sì	array	Raccolta con gli elementi
<iteratorName>	Sì	nome iteratore	Elemento chiave
<function>	Sì	expression	Funzione di condizione usata per filtrare gli elementi

Valore restituito	Tipo	Descrizione
<new-collection/new-object>	matrice/oggetto	Nuova raccolta in cui ogni elemento è stato filtrato con la funzione

Esempio 1

Questo esempio genera una nuova raccolta:

where(createArray(0, 1, 2, 3), x, x > 1)

E restituisce il risultato 2, 3.

Esempio 2

Questi esempi generano una nuova raccolta:

where(json("{'name': 'jack', 'age': '15'}"), x, x.value == 'jack')
where(json("{'name': 'jack', 'age': '15'}"), x=> x.value == 'jack')

E restituiscono il risultato ['name:jack', 'age:15']. Si noti che la seconda espressione è un'espressione lambda, che alcuni trovano più leggibili.

xml

Restituisce la versione XML di una stringa contenente un oggetto JSON.

xml('<value>')

Parametro	Obbligatorio	Type	Descrizione
<value>	Sì	string	Stringa con l'oggetto JSON da convertire. L'oggetto JSON deve avere una sola proprietà radice, che non può essere una matrice. Usare \ come carattere di escape per le virgolette doppie (").

Valore restituito	Tipo	Descrizione
<xml-version>	oggetto	Elemento XML codificato per la stringa o l'oggetto JSON specificato

Esempio 1

Questo esempio crea la versione XML per una stringa, che contiene un oggetto JSON:

xml(json('{ \"name\": \"Sophia Owen\" }'))

E restituisce il risultato XML:

<name>Sophia Owen</name>

Esempio 2

Si supponga di avere un oggetto JSON person, illustrato di seguito:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

Questo esempio crea la versione XML di una stringa contenente questo oggetto JSON:

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

E restituisce il risultato XML:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person

xPath

Verifica nel codice XML la presenza di nodi o valori che corrispondono a un'espressione XPath (XML Path Language) e restituisce i nodi o i valori corrispondenti. Un'espressione XPath (detta XPath) aiuta a spostarsi nella struttura di un documento XML in modo che sia possibile selezionare nodi o calcolare valori presenti nel contenuto XML.

xPath('<xml>', '<xpath>')

Parametro	Obbligatorio	Type	Descrizione
<xml>	Sì	qualsiasi	Stringa XML per eseguire la ricerca di nodi o valori che corrispondono a un valore dell'espressione XPath
<xPath>	Sì	qualsiasi	Espressione XPath usata per trovare i valori o i nodi XML corrispondenti

Valore restituito	Tipo	Descrizione
<xml-node>	XML	Nodo XML, quando solo un singolo nodo corrisponde all'espressione XPath specificata
<value>	qualsiasi	Valore di un nodo XML, quando solo un singolo valore corrisponde all'espressione XPath specificata
<[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]>	array	Matrice con tutti i valori o i nodi XML che corrispondono all'espressione XPath specificata

Esempio 1

Questo esempio trova i nodi che corrispondono al nodo <name></name> negli argomenti specificati e restituisce una matrice con i valori di tali nodi:

xPath(items, '/produce/item/name')

Gli argomenti includono la stringa items che contiene questo codice XML:

"<?xml version="1.0"?> <produce> <item> <name>Gala</name> <type>apple</type> <count>20</count> </item> <item> <name>Honeycrisp</name> <type>apple</type> <count>10</count> </item> </produce>"

Questa è la matrice risultante con i nodi corrispondenti a <name></name>:

[ <name>Gala</name>, <name>Honeycrisp</name> ]

Esempio 2

Dopo l'esempio 1, questo esempio trova i nodi che corrispondono al nodo <count></count> e somma i valori di tali nodi con la funzione sum():

xPath(xml(parameters('items')), 'sum(/produce/item/count)')

E restituisce il risultato 30.

year

Restituisce l'anno del timestamp specificato.

year('<timestamp>')

Parametro	Obbligatorio	Type	Descrizione
<timestamp>	Sì	string	Stringa contenente il timestamp

Valore restituito	Tipo	Descrizione
<year>	integer	Anno nel timestamp specificato

Esempio

In questo esempio viene valutato il timestamp per l'anno:

year('2018-03-15T00:00:00.000Z')

E viene restituito il risultato 2018.