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.

Expressions

Hodnoty výrazů v definici můžou být literály nebo výrazy, které se vyhodnocují za běhu. Napří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 Result
"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 Result
"@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.

Examples

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í toku 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 in 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), vodorovná tabulátor(%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é Description
@pipeline().DataFactory ID pracovního prostoru, ve kterém běží spuštění kanálu
@pipeline().Pipeline ID kanálu
@pipeline().PipelineName 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 .

Functions

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

Datumové funkce

Funkce data nebo času Task
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.
denOfWeek Vrátí součást dne v týdnu z časového razítka.
denOfYear 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.
tiká ticks Vrátí hodnotu vlastnosti pro zadané časové razítko.
UtcNow Vrátí aktuální časové razítko jako řetězec.

Řetězcové funkce

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.

String Task
zřetězení 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.
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.
rozdělit 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ědce 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.
zastřihnout 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 Task
obsahuje Zkontrolujte, jestli kolekce obsahuje konkrétní položku.
prázdné Zkontrolujte, jestli je kolekce prázdná.
první Vrátí první položku z kolekce.
křižovatka Vrátí kolekci, která obsahuje pouze společné položky v zadaných kolekcích.
připojit 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.
délka 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.
svaz 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í Task
a Zkontrolujte, jestli jsou všechny výrazy pravdivé.
rovná se Zkontrolujte, jestli jsou obě hodnoty ekvivalentní.
větší Zkontrolujte, jestli je první hodnota větší než druhá hodnota.
greaterOrEquals Zkontrolujte, jestli je první hodnota větší nebo rovna druhé hodnotě.
if Zkontrolujte, jestli je výraz pravdivý nebo nepravda. Na základě výsledku vrátí zadanou hodnotu.
méně Zkontrolujte, jestli je první hodnota menší než druhá hodnota.
lessOrEquals Zkontrolujte, jestli je první hodnota menší nebo rovna druhé hodnotě.
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:

  • řetězec
  • integer
  • float
  • Boolean
  • pole
  • slovníky
Převodní funkce Task
array 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.
splynout 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.
plout 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 Task
add Vrátí výsledek sčítání dvou čísel.
Div Vrátí výsledek dělení dvou čísel.
maximální Vrátí nejvyšší hodnotu ze sady čísel nebo pole.
min. Vrátí nejnižší hodnotu ze sady čísel nebo pole.
zkratka modulo 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.
rozmezí Vrátí celočíselnou matici, která začíná zadaným celočíselnou hodnotou.
pod Vrátí výsledek od odečtení druhého čísla od prvního čísla.

Referenční informace 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>)
Parameter Povinné Typ Description
< >summand_1, <summand_2> Ano Celé číslo, plovoucí nebo smíšené Čísla, která se mají sčítat
Návratová hodnota Typ Description
< výsledek-součet> 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>'?)
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
< Dny> Ano Integer Počet kladných nebo záporných dnů, které se mají přidat
< formát> Ne 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.
Návratová hodnota Typ Description
< 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>'?)
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
< hodiny> Ano Integer Počet kladných nebo záporných hodin, které se mají přidat
< formát> Ne 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.
Návratová hodnota Typ Description
< 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>'?)
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
< minuty> Ano Integer Počet kladných nebo záporných minut, které se mají přidat
< formát> Ne 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.
Návratová hodnota Typ Description
< 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>'?)
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
< sekundy> Ano Integer Počet kladných nebo záporných sekund, které se mají přidat
< formát> Ne 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.
Návratová hodnota Typ Description
< 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>'?)
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
< Interval> Ano Integer 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"
< formát> Ne 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.
Návratová hodnota Typ Description
< 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>)
Parameter Povinné Typ Description
< expression1>, <expression2> Ano logický Výrazy ke kontrole
Návratová hodnota Typ Description
pravda nebo lež logický 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec pro vytvoření pole
Návratová hodnota Typ Description
[<hodnota>] Array 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Vstupní řetězec
Návratová hodnota Typ Description
< 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec s kódováním base64 pro převod
Návratová hodnota Typ Description
< binární-pro-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>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec kódovaný v base64 pro dekódování
Návratová hodnota Typ Description
< 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec, který se má převést
Návratová hodnota Typ Description
< binární pro vstupní hodnotu> 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"

Booleova hodnota

Vrátí logickou verzi hodnoty.

bool(<value>)
Parameter Povinné Typ Description
< hodnota> Ano Jakýkoliv Hodnota, která se má převést
Návratová hodnota Typ Description
pravda nebo lež logický 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

sloučit

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>, ...)
Parameter Povinné Typ Description
< >object_1, <object_2>, ... Ano Libovolná, můžou kombinovat typy Jedna nebo více položek ke kontrole hodnoty null
Návratová hodnota Typ Description
< První-ne-nulová položka> Jakýkoliv 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>', ...)
Parameter Povinné Typ Description
< text1>, <text2>, ... Ano String Aspoň dva řetězce ke kombinování
Návratová hodnota Typ Description
< 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"

contains

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
Parameter Povinné Typ Description
< sbírka> Ano String, Array nebo Dictionary Kolekce, která se má zkontrolovat
< hodnota> Ano String, Array nebo Dictionary Položka, která se má najít
Návratová hodnota Typ Description
pravda nebo lež logický 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>'?)
Parameter Povinné Typ Description
< časová značka> 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.
< formát> Ne 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.
Návratová hodnota Typ Description
< 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>'?)
Parameter Povinné Typ Description
< časová značka> 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.
< formát> Ne 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.
Návratová hodnota Typ Description
< 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>'?)
Parameter Povinné Typ Description
< časová značka> 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.
< formát> Ne 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.
Návratová hodnota Typ Description
< 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().a0>

createArray('<object1>', '<object2>', ...)
Parameter Povinné Typ Description
< objekt1>, <objekt2>, ... Ano Libovolná, ale ne smíšená Vytvoření pole nejméně dvěma položkami
Návratová hodnota Typ Description
[<objekt1>, <objekt2>, ...] Array 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"]

dataUri

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

dataUri('<value>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec, který se má převést
Návratová hodnota Typ Description
< 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Identifikátor URI dat, který se má převést
Návratová hodnota Typ Description
< 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Identifikátor URI dat, který se má převést
Návratová hodnota Typ Description
< 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>')
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
Návratová hodnota Typ Description
< den v měsíci> Integer 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

denOfWeek

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

dayOfWeek('<timestamp>')
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
Návratová hodnota Typ Description
< den v týdnu> Integer 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

denOfYear

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

dayOfYear('<timestamp>')
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
Návratová hodnota Typ Description
< Den v roce> Integer 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec kódovaný v base64 pro dekódování
Návratová hodnota Typ Description
< 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec identifikátoru URI dat pro dekódování
Návratová hodnota Typ Description
< 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec s řídicími znaky pro dekódování
Návratová hodnota Typ Description
< 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>)
Parameter Povinné Typ Description
< 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
Návratová hodnota Typ Description
< Výsledek s podílem> Integer 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec pro převod na formát kódovaný identifikátorem URI
Návratová hodnota Typ Description
< 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"

prázdný

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>])
Parameter Povinné Typ Description
< sbírka> Ano Řetězec, pole nebo objekt Kolekce, která se má zkontrolovat
Návratová hodnota Typ Description
pravda nebo lež logický 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.

končí na

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>')
Parameter Povinné Typ Description
< Text> Ano String Řetězec, který chcete zkontrolovat
< searchText> Ano String Koncový podřetětěc, který se má najít
Návratová hodnota Typ Description
pravda nebo lež logický 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

equals

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>')
Parameter Povinné Typ Description
< objekt1>, <objekt2> Ano Různý Hodnoty, výrazy nebo objekty pro porovnání
Návratová hodnota Typ Description
pravda nebo lež logický 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.

první

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

first('<collection>')
first([<collection>])
Parameter Povinné Typ Description
< sbírka> Ano Řetězec nebo pole Kolekce, kde najít první položku
Návratová hodnota Typ Description
< První sběrná položka> Jakýkoliv 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

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

float('<value>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec, který má platné číslo s plovoucí desetinnou čárkou pro převod
Návratová hodnota Typ Description
< Float-value> Plovat Čí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>'?)
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
< formát> Ne 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.
Návratová hodnota Typ Description
< 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>?)
Parameter Povinné Typ Description
< Interval> Ano Integer 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"
< formát> Ne 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.
Návratová hodnota Typ Description
< 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>?)
Parameter Povinné Typ Description
< Interval> Ano Integer 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"
< formát> Ne 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.
Návratová hodnota Typ Description
< 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"

větší

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>')
Parameter Povinné Typ Description
< hodnota> 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
Návratová hodnota Typ Description
pravda nebo lež logický 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>')
Parameter Povinné Typ Description
< hodnota> 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
Návratová hodnota Typ Description
pravda nebo lež logický 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 (globálně unikátní identifikátor)

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>')
Parameter Povinné Typ Description
< formát> Ne 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".
Návratová hodnota Typ Description
< 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>)
Parameter Povinné Typ Description
< výraz> Ano logický Výraz, který se má zkontrolovat
< valueIfTrue> Ano Jakýkoliv Hodnota, která se má vrátit, když je výraz pravdivý
< valueIfFalse> Ano Jakýkoliv Hodnota, která se má vrátit, když je výraz nepravda
Návratová hodnota Typ Description
< zadaná návratová hodnota> Jakýkoliv 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>')
Parameter Povinné Typ Description
< 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
Návratová hodnota Typ Description
< index-value> Integer 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec, který se má převést
Návratová hodnota Typ Description
< celočíselný výsledek> Integer 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>')
Parameter Povinné Typ Description
< hodnota> Ano Řetězec nebo XML Řetězec nebo XML pro převod
Návratová hodnota Typ Description
< 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"
      } ]
   }
}

křižovatka

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>', ...)
Parameter Povinné Typ Description
< sbírka1>, <kolekce2>, ... Ano Matice nebo objekt, ale ne obojí Kolekce, ze kterých chcete jenom společné položky
Návratová hodnota Typ Description
< 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]

připojit

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>')
Parameter Povinné Typ Description
< sbírka> Ano Array 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
Návratová hodnota Typ Description
< char1><oddělovač><char2><oddělovač>... 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>])
Parameter Povinné Typ Description
< sbírka> Ano Řetězec nebo pole Kolekce, kde najít poslední položku
Návratová hodnota Typ Description
< Poslední sbírka předmětů> Ř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>')
Parameter Povinné Typ Description
< 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
Návratová hodnota Typ Description
< end-index-value> Integer 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>])
Parameter Povinné Typ Description
< sbírka> Ano Řetězec nebo pole Kolekce s položkami, které se mají spočítat
Návratová hodnota Typ Description
< délka nebo počet> Integer 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

méně

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>')
Parameter Povinné Typ Description
< hodnota> 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í
Návratová hodnota Typ Description
pravda nebo lež logický 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>')
Parameter Povinné Typ Description
< hodnota> 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í
Návratová hodnota Typ Description
pravda nebo lež logický 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>, ...])
Parameter Povinné Typ Description
< čí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
Návratová hodnota Typ Description
< 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>, ...])
Parameter Povinné Typ Description
< čí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
Návratová hodnota Typ Description
< Minimální hodnota> 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>)
Parameter Povinné Typ Description
< 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.
Návratová hodnota Typ Description
< 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>)
Parameter Povinné Typ Description
< 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
Návratová hodnota Typ Description
< 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>)
Parameter Povinné Typ Description
< výraz> Ano logický Výraz, který se má zkontrolovat
Návratová hodnota Typ Description
pravda nebo lež logický 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>)
Parameter Povinné Typ Description
< expression1>, <expression2> Ano logický Výrazy ke kontrole
Návratová hodnota Typ Description
pravda nebo lež logický 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>)
Parameter Povinné Typ Description
< Minvalue> Ano Integer Nejnižší celé číslo v rozsahu
< Maxvalue> Ano Integer Celé číslo, které následuje za nejvyšším celočíselnou oblastí, kterou může funkce vrátit
Návratová hodnota Typ Description
< náhodný výsledek> Integer 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

oblast

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

range(<startIndex>, <count>)
Parameter Povinné Typ Description
< Startindex> Ano Integer Celočíselná hodnota, která spouští matici jako první položku
< počítat> Ano Integer Počet celých čísel v matici
Návratová hodnota Typ Description
[<rozsah-výsledek>] Array 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]

nahradit

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>')
Parameter Povinné Typ Description
< 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
Návratová hodnota Typ Description
< 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"

přeskočit

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

skip([<collection>], <count>)
Parameter Povinné Typ Description
< sbírka> Ano Array Kolekce, jejíž položky chcete odebrat
< počítat> Ano Integer Kladné celé číslo pro počet položek, které se mají odebrat na přední straně
Návratová hodnota Typ Description
[<aktualizovaná sbírka>] Array 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]

rozdělit

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>')
Parameter Povinné Typ Description
< 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č
Návratová hodnota Typ Description
[<podřetěžk1,podřetěžk2><>,...] Array 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>'?)
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
< formát> Ne 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.
Návratová hodnota Typ Description
< 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>'?)
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
< formát> Ne 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.
Návratová hodnota Typ Description
< 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>'?)
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
< formát> Ne 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.
Návratová hodnota Typ Description
< 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"

začínáNa

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>')
Parameter Povinné Typ Description
< Text> Ano String Řetězec, který chcete zkontrolovat
< searchText> Ano String Počáteční řetězec, který se má najít
Návratová hodnota Typ Description
pravda nebo lež logický 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

řetězec

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

string(<value>)
Parameter Povinné Typ Description
< hodnota> Ano Jakýkoliv Hodnota, která se má převést
Návratová hodnota Typ Description
< ř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\\" }"

pod

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

sub(<minuend>, <subtrahend>)
Parameter Povinné Typ Description
< menšenec> Ano Celé číslo nebo plovoucí číslo Číslo, od kterého se má odečíst subtrahend
< menšitel> Ano Celé číslo nebo plovoucí číslo Číslo, které se má odečíst od minuendu
Návratová 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>)
Parameter Povinné Typ Description
< Text> Ano String Řetězec, jehož znaky chcete
< Startindex> Ano Integer Kladné číslo, které se rovná nebo větší než 0, které chcete použít jako počáteční pozici nebo hodnotu indexu
< délka> Ano Integer Požadovaný počet znaků v podřetědci
Návratová hodnota Typ Description
< 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>'?)
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec obsahující časové razítko
< Interval> Ano Integer 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"
< formát> Ne 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.
Návratová hodnota Typ Description
< 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"

vzít

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

take('<collection>', <count>)
take([<collection>], <count>)
Parameter Povinné Typ Description
< sbírka> Ano Řetězec nebo pole Kolekce, jejíž položky chcete
< počítat> Ano Integer Kladné celé číslo pro počet požadovaných položek z přední části
Návratová hodnota Typ Description
< 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]

tiká

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

ticks('<timestamp>')
Parameter Povinné Typ Description
< časová značka> Ano String Řetězec pro časové razítko
Návratová hodnota Typ Description
< ticks-number> Integer 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>')
Parameter Povinné Typ Description
< Text> Ano String Řetězec, který se má vrátit malými písmeny
Návratová hodnota Typ Description
< 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>')
Parameter Povinné Typ Description
< Text> Ano String Řetězec, který se má vrátit velkými písmeny
Návratová hodnota Typ Description
< 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"

stříhat

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

trim('<text>')
Parameter Povinné Typ Description
< Text> Ano String Řetězec s počátečním a koncovým prázdným znakem, který se má odebrat
Návratová hodnota Typ Description
< aktualizovánText> 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>], ...)
Parameter Povinné Typ Description
< sbírka1>, <kolekce2>, ... Ano Matice nebo objekt, ale ne obojí Kolekce, ze kterých chcete všechny položky
Návratová hodnota Typ Description
< aktualizovaná kolekce> 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec pro převod na formát kódovaný identifikátorem URI
Návratová hodnota Typ Description
< 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec kódovaný identifikátorem URI pro převod
Návratová hodnota Typ Description
< 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>')
Parameter Povinné Typ Description
< hodnota> Ano String Řetězec kódovaný identifikátorem URI pro dekódování
Návratová hodnota Typ Description
< 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> .

Parameter Povinné Typ Description
< formát> Ne 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.
Návratová hodnota Typ Description
< aktuální časové razítko> 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>')
Parameter Povinné Typ Description
< hodnota> 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 (").
Návratová hodnota Typ Description
< xml-verze> 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>')
Parameter Povinné Typ Description
< Xml> Ano Jakýkoliv Řetězec XML pro vyhledávání uzlů nebo hodnot, které odpovídají hodnotě výrazu XPath
< Xpath> Ano Jakýkoliv Výraz XPath použitý k vyhledání odpovídajících uzlů NEBO hodnot XML
Návratová hodnota Typ Description
< xml-node> jazyk XML Uzel XML, pokud pouze jeden uzel odpovídá zadanému výrazu XPath
< hodnota> Jakýkoliv Hodnota z uzlu XML, pokud pouze jedna hodnota odpovídá zadanému výrazu XPath
[<xml-node1>, <xml-node2>, ...]
-or-
[<hodnota1>, <hodnota2>, ...]		 Array 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\"]')

  • Výraz 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.

Než je spustíte, vyhodnoťte výrazy potrubí.

Pomocí funkce Vyhodnocení výrazu v Microsoft Fabric Data Factory můžete testovat a ladit výrazy kanálu. Můžete zkontrolovat výstupy výrazů, zkontrolovat jednotlivé komponenty a ověřit logiku bez spuštění celého kanálu.

Co můžete dělat s funkcí vyhodnocení výrazu:

  • Kontrola konečného výstupu
  • Zkontrolujte jednotlivé části výrazu (parametry, proměnné, funkce, systémové proměnné).
  • Zadejte ukázkové hodnoty pro položky, které existují pouze při spuštění kanálu.

Tímto způsobem můžete před naplánováním nebo spuštěním kanalizačního vedení potvrdit, že logika a formátování správně fungují.

Snímek obrazovky funkce Vyhodnocení výrazu zobrazující vyhodnocení dynamického obsahu

Kdy použít funkci vyhodnocovat výraz

Tady je několik způsobů, jak vám může funkce Vyhodnocovat výraz pomoct:

  • Potvrďte konečný řetězec nebo hodnotu, kterou výraz vrací (například cesta ke složce s datem nebo formátovaný název souboru).
  • Zkontrolujte, jestli parametry a proměnné ve výrazu fungují správně.
  • Testování kombinací funkcí (řetězec, datum a čas, matematika) a okamžité zobrazení výsledků
  • Zadejte ukázkové vstupy pro položky, které existují pouze během skutečného spuštění kanálu (například hodnoty triggeru nebo výstupy aktivit).

Jak používat funkci vyhodnocovat výraz

  1. Otevřete tvůrce výrazů v potrubí.

    Snímek obrazovky s aktivitou Outlooku s možností zobrazit v tvůrci výrazů

  2. Zadejte nebo vložte výraz.

    Snímek obrazovky tvůrce výrazů pipeline s obsahem výrazů

  3. Vyberte Vyhodnotit výraz.

    Snímek obrazovky tlačítka Vyhodnotit výraz v editoru výrazů potrubí

  4. Projděte si část Hodnota v tabulce, která zobrazuje jednotlivé části výrazu (parametry, proměnné, systémové proměnné, funkce).

    Snímek obrazovky se vstupním polem hodnoty pro vyhodnocení dynamického obsahu

  5. Pokud některá část potřebuje ukázkovou hodnotu (například čas triggeru nebo výstup aktivity), zadejte ji do pole Hodnota .

  6. Výběrem možnosti Vyhodnotit znovu zobrazíte aktualizovaný výsledek.

    Snímek obrazovky, který ukazuje vyhodnocení dynamického obsahu a náhled výrazu

    Návod

    Panel často vyplňuje výchozí hodnoty parametrů a proměnných. Můžete je přepsat a otestovat různé scénáře.

Aktuální omezení pro vyhodnocení výrazu

V současné době probíhá vyhodnocení před spuštěním potrubí. Vyhodnocovací modul neví nic, co se děje za běhu nebo potom. Nenačítá ID spuštění, ID instance triggeru, výstupy aktivit ani žádné hodnoty, které existují pouze během spuštění. Tyto hodnoty tedy budete muset zadat ručně.

Co místo toho udělat: Ve sloupci Hodnota zadejte ukázkové hodnoty, které budou zrcadlit očekávaná data za běhu (například vložte napodobení JSON pro activity('LookupCustomers').output). Díky tomu můžete ověřit strukturu a formátování výrazu, i když kanál není spuštěný.

Vytváření výrazů datového potrubí pomocí Copilotu

Tvůrce výrazů kanálu je teď součástí integrovaného copilotu. Můžete chatovat s Copilotem přímo v tvůrci výrazů, podobně jako s ním v jiných funkcích služby Data Factory. To znamená, že můžete získat pomoc s vytvářením a porozuměním výrazům bez opuštění pracovního prostoru.

V současné době vám Copilot pomůže:

  • Tvorba výrazů pro pipeline bez ručního kódování
  • Vyhněte se chybám
  • Pracujte rychleji
  • Sestavení robustních potrubí s jistotou

K otevření sestavovače výrazů pro zpracování dat:

  1. Přidejte aktivitu, která podporuje dynamický obsah nebo výrazy.

  2. Uvnitř aktivity vyberte Zobrazit v tvůrci výrazů nebo Přidejte dynamický obsah , do kterého chcete přidat výraz.

    Snímek obrazovky v možnosti zobrazení v nástroji pro tvorbu výrazů

    Snímek obrazovky s možností přidat dynamický obsah

  3. Uvidíte tvůrce výrazů pipeline, kde najdete integrované prostředí Copilot.

    Snímek obrazovky tvůrce výrazů pro potrubí s rozhraním Copilot

Generování výrazů v přirozeném jazyce

Do chatu Copilot zadejte, co chcete. Copilot převede váš požadavek na výraz potrubí.

Můžete například zadat:

Get the current date and time in UTC. Convert the current UTC time to Central Standard Time (CST). Format the converted CST time into a string like 2025/07/10. Finally, concatenate the string "ContosoSales\\" with the formatted date.

Můžete zvolit Přijmout, Zahodit nebo Aktualizovat a zkusit znovu svůj výraz.

Vysvětlení výrazů v prostém jazyce

Copilot poskytuje jasné vysvětlení toho, co vaše výrazy potrubí dělají.

Můžete vybrat Vysvětlit tento výraz nebo můžete v chatu požádat Copilot, aby ho vysvětlil.

Zde je příklad shrnutí, které může Copilot poskytnout:

Snímek obrazovky s ukázkovým souhrnem, který poskytl Copilot

Související obsah

  • Last updated on