Sdílet prostřednictvím


Výrazy a funkce pro Data Factory v Microsoft Fabric

Tento článek obsahuje podrobnosti o výrazech a funkcích podporovaných službou Data Factory v Microsoft Fabric.

Výrazy

Hodnoty výrazů v definici můžou být literály nebo výrazy, které se vyhodnocují za běhu. Příklad:

"value"

nebo

"@pipeline().parameters.password"

Výrazy se můžou objevit kdekoli v řetězcové hodnotě a vždy vést k jiné řetězcové hodnotě. Pokud je hodnota výrazem, text výrazu se extrahuje odebráním znaku at (@). Pokud je potřeba řetězec literálu, který začíná znakem @, musí být uchvácen pomocí @@. Následující příklady ukazují, jak se výrazy vyhodnocují.

Hodnota výrazu Výsledek
"parameters" Vrátí se znaky "parameters".
"parameters[1]" Vrátí se znaky parameters[1].
"@@" Vrátí se řetězec 1 znaku, který obsahuje znak @.
" @" Vrátí se řetězec 2 znaků, který obsahuje znak @.

Výrazy se mohou objevit také uvnitř řetězců pomocí funkce označované jako interpolace řetězců, ve které jsou výrazy zabaleny @{ ... }. Příklad: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Pomocí interpolace řetězců je výsledkem vždy řetězec. Řekněme, že jsem definoval myNumber jako 42 a myString jako foo:

Hodnota výrazu Výsledek
"@pipeline().parameters.myString" Vrátí foo jako řetězec.
"@{pipeline().parameters.myString}" Vrátí foo jako řetězec.
"@pipeline().parameters.myNumber" Vrátí 42 jako číslo.
"@{pipeline().parameters.myNumber}" Vrátí 42 jako řetězec.
"Odpověď je: @{pipeline().parameters.myNumber}" Vrátí řetězec Answer is: 42.
"@concat('Answer is: ', string(pipeline().parameters.myNumber)" Vrátí řetězec. Answer is: 42
"Odpověď je: @@{pipeline().parameters.myNumber}" Vrátí řetězec Answer is: @{pipeline().parameters.myNumber}.

V aktivitách toku řízení, jako je aktivita ForEach, můžete zadat pole, které se má itestrovat pro položky vlastnosti, a použít @item() k iteraci v rámci jednoho výčtu v aktivitě ForEach. Pokud jsou například položky matice: [1, 2, 3], @item() vrátí hodnotu 1 v první iteraci, 2 ve druhé iteraci a 3 ve třetí iteraci. Můžete také použít @range(0,10) podobný výraz k iteraci 10krát od 0 končící na 9.

K zaznamenání výstupu aktivity a rozhodování můžete použít @activity("název aktivity". Představte si webovou aktivitu s názvem Web1. Pro umístění výstupu první aktivity do těla druhé výraz obecně vypadá takto: @activity(Web1).output nebo @activity(Web1.output.output.data nebo něco podobného v závislosti na tom, jak vypadá výstup první aktivity.

Příklady

Příklad komplexního výrazu

Následující příklad ukazuje složitý příklad, který odkazuje na hluboké dílčí pole výstupu aktivity. Pokud chcete odkazovat na parametr kanálu, který se vyhodnocuje jako dílčí pole, použijte jako součást výstupu aktivity syntaxi [] namísto operátoru tečka (.).

@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*

Dynamické vytváření souborů a jejich pojmenování je běžným vzorem. Pojďme prozkoumat několik příkladů pojmenování dynamických souborů.

  • Připojit datum k názvu souboru: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
  • Připojení dateTime v časovém pásmu zákazníka: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
  • Čas připojení aktivační události: @concat('Test_', pipeline().TriggerTime)
  • Výstup vlastního názvu souboru v mapování Tok dat při výstupu do jednoho souboru s datem:'Test_' + toString(currentDate()) + '.csv'

Ve výše uvedených případech se vytvoří čtyři dynamické názvy souborů počínaje Test_.

Editor dynamického obsahu

Editor dynamického obsahu po dokončení úprav automaticky uchytá znaky v obsahu. Například následující obsah v editoru obsahu je interpolace řetězců pomocí funkce výrazu.

"@{toUpper('myData')}"

Editor dynamického obsahu převede nad obsah na výraz "@{toUpper('myData')}". Výsledkem tohoto výrazu je formátovaný řetězec zobrazený níže.

"MYDATA"

Nahrazení speciálních znaků

Editor dynamického obsahu automaticky uvozuje znaky, jako je dvojitá uvozovka, zpětné lomítko v obsahu po dokončení úprav. To způsobí potíže, pokud chcete nahradit spojnicový kanál nebo kartu pomocí funkce \n, \t v replace(). Dynamický obsah můžete upravit v zobrazení kódu, abyste odebrali extra \ ve výrazu, nebo můžete pomocí následujícího postupu nahradit speciální znaky pomocí jazyka výrazu:

  1. Kódování adresy URL proti původní řetězcové hodnotě
  2. Nahraďte řetězec kódovaný adresou URL, například odřádkování (%0A), návrat na začátek řádku(%0D), vodorovnou tabulátoru(%09).
  3. Dekódování adresy URL

Například proměnná companyName s novým znakem v jeho hodnotě může výraz @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) odebrat znak nového řádku.

Contoso- Corporation

Escaping single quote character

Funkce výrazů používají pro parametry řetězcové hodnoty jednu uvozovku. Pomocí dvou jednoduchých uvozovek můžete uvozovat ' znak v řetězcových funkcích. Výraz například @concat('Baba', '''s ', 'book store') vrátí následující výsledek.

Baba's book store

Proměnné oboru kanálu

Na tyto systémové proměnné lze odkazovat kdekoli v kanálu.

Název proměnné Popis
@pipeline().DataFactory Název pracovního prostoru dat nebo Synapse, ve kterém běží spuštění kanálu
@pipeline().Pipeline Název kanálu
@pipeline().RunId ID konkrétního spuštění kanálu
@pipeline().TriggerId ID aktivační události, která vyvolala kanál
@pipeline().TriggerName Název triggeru, který vyvolal kanál
@pipeline().TriggerTime Čas spuštění triggeru, který vyvolal kanál. Jedná se o čas, kdy se trigger skutečně aktivoval pro vyvolání spuštění kanálu, a může se mírně lišit od naplánovaného času triggeru.
@pipeline().GroupId ID skupiny, do které patří spuštění kanálu.
@pipeline()?. TriggeredByPipelineName Název kanálu, který aktivuje spuštění kanálu. Platí, pokud je spuštění kanálu aktivováno aktivitou ExecutePipeline. Při použití v jiných případech se vyhodnotí na hodnotu Null . Povšimněte si otazníku @pipeline()
@pipeline()?. TriggeredByPipelineRunId ID spuštění kanálu, který aktivuje spuštění kanálu. Platí, pokud je spuštění kanálu aktivováno aktivitou ExecutePipeline. Při použití v jiných případech se vyhodnotí na hodnotu Null . Povšimněte si otazníku @pipeline()

Poznámka:

Systémové proměnné pro datum a čas související s triggery (v rozsahech kanálu i triggerů) vrací data UTC ve formátu ISO 8601, 2017-06-01T22:20:00.4061448Znapříklad .

Funkce

Funkce můžete volat ve výrazech. Následující části obsahují informace o funkcích, které lze použít ve výrazu.

Datové funkce

Funkce data nebo času Úloha
Adddays Přidejte do časového razítka počet dní.
addHours Přidejte do časového razítka počet hodin.
Addminutes Přidejte do časového razítka několik minut.
addSeconds Přidejte do časového razítka několik sekund.
addToTime Přidejte do časového razítka řadu časových jednotek. Viz také getFutureTime.
convertFromUtc Převeďte časové razítko z standardu UTC (Universal Time Coordinated) na cílové časové pásmo.
convertTimeZone Převeďte časové razítko ze zdrojového časového pásma na cílové časové pásmo.
convertToUtc Převeďte časové razítko ze zdrojového časového pásma na standard UTC (Universal Time Coordinated).
denOfMonth Vrátí den součásti měsíce z časového razítka.
Dayofweek Vrátí součást dne v týdnu z časového razítka.
Dayofyear Vrátí den v roce z časového razítka.
formatDateTime Vrátí časové razítko jako řetězec ve volitelném formátu.
getFutureTime Vrátí aktuální časové razítko a zadané časové jednotky. Viz také addToTime.
getPastTime Vrátí aktuální časové razítko minus zadané časové jednotky. Viz také odečítáníFromTime.
startOfDay Vrátí začátek dne pro časové razítko.
startOfHour Vrátí začátek hodiny pro časové razítko.
startOfMonth Vrátí začátek měsíce pro časové razítko.
odečístFromTime Odečte počet časových jednotek od časového razítka. Viz také getPastTime.
Klíšťata ticks Vrátí hodnotu vlastnosti pro zadané časové razítko.
UtcNow Vrátí aktuální časové razítko jako řetězec.

Funkce řetězců

Pro práci s řetězci můžete použít tyto řetězcové funkce a také některé funkce kolekce. Řetězcové funkce fungují jenom na řetězcích.

Řetězcová funkce Úloha
Concat Zkombinujte dva nebo více řetězců a vraťte sloučený řetězec.
Endswith Zkontrolujte, jestli řetězec končí zadaným podřetězcem.
Identifikátor guid Vygenerujte globálně jedinečný identifikátor (GUID) jako řetězec.
Indexof Vrátí počáteční pozici podřetězdce.
Lastindexof Vrátí počáteční pozici posledního výskytu podřetězdce.
replace Nahraďte podřetězce zadaným řetězcem a vraťte aktualizovaný řetězec.
split Vrátí pole, které obsahuje podřetězce oddělené čárkami, od většího řetězce založeného na zadaném znaku oddělovače v původním řetězci.
Startswith Zkontrolujte, jestli řetězec začíná určitým podřetězcem.
Podřetězec Vrátí znaky z řetězce počínaje zadanou pozicí.
Tolower Vrátí řetězec ve formátu malými písmeny.
Toupper Vrátí řetězec ve formátu velkými písmeny.
Trim Odeberte počáteční a koncové prázdné znaky z řetězce a vraťte aktualizovaný řetězec.

Funkce kolekcí

Pokud chcete pracovat s kolekcemi, obecně polemi, řetězci a někdy slovníky, můžete tyto funkce kolekce používat.

Funkce Kolekce Úloha
Obsahuje Zkontrolujte, jestli kolekce obsahuje konkrétní položku.
empty Zkontrolujte, jestli je kolekce prázdná.
První Vrátí první položku z kolekce.
Průsečíku Vrátí kolekci, která obsahuje pouze společné položky v zadaných kolekcích.
join Vrátí řetězec, který obsahuje všechny položky z pole oddělené zadaným znakem.
Poslední Vrátí poslední položku z kolekce.
length Vrátí počet položek v řetězci nebo poli.
Přeskočit Odeberte položky z přední části kolekce a vraťte všechny ostatní položky.
vzít Vrátí položky z přední části kolekce.
Unie Vrátí kolekci, která obsahuje všechny položky ze zadaných kolekcí.

Logické funkce

Tyto funkce jsou užitečné v podmínkách, lze je použít k vyhodnocení libovolného typu logiky.

Logická funkce porovnání Úloha
and Zkontrolujte, jestli jsou všechny výrazy pravdivé.
equals Zkontrolujte, jestli jsou obě hodnoty ekvivalentní.
greater Zkontrolujte, jestli je první hodnota větší než druhá hodnota.
greaterOrEquals Zkontrolujte, jestli je první hodnota větší nebo rovna druhé hodnotě.
Pokud Zkontrolujte, jestli je výraz pravdivý nebo nepravda. Na základě výsledku vrátí zadanou hodnotu.
less Zkontrolujte, jestli je první hodnota menší než druhá hodnota.
lessOrEquals Zkontrolujte, jestli je první hodnota menší nebo rovna druhé hodnotě.
not Zkontrolujte, jestli je výraz nepravda.
nebo Zkontrolujte, jestli je alespoň jeden výraz pravdivý.

Převodní funkce

Tyto funkce slouží k převodu mezi jednotlivými nativními typy v jazyce:

  • string
  • integer
  • float (číslo s plovoucí řádovou čárkou)
  • boolean
  • Pole
  • Slovníky
Převodní funkce Úloha
Pole Vrátí pole z jednoho zadaného vstupu. Více vstupů naleznete v tématu createArray.
base64 Vrátí verzi zakódovanou v base64 pro řetězec.
base64ToBinary Vrátí binární verzi řetězce s kódováním base64.
base64ToString Vrátí verzi řetězce pro řetězec kódovaný v base64.
Binární Vrátí binární verzi pro vstupní hodnotu.
bool Vrátí logickou verzi pro vstupní hodnotu.
Coalesce Vrátí první hodnotu, která není null, z jednoho nebo více parametrů.
createArray Vrátí pole z více vstupů.
identifikátor dataURI Vrátí identifikátor URI dat pro vstupní hodnotu.
dataUriToBinary Vrátí binární verzi identifikátoru URI dat.
dataUriToString Vrátí verzi řetězce pro identifikátor URI dat.
decodeBase64 Vrátí verzi řetězce pro řetězec kódovaný v base64.
decodeDataUri Vrátí binární verzi identifikátoru URI dat.
decodeUriComponent Vrátí řetězec, který nahradí řídicí znaky dekódovanými verzemi.
encodeUriComponent Vrátí řetězec, který nahradí nebezpečné znaky adresy URL řídicími znaky.
float Vrátí číslo s plovoucí desetinou čárkou pro vstupní hodnotu.
int Vrátí celočíselnou verzi řetězce.
string Vrátí verzi řetězce pro vstupní hodnotu.
uriComponent Vrátí verzi zakódovanou identifikátorem URI pro vstupní hodnotu nahrazením nebezpečných znaků adresy URL řídicími znaky.
uriComponentToBinary Vrátí binární verzi řetězce kódovaného identifikátorem URI.
uriComponentToString Vrátí verzi řetězce pro řetězec kódovaný identifikátorem URI.
xml Vrátí verzi XML pro řetězec.
Xpath Zkontrolujte kód XML pro uzly nebo hodnoty, které odpovídají výrazu XPath (XML Path Language) a vrátí odpovídající uzly nebo hodnoty.

Matematické funkce

Tyto funkce lze použít pro některý z typů čísel: celá čísla a float.

Matematické funkce Úloha
add Vrátí výsledek sčítání dvou čísel.
div Vrátí výsledek dělení dvou čísel.
Max Vrátí nejvyšší hodnotu ze sady čísel nebo pole.
Min Vrátí nejnižší hodnotu ze sady čísel nebo pole.
Mod Vrátí zbytek od dělení dvou čísel.
mul Vrátí součin od vynásobení dvou čísel.
rand Vrátí náhodné celé číslo ze zadaného rozsahu.
range Vrátí celočíselnou matici, která začíná zadaným celočíselnou hodnotou.
Dílčí Vrátí výsledek od odečtení druhého čísla od prvního čísla.

Reference k funkcím

V této části jsou uvedeny všechny dostupné funkce v abecedním pořadí.

add

Vrátí výsledek sčítání dvou čísel.

add(<summand_1>, <summand_2>)
Parametr Požaduje se Type Popis
<>summand_1, <summand_2> Ano Celé číslo, plovoucí nebo smíšené Čísla, která se mají sčítat
Vrácená hodnota Typ Popis
<result-sum> Celé číslo nebo plovoucí číslo Výsledek sčítání zadaných čísel

Příklad

Tento příklad sečte zadaná čísla:

add(1, 1.5)

A vrátí tento výsledek: 2.5

Adddays

Přidejte do časového razítka počet dní.

addDays('<timestamp>', <days>, '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<Dní> Ano Celé číslo Počet kladných nebo záporných dnů, které se mají přidat
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<aktualizované časové razítko> String Časové razítko plus zadaný počet dnů

Příklad 1

Tento příklad přidá 10 dní do zadaného časového razítka:

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

A vrátí tento výsledek: "2018-03-25T00:00:0000000Z"

Příklad 2

Tento příklad odečte pět dnů od zadaného časového razítka:

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

A vrátí tento výsledek: "2018-03-10T00:00:0000000Z"

addHours

Přidejte do časového razítka počet hodin.

addHours('<timestamp>', <hours>, '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<hours> Ano Celé číslo Počet kladných nebo záporných hodin, které se mají přidat
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<aktualizované časové razítko> String Časové razítko plus zadaný počet hodin

Příklad 1

Tento příklad přidá 10 hodin do zadaného časového razítka:

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

A vrátí tento výsledek: "2018-03-15T10:00:0000000Z"

Příklad 2

Tento příklad odečte pět hodin od zadaného časového razítka:

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

A vrátí tento výsledek: "2018-03-15T10:00:0000000Z"

Addminutes

Přidejte do časového razítka několik minut.

addMinutes('<timestamp>', <minutes>, '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<minutes> Ano Celé číslo Počet kladných nebo záporných minut, které se mají přidat
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<aktualizované časové razítko> String Časové razítko plus zadaný počet minut

Příklad 1

Tento příklad přidá 10 minut do zadaného časového razítka:

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

A vrátí tento výsledek: "2018-03-15T00:20:00.0000000Z"

Příklad 2

Tento příklad odečte pět minut od zadaného časového razítka:

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

A vrátí tento výsledek: "2018-03-15T00:15:00.0000000Z"

addSeconds

Přidejte do časového razítka několik sekund.

addSeconds('<timestamp>', <seconds>, '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<Sekund> Ano Celé číslo Počet kladných nebo záporných sekund, které se mají přidat
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<aktualizované časové razítko> String Časové razítko plus zadaný počet sekund

Příklad 1

Tento příklad přidá 10 sekund do zadaného časového razítka:

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

A vrátí tento výsledek: "2018-03-15T00:00:10.0000000Z"

Příklad 2

Tento příklad odečte pět sekund od zadaného časového razítka:

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

A vrátí tento výsledek: "2018-03-15T00:00:25.0000000Z"

addToTime

Přidejte do časového razítka řadu časových jednotek. Viz také getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<interval> Ano Celé číslo Počet zadaných časových jednotek, které se mají přidat
<timeUnit> Ano String Jednotka času, která se má použít s intervalem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<aktualizované časové razítko> String Časové razítko plus zadaný počet časových jednotek

Příklad 1

Tento příklad přidá jeden den do zadaného časového razítka:

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

A vrátí tento výsledek: "2018-01-02T00:00:00.0000000Z"

Příklad 2

Tento příklad přidá jeden den do zadaného časového razítka:

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

A vrátí výsledek pomocí volitelného formátu "D": "Tuesday, January 2, 2018"

a

Zkontrolujte, jestli jsou oba výrazy pravdivé. Vrátí hodnotu true, pokud jsou oba výrazy pravdivé, nebo vrátí hodnotu false, pokud je alespoň jeden výraz false.

and(<expression1>, <expression2>)
Parametr Požaduje se Type Popis
<expression1>, <expression2> Ano Logická hodnota Výrazy ke kontrole
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Vrátí hodnotu true, pokud jsou oba výrazy pravdivé. Vrátí hodnotu false, pokud je alespoň jeden výraz false.

Příklad 1

Tyto příklady kontrolují, jestli jsou zadané logické hodnoty pravdivé:

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

A vrátí tyto výsledky:

  • První příklad: Oba výrazy jsou pravdivé, takže vrátí true.
  • Druhý příklad: Jeden výraz je false, takže vrátí false.
  • Třetí příklad: Oba výrazy jsou false, takže vrátí false.

Příklad 2

Tyto příklady kontrolují, jestli jsou zadané výrazy pravdivé:

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

A vrátí tyto výsledky:

  • První příklad: Oba výrazy jsou pravdivé, takže vrátí true.
  • Druhý příklad: Jeden výraz je false, takže vrátí false.
  • Třetí příklad: Oba výrazy jsou false, takže vrátí false.

pole

Vrátí pole z jednoho zadaného vstupu. Více vstupů najdete v tématu createArray().

array('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec pro vytvoření pole
Vrácená hodnota Typ Popis
[<hodnota>] Pole Pole obsahující jeden zadaný vstup

Příklad

Tento příklad vytvoří pole z řetězce "hello":

array('hello')

A vrátí tento výsledek: ["hello"]

base64

Vrátí verzi zakódovanou v base64 pro řetězec.

base64('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Vstupní řetězec
Vrácená hodnota Typ Popis
<base64-string> String Verze kódovaná v base64 pro vstupní řetězec

Příklad

Tento příklad převede řetězec "hello" na řetězec s kódováním base64:

base64('hello')

A vrátí tento výsledek: "aGVsbG8="

base64ToBinary

Vrátí binární verzi řetězce s kódováním base64.

base64ToBinary('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec s kódováním base64 pro převod
Vrácená hodnota Typ Popis
<binary-for-base64-string> String Binární verze řetězce s kódováním base64

Příklad

Tento příklad převede řetězec s kódováním base64 "aGVsbG8=" na binární řetězec:

base64ToBinary('aGVsbG8=')

A vrátí tento výsledek:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Vrátí verzi řetězce pro řetězec s kódováním base64 a dekóduje řetězec base64. Místo dekódováníBase64()použijte tuto funkci. I když obě funkce fungují stejným způsobem, base64ToString() preferuje se.

base64ToString('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec kódovaný v base64 pro dekódování
Vrácená hodnota Typ Popis
<dekódovaný řetězec base64> String Verze řetězce pro řetězec kódovaný v base64

Příklad

Tento příklad převede řetězec s kódováním base64 "aGVsbG8=" na pouze řetězec:

base64ToString('aGVsbG8=')

A vrátí tento výsledek: "hello"

binární

Vrátí binární verzi řetězce.

binary('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec, který se má převést
Vrácená hodnota Typ Popis
<binary-for-input-value> String Binární verze zadaného řetězce

Příklad

Tento příklad převede řetězec "hello" na binární řetězec:

binary('hello')

A vrátí tento výsledek:

"0110100001100101011011000110110001101111"

bool

Vrátí logickou verzi hodnoty.

bool(<value>)
Parametr Požaduje se Type Popis
<value> Ano Všechny Hodnota, která se má převést
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Logická verze pro zadanou hodnotu

Příklad

Tyto příklady převedou zadané hodnoty na logické hodnoty:

bool(1)
bool(0)

A vrátí tyto výsledky:

  • První příklad: true
  • Druhý příklad: false

Coalesce

Vrátí první hodnotu, která není null, z jednoho nebo více parametrů. Prázdné řetězce, prázdné pole a prázdné objekty nemají hodnotu null.

coalesce(<object_1>, <object_2>, ...)
Parametr Požaduje se Type Popis
<>object_1, <object_2>, ... Ano Libovolná, můžou kombinovat typy Jedna nebo více položek ke kontrole hodnoty null
Vrácená hodnota Typ Popis
<first-non-null-item> Všechny První položka nebo hodnota, která nemá hodnotu null. Pokud jsou všechny parametry null, vrátí tato funkce hodnotu null.

Příklad

Tyto příklady vrátí první hodnotu, která není null ze zadaných hodnot, nebo null, pokud jsou všechny hodnoty null:

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

A vrátí tyto výsledky:

  • První příklad: true
  • Druhý příklad: "hello"
  • Třetí příklad: null

concat

Zkombinujte dva nebo více řetězců a vraťte sloučený řetězec.

concat('<text1>', '<text2>', ...)
Parametr Požaduje se Type Popis
<text1>, <text2>, ... Ano String Aspoň dva řetězce ke kombinování
Vrácená hodnota Typ Popis
<text1text2...> String Řetězec vytvořený z kombinovaných vstupních řetězců

Příklad

Tento příklad kombinuje řetězce "Hello" a "World":

concat('Hello', 'World')

A vrátí tento výsledek: "HelloWorld"

obsahuje

Zkontrolujte, jestli kolekce obsahuje konkrétní položku. Vrátí hodnotu true při nalezení položky nebo vrátí hodnotu false, pokud nebyla nalezena. Tato funkce rozlišují malá a velká písmena.

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

Konkrétně tato funkce funguje na těchto typech kolekcí:

  • Řetězec pro vyhledání podřetězce
  • Pole pro vyhledání hodnoty
  • Slovník pro vyhledání klíče
Parametr Požaduje se Type Popis
<Kolekce> Ano String, Array nebo Dictionary Kolekce, která se má zkontrolovat
<value> Ano String, Array nebo Dictionary Položka, která se má najít
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Vrátí hodnotu true, když se položka najde. Vrátí hodnotu false, pokud nebyla nalezena.

Příklad 1

Tento příklad zkontroluje řetězec "hello world" pro podřetězce "world" a vrátí hodnotu true:

contains('hello world', 'world')

Příklad 2

Tento příklad zkontroluje řetězec "hello world" pro podřetězce "universe" a vrátí hodnotu false:

contains('hello world', 'universe')

convertFromUtc

Převeďte časové razítko z standardu UTC (Universal Time Coordinated) na cílové časové pásmo.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<Destinationtimezone> Ano String Název cílového časového pásma. Názvy časových pásem najdete v části Hodnoty časového pásma Microsoftu, ale možná budete muset odebrat jakoukoli interpunkci z názvu časového pásma.
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<převedené časové razítko> String Časové razítko převedené na cílové časové pásmo

Příklad 1

Tento příklad převede časové razítko na zadané časové pásmo:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

A vrátí tento výsledek: "2018-01-01T00:00:00Z"

Příklad 2

Tento příklad převede časové razítko na zadané časové pásmo a formát:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

A vrátí tento výsledek: "Monday, January 1, 2018"

convertTimeZone

Převeďte časové razítko ze zdrojového časového pásma na cílové časové pásmo.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<Sourcetimezone> Ano String Název zdrojového časového pásma. Názvy časových pásem najdete v části Hodnoty časového pásma Microsoftu, ale možná budete muset odebrat jakoukoli interpunkci z názvu časového pásma.
<Destinationtimezone> Ano String Název cílového časového pásma. Názvy časových pásem najdete v části Hodnoty časového pásma Microsoftu, ale možná budete muset odebrat jakoukoli interpunkci z názvu časového pásma.
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<převedené časové razítko> String Časové razítko převedené na cílové časové pásmo

Příklad 1

Tento příklad převede zdrojové časové pásmo na cílové časové pásmo:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

A vrátí tento výsledek: "2018-01-01T00:00:00.0000000"

Příklad 2

Tento příklad převede časové pásmo na zadané časové pásmo a formát:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

A vrátí tento výsledek: "Monday, January 1, 2018"

convertToUtc

Převeďte časové razítko ze zdrojového časového pásma na standard UTC (Universal Time Coordinated).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<Sourcetimezone> Ano String Název zdrojového časového pásma. Názvy časových pásem najdete v části Hodnoty časového pásma Microsoftu, ale možná budete muset odebrat jakoukoli interpunkci z názvu časového pásma.
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<převedené časové razítko> String Časové razítko se převedlo na UTC.

Příklad 1

Tento příklad převede časové razítko na UTC:

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

A vrátí tento výsledek: "2018-01-01T08:00:00.0000000Z"

Příklad 2

Tento příklad převede časové razítko na UTC:

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

A vrátí tento výsledek: "Monday, January 1, 2018"

createArray

Vrátí pole z více vstupů. Informace o jednotlivých vstupních polích najdete v části array().

createArray('<object1>', '<object2>', ...)
Parametr Požaduje se Type Popis
<object1>, <object2>, ... Ano Libovolná, ale ne smíšená Vytvoření pole nejméně dvěma položkami
Vrácená hodnota Typ Popis
[<object1>, <object2>, ...] Pole Pole vytvořené ze všech vstupních položek

Příklad

Tento příklad vytvoří pole z těchto vstupů:

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

A vrátí tento výsledek: ["h", "e", "l", "l", "o"]

identifikátor dataURI

Vrátí identifikátor URI (Uniform Resource Identifier) dat pro řetězec.

dataUri('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec, který se má převést
Vrácená hodnota Typ Popis
<data-uri> String Identifikátor URI dat pro vstupní řetězec

Příklad

Tento příklad vytvoří identifikátor URI dat pro řetězec "hello":

dataUri('hello')

A vrátí tento výsledek: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Vrátí binární verzi identifikátoru URI (Data Uniform Resource Identifier). Tuto funkci použijte místo dekódováníDataUri(). I když obě funkce fungují stejným způsobem, dataUriBinary() preferuje se.

dataUriToBinary('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Identifikátor URI dat, který se má převést
Vrácená hodnota Typ Popis
<binary-for-data-uri> String Binární verze identifikátoru URI dat

Příklad

Tento příklad vytvoří binární verzi pro tento identifikátor URI dat:

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

A vrátí tento výsledek:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Vrátí verzi řetězce pro identifikátor URI (Uniform Resource Identifier) dat.

dataUriToString('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Identifikátor URI dat, který se má převést
Vrácená hodnota Typ Popis
<string-for-data-uri> String Verze řetězce pro identifikátor URI dat

Příklad

Tento příklad vytvoří řetězec pro tento identifikátor URI dat:

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

A vrátí tento výsledek: "hello"

denOfMonth

Vrátí den v měsíci z časového razítka.

dayOfMonth('<timestamp>')
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
Vrácená hodnota Typ Popis
<den v měsíci> Celé číslo Den v měsíci ze zadaného časového razítka

Příklad

Tento příklad vrátí číslo pro den v měsíci z tohoto časového razítka:

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

A vrátí tento výsledek: 15

Dayofweek

Vrátí den v týdnu z časového razítka.

dayOfWeek('<timestamp>')
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
Vrácená hodnota Typ Popis
<den v týdnu> Celé číslo Den v týdnu od zadaného časového razítka, kde je neděle 0, pondělí je 1 atd.

Příklad

Tento příklad vrátí číslo pro den v týdnu z tohoto časového razítka:

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

A vrátí tento výsledek: 3

Dayofyear

Vrátí den v roce z časového razítka.

dayOfYear('<timestamp>')
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
Vrácená hodnota Typ Popis
<day-of-year> Celé číslo Den v roce ze zadaného časového razítka

Příklad

Tento příklad vrátí číslo dne v roce z tohoto časového razítka:

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

A vrátí tento výsledek: 74

decodeBase64

Vrátí verzi řetězce pro řetězec s kódováním base64 a dekóduje řetězec base64. Zvažte použití base64ToString() místo decodeBase64(). I když obě funkce fungují stejným způsobem, base64ToString() preferuje se.

decodeBase64('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec kódovaný v base64 pro dekódování
Vrácená hodnota Typ Popis
<dekódovaný řetězec base64> String Verze řetězce pro řetězec kódovaný v base64

Příklad

Tento příklad vytvoří řetězec pro řetězec kódovaný v base64:

decodeBase64('aGVsbG8=')

A vrátí tento výsledek: "hello"

decodeDataUri

Vrátí binární verzi identifikátoru URI (Data Uniform Resource Identifier). Zvažte použití dataUriToBinary() místo decodeDataUri(). I když obě funkce fungují stejným způsobem, dataUriToBinary() preferuje se.

decodeDataUri('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec identifikátoru URI dat pro dekódování
Vrácená hodnota Typ Popis
<binary-for-data-uri> String Binární verze řetězce identifikátoru URI dat

Příklad

Tento příklad vrátí binární verzi tohoto identifikátoru URI dat:

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

A vrátí tento výsledek:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Vrátí řetězec, který nahradí řídicí znaky dekódovanými verzemi.

decodeUriComponent('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec s řídicími znaky pro dekódování
Vrácená hodnota Typ Popis
<dekódovaný identifikátor URI> String Aktualizovaný řetězec s dekódovanými řídicími znaky

Příklad

Tento příklad nahradí řídicí znaky v tomto řetězci dekódovanými verzemi:

decodeUriComponent('http%3A%2F%2Fcontoso.com')

A vrátí tento výsledek: "https://contoso.com"

div

Vrátí celočíselnou výsledek dělení dvou čísel. Pokud chcete získat výsledek zbytku, podívejte se na mod().

div(<dividend>, <divisor>)
Parametr Požaduje se Type Popis
<Dividenda> Ano Celé číslo nebo plovoucí číslo Číslo, které se má dělit dělitelem
<Dělitel> Ano Celé číslo nebo plovoucí číslo Číslo, které dělí dividendu, ale nemůže být 0
Vrácená hodnota Typ Popis
<quotient-result> Celé číslo Celé číslo je výsledkem vydělení prvního čísla druhým číslem.

Příklad

Oba příklady vydělují první číslo druhým číslem:

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

A vrátit tento výsledek: 2

encodeUriComponent

Vrácení verze zakódovaného identifikátoru URI (Uniform Resource Identifier) pro řetězec nahrazením nebezpečných znaků ADRESY URL řídicími znaky. Zvažte použití funkce uriComponent() místo encodeUriComponent(). I když obě funkce fungují stejným způsobem, uriComponent() preferuje se.

encodeUriComponent('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec pro převod na formát kódovaný identifikátorem URI
Vrácená hodnota Typ Popis
<encoded-uri> String Řetězec kódovaný identifikátorem URI s řídicími znaky

Příklad

Tento příklad vytvoří verzi kódovanou identifikátorem URI pro tento řetězec:

encodeUriComponent('https://contoso.com')

A vrátí tento výsledek: "http%3A%2F%2Fcontoso.com"

empty

Zkontrolujte, jestli je kolekce prázdná. Vrátí hodnotu true, pokud je kolekce prázdná, nebo vrátí hodnotu false, pokud není prázdná.

empty('<collection>')
empty([<collection>])
Parametr Požaduje se Type Popis
<Kolekce> Ano Řetězec, pole nebo objekt Kolekce, která se má zkontrolovat
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Vrátí hodnotu true, pokud je kolekce prázdná. Vrátí hodnotu false, pokud není prázdná.

Příklad

Tyto příklady kontrolují, jestli jsou zadané kolekce prázdné:

empty('')
empty('abc')

A vrátí tyto výsledky:

  • První příklad: Předá prázdný řetězec, takže funkce vrátí true.
  • Druhý příklad: Předá řetězec "abc", takže funkce vrátí false.

Endswith

Zkontrolujte, jestli řetězec končí určitým podřetězcem. Vrátí hodnotu true při nalezení podřetětěce nebo vrátí hodnotu false, pokud nebyl nalezen. Tato funkce nerozlišuje malá a velká písmena.

endsWith('<text>', '<searchText>')
Parametr Požaduje se Type Popis
<text> Ano String Řetězec, který chcete zkontrolovat
<searchText> Ano String Koncový podřetětěc, který se má najít
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Vrátí hodnotu true při nalezení koncového podřetětěce. Vrátí hodnotu false, pokud nebyla nalezena.

Příklad 1

Tento příklad zkontroluje, jestli řetězec "hello world" končí řetězcem "world":

endsWith('hello world', 'world')

A vrátí tento výsledek: true

Příklad 2

Tento příklad zkontroluje, jestli řetězec "hello world" končí řetězcem "universe":

endsWith('hello world', 'universe')

A vrátí tento výsledek: false

rovná se

Zkontrolujte, jestli jsou obě hodnoty, výrazy nebo objekty ekvivalentní. Vrátí hodnotu true, pokud jsou obě ekvivalentní, nebo vrátí hodnotu false, pokud nejsou ekvivalentní.

equals('<object1>', '<object2>')
Parametr Požaduje se Type Popis
<object1>, <object2> Ano Různé Hodnoty, výrazy nebo objekty pro porovnání
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Vrátí hodnotu true, pokud jsou obě ekvivalentní. Vrátí hodnotu false, pokud není ekvivalentní.

Příklad

Tyto příklady kontrolují, jestli jsou zadané vstupy ekvivalentní.

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

A vrátí tyto výsledky:

  • První příklad: Obě hodnoty jsou ekvivalentní, takže funkce vrátí true.
  • Druhý příklad: Obě hodnoty nejsou ekvivalentní, takže funkce vrátí false.

1\.

Vrátí první položku z řetězce nebo pole.

first('<collection>')
first([<collection>])
Parametr Požaduje se Type Popis
<Kolekce> Ano Řetězec nebo pole Kolekce, kde najít první položku
Vrácená hodnota Typ Popis
<first-collection-item> Všechny První položka v kolekci

Příklad

V těchto příkladech najdete první položku v těchto kolekcích:

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

A vrátí tyto výsledky:

  • První příklad: "h"
  • Druhý příklad: 0

float (číslo s plovoucí řádovou čárkou)

Převede verzi řetězce čísla s plovoucí desetinnou čárkou na skutečné číslo s plovoucí desetinnou čárkou.

float('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec, který má platné číslo s plovoucí desetinnou čárkou pro převod
Vrácená hodnota Typ Popis
<float-value> Float Číslo s plovoucí desetinnou čárkou pro zadaný řetězec

Příklad

Tento příklad vytvoří verzi řetězce pro toto číslo s plovoucí desetinnou čárkou:

float('10.333')

A vrátí tento výsledek: 10.333

formatDateTime

Vrátí časové razítko v zadaném formátu.

formatDateTime('<timestamp>', '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<přeformátované časové razítko> String Aktualizované časové razítko v zadaném formátu

Příklad

Tento příklad převede časové razítko na zadaný formát:

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

A vrátí tento výsledek: "2018-03-15T12:00:00"

getFutureTime

Vrátí aktuální časové razítko a zadané časové jednotky.

getFutureTime(<interval>, <timeUnit>, <format>?)
Parametr Požaduje se Type Popis
<interval> Ano Celé číslo Počet zadaných časových jednotek, které se mají přidat
<timeUnit> Ano String Jednotka času, která se má použít s intervalem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<aktualizované časové razítko> String Aktuální časové razítko plus zadaný počet časových jednotek

Příklad 1

Předpokládejme, že aktuální časové razítko je "2018-03-01T00:00:00.000000Z". Tento příklad přidá do tohoto časového razítka pět dnů:

getFutureTime(5, 'Day')

A vrátí tento výsledek: "2018-03-06T00:00:00.0000000Z"

Příklad 2

Předpokládejme, že aktuální časové razítko je "2018-03-01T00:00:00.000000Z". Tento příklad přidá pět dnů a převede výsledek na formát "D":

getFutureTime(5, 'Day', 'D')

A vrátí tento výsledek: "Tuesday, March 6, 2018"

getPastTime

Vrátí aktuální časové razítko minus zadané časové jednotky.

getPastTime(<interval>, <timeUnit>, <format>?)
Parametr Požaduje se Type Popis
<interval> Ano Celé číslo Počet zadaných časových jednotek, které se mají odečíst
<timeUnit> Ano String Jednotka času, která se má použít s intervalem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<aktualizované časové razítko> String Aktuální časové razítko minus zadaný počet časových jednotek

Příklad 1

Předpokládejme, že aktuální časové razítko je "2018-02-01T00:00:00.000000Z". Tento příklad odečte pět dnů od tohoto časového razítka:

getPastTime(5, 'Day')

A vrátí tento výsledek: "2018-01-27T00:00:00.0000000Z"

Příklad 2

Předpokládejme, že aktuální časové razítko je "2018-02-01T00:00:00.000000Z". Tento příklad odečte pět dnů a převede výsledek na formát "D":

getPastTime(5, 'Day', 'D')

A vrátí tento výsledek: "Saturday, January 27, 2018"

greater

Zkontrolujte, jestli je první hodnota větší než druhá hodnota. Vrátí hodnotu true, pokud je první hodnota větší nebo vrátí hodnotu false, pokud je menší.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parametr Požaduje se Type Popis
<value> Ano Celé číslo, float nebo řetězec První hodnota, která zkontroluje, jestli je větší než druhá hodnota
<Compareto> Ano Celé číslo, Float nebo String Porovnávací hodnota
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Vrátí hodnotu true, pokud je první hodnota větší než druhá hodnota. Vrátí hodnotu false, pokud je první hodnota rovna nebo menší než druhá hodnota.

Příklad

Tyto příklady kontrolují, jestli je první hodnota větší než druhá hodnota:

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

A vrátí tyto výsledky:

  • První příklad: true
  • Druhý příklad: false

greaterOrEquals

Zkontrolujte, jestli je první hodnota větší nebo rovna druhé hodnotě. Vrátí hodnotu true, pokud je první hodnota větší nebo rovna, nebo vrátí hodnotu false, pokud je první hodnota menší.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parametr Požaduje se Type Popis
<value> Ano Celé číslo, float nebo řetězec První hodnota, která zkontroluje, jestli je větší nebo rovna druhé hodnotě
<Compareto> Ano Celé číslo, Float nebo String Porovnávací hodnota
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Vrátí hodnotu true, pokud je první hodnota větší nebo rovna druhé hodnotě. Vrátí hodnotu false, pokud je první hodnota menší než druhá hodnota.

Příklad

Tyto příklady kontrolují, jestli je první hodnota větší nebo rovna druhé hodnotě:

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

A vrátí tyto výsledky:

  • První příklad: true
  • Druhý příklad: false

guid

Vygenerujte globálně jedinečný identifikátor (GUID) jako řetězec, například "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Můžete také zadat jiný formát identifikátoru GUID než výchozí formát "D", což je 32 číslic oddělených pomlčkami.

guid('<format>')
Parametr Požaduje se Type Popis
<format> No String Specifikátor jednoho formátu pro vrácený identifikátor GUID. Ve výchozím nastavení je formát "D", ale můžete použít "N", "D", "B", "P" nebo "X".
Vrácená hodnota Typ Popis
<Hodnota GUID> String Náhodně vygenerovaný identifikátor GUID

Příklad

Tento příklad vygeneruje stejný identifikátor GUID, ale jako 32 číslic oddělených pomlčkami a uzavřených v závorkách:

guid('P')

A vrátí tento výsledek: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

Zkontrolujte, jestli je výraz pravdivý nebo nepravda. Na základě výsledku vrátí zadanou hodnotu.

if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parametr Požaduje se Type Popis
<Výraz> Ano Logická hodnota Výraz, který se má zkontrolovat
<valueIfTrue> Ano Všechny Hodnota, která se má vrátit, když je výraz pravdivý
<valueIfFalse> Ano Všechny Hodnota, která se má vrátit, když je výraz nepravda
Vrácená hodnota Typ Popis
<zadaná návratová hodnota> Všechny Zadaná hodnota, která se vrátí na základě toho, jestli je výraz pravdivý nebo nepravda

Příklad

Tento příklad vrátí hodnotu "yes" , protože zadaný výraz vrátí hodnotu true. V opačném případě vrátí "no"příklad:

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

Indexof

Vrátí počáteční pozici nebo hodnotu indexu podřetězdce. Tato funkce nerozlišuje malá a velká písmena a indexy začínají číslem 0.

indexOf('<text>', '<searchText>')
Parametr Požaduje se Type Popis
<text> Ano String Řetězec s podřetězcem, který se má najít
<searchText> Ano String Podřetětěr, který se má najít
Vrácená hodnota Typ Popis
<index-value> Celé číslo Počáteční pozice nebo hodnota indexu pro zadaný podřetězdec.
Pokud se řetězec nenajde, vraťte číslo -1.

Příklad

Tento příklad najde počáteční hodnotu indexu pro podřetězce "world" v řetězci "hello world":

indexOf('hello world', 'world')

A vrátí tento výsledek: 6

int

Vrátí celočíselnou verzi řetězce.

int('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec, který se má převést
Vrácená hodnota Typ Popis
<integer-result> Celé číslo Celočíselná verze zadaného řetězce

Příklad

Tento příklad vytvoří celočíselnou verzi řetězce "10":

int('10')

A vrátí tento výsledek: 10

json

Vrátí hodnotu typu JSON (JavaScript Object Notation) nebo objekt pro řetězec nebo XML.

json('<value>')
Parametr Požaduje se Type Popis
<value> Ano Řetězec nebo XML Řetězec nebo XML pro převod
Vrácená hodnota Typ Popis
<Výsledek JSON> Nativní typ nebo objekt JSON Hodnota nebo objekt nativního typu JSON pro zadaný řetězec nebo XML. Pokud je řetězec null, vrátí funkce prázdný objekt.

Příklad 1

Tento příklad převede tento řetězec na hodnotu JSON:

json('[1, 2, 3]')

A vrátí tento výsledek: [1, 2, 3]

Příklad 2

Tento příklad převede tento řetězec na JSON:

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

A vrátí tento výsledek:

{
  "fullName": "Sophia Owen"
}

Příklad 3

Tento příklad převede tento KÓD XML na JSON:

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

A vrátí tento výsledek:

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

Průsečíku

Vrátí kolekci, která obsahuje pouze společné položky v zadaných kolekcích. Aby se položka zobrazila ve výsledku, musí se zobrazit ve všech kolekcích předaných této funkci. Pokud má jedna nebo více položek stejný název, zobrazí se ve výsledku poslední položka s tímto názvem.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parametr Požaduje se Type Popis
<collection1>, <collection2>, ... Ano Matice nebo objekt, ale ne obojí Kolekce, ze kterých chcete jenom společné položky
Vrácená hodnota Typ Popis
<společné položky> Pole nebo objekt, v uvedeném pořadí Kolekce, která obsahuje pouze společné položky v zadaných kolekcích

Příklad

Tento příklad najde společné položky v těchto polích:

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

A vrátí pole pouze s těmito položkami:[1, 2]

join

Vrátí řetězec, který obsahuje všechny položky z pole a má každý znak oddělený oddělovačem.

join([<collection>], '<delimiter>')
Parametr Požaduje se Type Popis
<Kolekce> Ano Pole Pole, které obsahuje položky ke spojení
<Oddělovač> Ano String Oddělovač, který se zobrazí mezi jednotlivými znaky ve výsledném řetězci
Vrácená hodnota Typ Popis
<znak 1><oddělovač><char2...>>< String Výsledný řetězec vytvořený ze všech položek v zadaném poli

Příklad

Tento příklad vytvoří řetězec ze všech položek v tomto poli se zadaným znakem jako oddělovačem:

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

A vrátí tento výsledek: "a.b.c"

Poslední

Vrátí poslední položku z kolekce.

last('<collection>')
last([<collection>])
Parametr Požaduje se Type Popis
<Kolekce> Ano Řetězec nebo pole Kolekce, kde najít poslední položku
Vrácená hodnota Typ Popis
<last-collection-item> Řetězec nebo pole v uvedeném pořadí Poslední položka v kolekci

Příklad

V těchto příkladech najdete poslední položku v těchto kolekcích:

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

A vrátí tyto výsledky:

  • První příklad: "d"
  • Druhý příklad: 3

Lastindexof

Vrátí počáteční pozici nebo hodnotu indexu pro poslední výskyt podřetězdce. Tato funkce nerozlišuje malá a velká písmena a indexy začínají číslem 0.

lastIndexOf('<text>', '<searchText>')
Parametr Požaduje se Type Popis
<text> Ano String Řetězec s podřetězcem, který se má najít
<searchText> Ano String Podřetětěr, který se má najít
Vrácená hodnota Typ Popis
<end-index-value> Celé číslo Počáteční pozice nebo hodnota indexu pro poslední výskyt zadaného podřetězdce.
Pokud se řetězec nenajde, vraťte číslo -1.

Příklad

Tento příklad najde počáteční hodnotu indexu posledního výskytu podřetězce "world" v řetězci "hello world":

lastIndexOf('hello world', 'world')

A vrátí tento výsledek: 6

length

Vrátí počet položek v kolekci.

length('<collection>')
length([<collection>])
Parametr Požaduje se Type Popis
<Kolekce> Ano Řetězec nebo pole Kolekce s položkami, které se mají spočítat
Vrácená hodnota Typ Popis
<délka nebo počet> Celé číslo Počet položek v kolekci

Příklad

Tyto příklady spočítají počet položek v těchto kolekcích:

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

A vrátit tento výsledek: 4

less

Zkontrolujte, jestli je první hodnota menší než druhá hodnota. Vrátí hodnotu true, pokud je první hodnota menší nebo vrátí hodnotu false, pokud je první hodnota větší.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parametr Požaduje se Type Popis
<value> Ano Celé číslo, float nebo řetězec První hodnota, která zkontroluje, jestli je menší než druhá hodnota
<Compareto> Ano Celé číslo, Float nebo String Položka porovnání
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Vrátí hodnotu true, pokud je první hodnota menší než druhá hodnota. Vrátí hodnotu false, pokud je první hodnota rovna nebo větší než druhá hodnota.

Příklad

Tyto příklady kontrolují, jestli je první hodnota menší než druhá hodnota.

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

A vrátí tyto výsledky:

  • První příklad: true
  • Druhý příklad: false

lessOrEquals

Zkontrolujte, jestli je první hodnota menší nebo rovna druhé hodnotě. Vrátí hodnotu true, pokud je první hodnota menší nebo rovna, nebo vrátí hodnotu false, pokud je první hodnota více.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parametr Požaduje se Type Popis
<value> Ano Celé číslo, float nebo řetězec První hodnota, která zkontroluje, zda je menší než nebo rovna druhé hodnotě
<Compareto> Ano Celé číslo, Float nebo String Položka porovnání
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Vrátí hodnotu true, pokud je první hodnota menší nebo rovna druhé hodnotě. Vrátí hodnotu false, pokud je první hodnota větší než druhá hodnota.

Příklad

Tyto příklady kontrolují, jestli je první hodnota menší nebo rovna druhé hodnotě.

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

A vrátí tyto výsledky:

  • První příklad: true
  • Druhý příklad: false

max

Vrátí nejvyšší hodnotu ze seznamu nebo pole s čísly, která jsou na obou koncích inkluzivní.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parametr Požaduje se Type Popis
<číslo1>, <číslo2>, ... Ano Celé číslo, Float nebo obojí Sada čísel, ze kterých chcete získat nejvyšší hodnotu
[<číslo1>, <číslo2>, ...] Ano Matice – celé číslo, float nebo obojí Matice čísel, ze kterých chcete získat nejvyšší hodnotu
Vrácená hodnota Typ Popis
<max-value> Celé číslo nebo plovoucí číslo Nejvyšší hodnota v zadané matici nebo množině čísel

Příklad

Tyto příklady získají nejvyšší hodnotu ze sady čísel a pole:

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

A vrátit tento výsledek: 3

min

Vrátí nejnižší hodnotu ze sady čísel nebo pole.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parametr Požaduje se Type Popis
<číslo1>, <číslo2>, ... Ano Celé číslo, Float nebo obojí Množina čísel, ze kterých chcete nejnižší hodnotu
[<číslo1>, <číslo2>, ...] Ano Matice – celé číslo, float nebo obojí Matice čísel, ze kterých chcete nejnižší hodnotu
Vrácená hodnota Typ Popis
<min-value> Celé číslo nebo plovoucí číslo Nejnižší hodnota v zadané sadě čísel nebo zadané matice

Příklad

Tyto příklady získají nejnižší hodnotu v sadě čísel a matici:

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

A vrátit tento výsledek: 1

mod

Vrátí zbytek od dělení dvou čísel. Pokud chcete získat celočíselnou hodnotu, podívejte se na div().

mod(<dividend>, <divisor>)
Parametr Požaduje se Type Popis
<Dividenda> Ano Celé číslo nebo plovoucí číslo Číslo, které se má dělit dělitelem
<Dělitel> Ano Celé číslo nebo plovoucí číslo Číslo, které dělí dividendu, ale nemůže být 0.
Vrácená hodnota Typ Popis
<modulo-result> Celé číslo nebo plovoucí číslo Zbytek od vydělení prvního čísla druhým číslem

Příklad

Tento příklad vydělí první číslo druhým číslem:

mod(3, 2)

A vrátit tento výsledek: 1

mul

Vrátí součin od vynásobení dvou čísel.

mul(<multiplicand1>, <multiplicand2>)
Parametr Požaduje se Type Popis
<multiplikand1> Ano Celé číslo nebo plovoucí číslo Číslo, které se má vynásobit násobením2
<multiplicand2> Ano Celé číslo nebo plovoucí číslo Číslo, které násobí násobek1
Vrácená hodnota Typ Popis
<výsledek produktu> Celé číslo nebo plovoucí číslo Součin od vynásobení prvního čísla druhým číslem

Příklad

Tyto příklady násobí první číslo druhým číslem:

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

A vrátí tyto výsledky:

  • První příklad: 2
  • Druhý příklad 3

not

Zkontrolujte, jestli je výraz nepravda. Vrátí hodnotu true, pokud je výraz nepravda, nebo vrátí hodnotu false, pokud je true.

not(<expression>)
Parametr Požaduje se Type Popis
<Výraz> Ano Logická hodnota Výraz, který se má zkontrolovat
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Vrátí hodnotu true, pokud je výraz false. Vrátí hodnotu false, pokud je výraz pravdivý.

Příklad 1

Tyto příklady kontrolují, jestli jsou zadané výrazy nepravdivé:

not(false)
not(true)

A vrátí tyto výsledky:

  • První příklad: Výraz je false, takže funkce vrátí true.
  • Druhý příklad: Výraz je pravdivý, takže funkce vrátí false.

Příklad 2

Tyto příklady kontrolují, jestli jsou zadané výrazy nepravdivé:

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

A vrátí tyto výsledky:

  • První příklad: Výraz je false, takže funkce vrátí true.
  • Druhý příklad: Výraz je pravdivý, takže funkce vrátí false.

nebo

Zkontrolujte, jestli je alespoň jeden výraz pravdivý. Vrátí hodnotu true, pokud má aspoň jeden výraz hodnotu true, nebo vrátí hodnotu false, pokud jsou obě hodnoty false.

or(<expression1>, <expression2>)
Parametr Požaduje se Type Popis
<expression1>, <expression2> Ano Logická hodnota Výrazy ke kontrole
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Vrátí hodnotu true, pokud je alespoň jeden výraz pravdivý. Vrátí hodnotu false, pokud oba výrazy jsou false.

Příklad 1

Tyto příklady kontrolují, jestli je alespoň jeden výraz pravdivý:

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

A vrátí tyto výsledky:

  • První příklad: Alespoň jeden výraz je pravdivý, takže funkce vrátí true.
  • Druhý příklad: Oba výrazy jsou false, takže funkce vrátí false.

Příklad 2

Tyto příklady kontrolují, jestli je alespoň jeden výraz pravdivý:

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

A vrátí tyto výsledky:

  • První příklad: Alespoň jeden výraz je pravdivý, takže funkce vrátí true.
  • Druhý příklad: Oba výrazy jsou false, takže funkce vrátí false.

rand

Vrátí náhodné celé číslo ze zadaného rozsahu, které je inkluzivní pouze na počátečním konci.

rand(<minValue>, <maxValue>)
Parametr Požaduje se Type Popis
<Minvalue> Ano Celé číslo Nejnižší celé číslo v rozsahu
<Maxvalue> Ano Celé číslo Celé číslo, které následuje za nejvyšším celočíselnou oblastí, kterou může funkce vrátit
Vrácená hodnota Typ Popis
<náhodný výsledek> Celé číslo Náhodné celé číslo vrácené ze zadaného rozsahu

Příklad

Tento příklad získá náhodné celé číslo ze zadaného rozsahu s výjimkou maximální hodnoty:

rand(1, 5)

A vrátí jedno z těchto čísel jako výsledek: 1, 2, 3, nebo 4

range

Vrátí celočíselnou matici, která začíná zadaným celočíselnou hodnotou.

range(<startIndex>, <count>)
Parametr Požaduje se Type Popis
<Startindex> Ano Celé číslo Celočíselná hodnota, která spouští matici jako první položku
<count> Ano Celé číslo Počet celých čísel v matici
Vrácená hodnota Typ Popis
[<range-result>] Pole Pole s celými čísly počínaje zadaným indexem

Příklad

Tento příklad vytvoří celočíselnou matici, která začíná zadaným indexem a má zadaný počet celých čísel:

range(1, 4)

A vrátí tento výsledek: [1, 2, 3, 4]

replace

Nahraďte podřetězce zadaným řetězcem a vraťte výsledný řetězec. Tato funkce rozlišují malá a velká písmena.

replace('<text>', '<oldText>', '<newText>')
Parametr Požaduje se Type Popis
<text> Ano String Řetězec, který má podřetězce nahradit
<oldText> Ano String Podřetětět, který se má nahradit
<newText> Ano String Náhradní řetězec
Vrácená hodnota Typ Popis
<aktualizovaný text> String Aktualizovaný řetězec po nahrazení podřetězce
Pokud se podřetězce nenajde, vraťte původní řetězec.

Příklad

Tento příklad najde podřetězce "starý" v "starém řetězci" a nahradí "old" slovem "new":

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

A vrátí tento výsledek: "the new string"

skip

Odeberte položky z přední části kolekce a vraťte všechny ostatní položky.

skip([<collection>], <count>)
Parametr Požaduje se Type Popis
<Kolekce> Ano Pole Kolekce, jejíž položky chcete odebrat
<count> Ano Celé číslo Kladné celé číslo pro počet položek, které se mají odebrat na přední straně
Vrácená hodnota Typ Popis
[<updated-collection>] Pole Aktualizovaná kolekce po odebrání zadaných položek

Příklad

Tento příklad odebere jednu položku, číslo 0, zepředu zadaného pole:

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

A vrátí toto pole se zbývajícími položkami: [1,2,3]

split

Vrátí pole obsahující podřetězce oddělené čárkami na základě zadaného znaku oddělovače v původním řetězci.

split('<text>', '<delimiter>')
Parametr Požaduje se Type Popis
<text> Ano String Řetězec, který se má oddělit do podřetězců na základě zadaného oddělovače v původním řetězci
<Oddělovač> Ano String Znak v původním řetězci, který se má použít jako oddělovač
Vrácená hodnota Typ Popis
[<podřetěžk1,podřetěžk2>><,...] Pole Pole obsahující podřetězce z původního řetězce oddělené čárkami

Příklad

Tento příklad vytvoří pole s podřetězci ze zadaného řetězce na základě zadaného znaku jako oddělovače:

split('a_b_c', '_')

A vrátí toto pole jako výsledek: ["a","b","c"]

startOfDay

Vrátí začátek dne pro časové razítko.

startOfDay('<timestamp>', '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<aktualizované časové razítko> String Zadané časové razítko, ale začíná na nulové hodině pro daný den.

Příklad

Tento příklad najde začátek dne pro toto časové razítko:

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

A vrátí tento výsledek: "2018-03-15T00:00:00.0000000Z"

startOfHour

Vrátí začátek hodiny pro časové razítko.

startOfHour('<timestamp>', '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<aktualizované časové razítko> String Zadané časové razítko, ale počínaje značkou nula minut pro hodinu

Příklad

Tento příklad najde začátek hodiny pro toto časové razítko:

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

A vrátí tento výsledek: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Vrátí začátek měsíce pro časové razítko.

startOfMonth('<timestamp>', '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<aktualizované časové razítko> String Zadané časové razítko, ale začíná prvním dnem v měsíci na nulové hodině

Příklad

Tento příklad vrátí začátek měsíce pro toto časové razítko:

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

A vrátí tento výsledek: "2018-03-01T00:00:00.0000000Z"

Startswith

Zkontrolujte, jestli řetězec začíná určitým podřetězcem. Vrátí hodnotu true při nalezení podřetětěce nebo vrátí hodnotu false, pokud nebyl nalezen. Tato funkce nerozlišuje malá a velká písmena.

startsWith('<text>', '<searchText>')
Parametr Požaduje se Type Popis
<text> Ano String Řetězec, který chcete zkontrolovat
<searchText> Ano String Počáteční řetězec, který se má najít
Vrácená hodnota Typ Popis
true nebo false Logická hodnota Vrátí hodnotu true při nalezení počátečního podřetězdce. Vrátí hodnotu false, pokud nebyla nalezena.

Příklad 1

Tento příklad zkontroluje, jestli řetězec "hello world" začíná podřetězcem "hello":

startsWith('hello world', 'hello')

A vrátí tento výsledek: true

Příklad 2

Tento příklad zkontroluje, jestli řetězec "hello world" začíná podřetězcem "greetings":

startsWith('hello world', 'greetings')

A vrátí tento výsledek: false

string

Vrátí verzi řetězce pro hodnotu.

string(<value>)
Parametr Požaduje se Type Popis
<value> Ano Všechny Hodnota, která se má převést
Vrácená hodnota Typ Popis
<řetězcová hodnota> String Verze řetězce pro zadanou hodnotu

Příklad 1

Tento příklad vytvoří verzi řetězce pro toto číslo:

string(10)

A vrátí tento výsledek: "10"

Příklad 2

Tento příklad vytvoří řetězec pro zadaný objekt JSON a použije zpětné lomítko (\) jako řídicí znak pro uvozovky (").

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

A vrátí tento výsledek: "{ \\"name\\": \\"Sophie Owen\\" }"

předmět

Vrátí výsledek od odečtení druhého čísla od prvního čísla.

sub(<minuend>, <subtrahend>)
Parametr Požaduje se Type Popis
<minuend> Ano Celé číslo nebo plovoucí číslo Číslo, od kterého se má odečíst subtrahend
<subtrahend> Ano Celé číslo nebo plovoucí číslo Číslo, které se má odečíst od minuendu
Vrácená hodnota Typ Description
<Výsledek> Celé číslo nebo plovoucí číslo Výsledek od odečtení druhého čísla od prvního čísla

Příklad

Tento příklad odečte druhé číslo od prvního čísla:

sub(10.3, .3)

A vrátí tento výsledek: 10

Podřetězec

Vrátí znaky z řetězce, počínaje zadanou pozicí nebo indexem. Hodnoty indexu začínají číslem 0.

substring('<text>', <startIndex>, <length>)
Parametr Požaduje se Type Popis
<text> Ano String Řetězec, jehož znaky chcete
<Startindex> Ano Celé číslo Kladné číslo, které se rovná nebo větší než 0, které chcete použít jako počáteční pozici nebo hodnotu indexu
<length> Ano Celé číslo Požadovaný počet znaků v podřetědci
Vrácená hodnota Typ Popis
<výsledek podřetědce> String Podřetězce se zadaným počtem znaků počínaje zadaným umístěním indexu ve zdrojovém řetězci

Příklad

Tento příklad vytvoří podřetězec s pěti znaky ze zadaného řetězce počínaje hodnotou indexu 6:

substring('hello world', 6, 5)

A vrátí tento výsledek: "world"

odečístFromTime

Odečte počet časových jednotek od časového razítka. Viz také getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec obsahující časové razítko
<interval> Ano Celé číslo Počet zadaných časových jednotek, které se mají odečíst
<timeUnit> Ano String Jednotka času, která se má použít s intervalem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<aktualizované časové razítko> String Časové razítko minus zadaný počet časových jednotek

Příklad 1

Tento příklad odečte jeden den od tohoto časového razítka:

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

A vrátí tento výsledek: "2018-01-01T00:00:00:0000000Z"

Příklad 2

Tento příklad odečte jeden den od tohoto časového razítka:

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

A vrátí tento výsledek pomocí volitelného formátu "D": "Monday, January, 1, 2018"

take

Vrátí položky z přední části kolekce.

take('<collection>', <count>)
take([<collection>], <count>)
Parametr Požaduje se Type Popis
<Kolekce> Ano Řetězec nebo pole Kolekce, jejíž položky chcete
<count> Ano Celé číslo Kladné celé číslo pro počet požadovaných položek z přední části
Vrácená hodnota Typ Popis
<podmnožina nebo [podmnožina>>]< Řetězec nebo pole v uvedeném pořadí Řetězec nebo pole se zadaným počtem položek převzatých z přední části původní kolekce

Příklad

Tyto příklady získají zadaný počet položek z přední části těchto kolekcí:

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

A vrátí tyto výsledky:

  • První příklad: "abc"
  • Druhý příklad: [0, 1, 2]

Klíšťata

ticks Vrátí hodnotu vlastnosti pro zadané časové razítko. Tick je interval 100 nanosekund.

ticks('<timestamp>')
Parametr Požaduje se Type Popis
<Časové razítko> Ano String Řetězec pro časové razítko
Vrácená hodnota Typ Popis
<ticks-number> Celé číslo Počet zaškrtnutých od 12:00:00 půlnoci, 1. ledna 0001 v gregoriánském kalendáři od časového razítka vstupu

Tolower

Vrátí řetězec ve formátu malými písmeny. Pokud znak v řetězci nemá malá písmena verze, zůstane tento znak ve vráceném řetězci beze změny.

toLower('<text>')
Parametr Požaduje se Type Popis
<text> Ano String Řetězec, který se má vrátit malými písmeny
Vrácená hodnota Typ Popis
<malá písmena> String Původní řetězec ve formátu malými písmeny

Příklad

Tento příklad převede tento řetězec na malá písmena:

toLower('Hello World')

A vrátí tento výsledek: "hello world"

Toupper

Vrátí řetězec ve formátu velkými písmeny. Pokud znak v řetězci nemá velkou verzi, zůstane tento znak ve vráceném řetězci beze změny.

toUpper('<text>')
Parametr Požaduje se Type Popis
<text> Ano String Řetězec, který se má vrátit velkými písmeny
Vrácená hodnota Typ Popis
<velká písmena – text> String Původní řetězec ve formátu velkými písmeny

Příklad

Tento příklad převede tento řetězec na velká písmena:

toUpper('Hello World')

A vrátí tento výsledek: "HELLO WORLD"

Trim

Odeberte počáteční a koncové prázdné znaky z řetězce a vraťte aktualizovaný řetězec.

trim('<text>')
Parametr Požaduje se Type Popis
<text> Ano String Řetězec s počátečním a koncovým prázdným znakem, který se má odebrat
Vrácená hodnota Typ Popis
<updatedText> String Aktualizovaná verze původního řetězce bez počátečního nebo koncového prázdného znaku

Příklad

Tento příklad odebere úvodní a koncové prázdné znaky z řetězce "Hello World":

trim(' Hello World  ')

A vrátí tento výsledek: "Hello World"

sjednocení

Vrátí kolekci, která obsahuje všechny položky ze zadaných kolekcí. Chcete-li se zobrazit ve výsledku, může se položka zobrazit v libovolné kolekci předané této funkci. Pokud má jedna nebo více položek stejný název, zobrazí se ve výsledku poslední položka s tímto názvem.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parametr Požaduje se Type Popis
<collection1>, <collection2>, ... Ano Matice nebo objekt, ale ne obojí Kolekce, ze kterých chcete všechny položky
Vrácená hodnota Typ Popis
<updatedCollection> Pole nebo objekt, v uvedeném pořadí Kolekce se všemi položkami ze zadaných kolekcí – žádné duplicity

Příklad

Tento příklad získá všechny položky z těchto kolekcí:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

A vrátí tento výsledek: [1, 2, 3, 10, 101]

uriComponent

Vrácení verze zakódovaného identifikátoru URI (Uniform Resource Identifier) pro řetězec nahrazením nebezpečných znaků ADRESY URL řídicími znaky. Místo kódováníUriComponent()použijte tuto funkci. I když obě funkce fungují stejným způsobem, uriComponent() preferuje se.

uriComponent('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec pro převod na formát kódovaný identifikátorem URI
Vrácená hodnota Typ Popis
<encoded-uri> String Řetězec kódovaný identifikátorem URI s řídicími znaky

Příklad

Tento příklad vytvoří verzi kódovanou identifikátorem URI pro tento řetězec:

uriComponent('https://contoso.com')

A vrátí tento výsledek: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Vrátí binární verzi pro součást identifikátoru URI (Uniform Resource Identifier).

uriComponentToBinary('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec kódovaný identifikátorem URI pro převod
Vrácená hodnota Typ Popis
<binary-for-encoded-uri> String Binární verze řetězce kódovaného identifikátorem URI. Binární obsah je kódován base64 a reprezentován $content.

Příklad

Tento příklad vytvoří binární verzi pro tento řetězec kódovaný identifikátorem URI:

uriComponentToBinary('http%3A%2F%2Fcontoso.com')

A vrátí tento výsledek:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Vrátí verzi řetězce pro řetězec kódovaný identifikátorem URI (Uniform Resource Identifier), který efektivně dekóduje řetězec kódovaný identifikátorem URI.

uriComponentToString('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec kódovaný identifikátorem URI pro dekódování
Vrácená hodnota Typ Popis
<dekódovaný identifikátor URI> String Dekódovaná verze řetězce kódovaného identifikátorem URI

Příklad

Tento příklad vytvoří dekódovanou verzi řetězce pro tento řetězec kódovaný identifikátorem URI:

uriComponentToString('http%3A%2F%2Fcontoso.com')

A vrátí tento výsledek: "https://contoso.com"

UtcNow

Vrátí aktuální časové razítko.

utcNow('<format>')

Volitelně můžete zadat jiný formát pomocí parametru <formátu> .

Parametr Požaduje se Type Popis
<format> No String Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Popis
<current-timestamp> String Aktuální datum a čas

Příklad 1

Předpokládejme, že dnes je 15. dubna 2018 v 13:00:00. Tento příklad získá aktuální časové razítko:

utcNow()

A vrátí tento výsledek: "2018-04-15T13:00:00.0000000Z"

Příklad 2

Předpokládejme, že dnes je 15. dubna 2018 v 13:00:00. Tento příklad získá aktuální časové razítko pomocí volitelného formátu "D":

utcNow('D')

A vrátí tento výsledek: "Sunday, April 15, 2018"

xml

Vrátí verzi XML pro řetězec, který obsahuje objekt JSON.

xml('<value>')
Parametr Požaduje se Type Popis
<value> Ano String Řetězec s objektem JSON pro převod
Objekt JSON musí mít pouze jednu kořenovou vlastnost, což nemůže být pole.
Zpětné lomítko (\) použijte jako řídicí znak uvozovek (").
Vrácená hodnota Typ Popis
<xml-version> Object Kódovaný kód XML pro zadaný řetězec nebo objekt JSON

Příklad 1

Tento příklad vytvoří verzi XML pro tento řetězec, který obsahuje objekt JSON:

xml(json('{ \"name\": \"Sophia Owen\" }'))

A vrátí tento výsledek XML:

<name>Sophia Owen</name>

Příklad 2

Předpokládejme, že máte tento objekt JSON:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

Tento příklad vytvoří XML pro řetězec, který obsahuje tento objekt JSON:

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

A vrátí tento výsledek XML:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

Xpath

Zkontrolujte kód XML pro uzly nebo hodnoty, které odpovídají výrazu XPath (XML Path Language) a vrátí odpovídající uzly nebo hodnoty. Výraz XPath nebo jen XPath vám pomůže procházet strukturu dokumentu XML, abyste mohli vybrat uzly nebo výpočetní hodnoty v obsahu XML.

xpath('<xml>', '<xpath>')
Parametr Požaduje se Type Popis
<xml> Ano Všechny Řetězec XML pro vyhledávání uzlů nebo hodnot, které odpovídají hodnotě výrazu XPath
<Xpath> Ano Všechny Výraz XPath použitý k vyhledání odpovídajících uzlů NEBO hodnot XML
Vrácená hodnota Typ Popis
<xml-node> XML Uzel XML, pokud pouze jeden uzel odpovídá zadanému výrazu XPath
<value> Všechny Hodnota z uzlu XML, pokud pouze jedna hodnota odpovídá zadanému výrazu XPath
[<xml-node1>, <xml-node2>, ...]
-or-
[<hodnota1>, <hodnota2>, ...]
Pole Pole s uzly XML nebo hodnotami, které odpovídají zadanému výrazu XPath

Příklad 1

Následující v příkladu 1 tento příklad najde uzly, které odpovídají <count></count> uzlu, a přidá tyto hodnoty uzlů s sum() funkcí:

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

A vrátí tento výsledek: 30

Příklad 2

V tomto příkladu oba výrazy najdou uzly, které odpovídají <location></location> uzlu, v zadaných argumentech, které zahrnují XML s oborem názvů. Výrazy používají zpětné lomítko (\) jako řídicí znak pro uvozovky (").

  • Výraz 1

    xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')

  • Expression 2

    xpath(xml(body('Http')), '/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]')

Tady jsou argumenty:

  • Tento KÓD XML, který obsahuje obor názvů dokumentu XML: xmlns="http://contoso.com"

    <?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>
    
  • Výraz XPath:

    • /*[name()=\"file\"]/*[name()=\"location\"]

    • /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

Tady je výsledný uzel, který odpovídá <location></location> uzlu:

<location xmlns="https://contoso.com">Paris</location>

Příklad 3

V příkladu 3 tento příklad najde hodnotu v <location></location> uzlu:

xpath(xml(body('Http')), 'string(/*[name()=\"file\"]/*[name()=\"location\"])')

A vrátí tento výsledek: "Paris"

Poznámka:

Můžete přidat komentáře k výrazům toku dat, ale ne ve výrazech kanálu.

Pokyny k obecnému použití parametrů najdete v tématu Parametry služby Data Factory v prostředcích infrastruktury.