Výrazy a funkce ve službě Azure Data Factory a Azure Synapse Analytics

Článek
05/17/2024

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

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

Výrazy

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

"name": "value"

nebo

"name": "@pipeline().parameters.password"

Výrazy se můžou objevit kdekoli v řetězcové hodnotě JSON a vždy vést k jiné hodnotě JSON. Pokud je hodnota JSON 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 JSON	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: "name" : "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 JSON	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 desetkrát od 0 do 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řipojit 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ří 4 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ů se dvěma funkcemi výrazů.

{ 
  "type": "@{if(equals(1, 2), 'Blob', 'Table' )}",
  "name": "@{toUpper('myData')}"
}

Editor dynamického obsahu převede nad obsah na výraz "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}". Výsledkem tohoto výrazu je řetězec formátu JSON uvedený níže.

{
  "type": "Table",
  "name": "MYDATA"
}

Datová sada s parametrem

V následujícím příkladu přebírá blobDataset parametr pojmenovanou cestu. Jeho hodnota se používá k nastavení hodnoty vlastnosti folderPath pomocí výrazu: dataset().path.

{
    "name": "BlobDataset",
    "properties": {
        "type": "AzureBlob",
        "typeProperties": {
            "folderPath": "@dataset().path"
        },
        "linkedServiceName": {
            "referenceName": "AzureStorageLinkedService",
            "type": "LinkedServiceReference"
        },
        "parameters": {
            "path": {
                "type": "String"
            }
        }
    }
}

Kanál s parametrem

V následujícím příkladu kanál přebírá parametry inputPath a outputPath . Cesta pro parametrizovanou datovou sadu objektů blob je nastavena pomocí hodnot těchto parametrů. Syntaxe použitá tady je: pipeline().parameters.parametername.

{
    "name": "Adfv2QuickStartPipeline",
    "properties": {
        "activities": [
            {
                "name": "CopyFromBlobToBlob",
                "type": "Copy",
                "inputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.inputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "outputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.outputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "typeProperties": {
                    "source": {
                        "type": "BlobSource"
                    },
                    "sink": {
                        "type": "BlobSink"
                    }
                }
            }
        ],
        "parameters": {
            "inputPath": {
                "type": "String"
            },
            "outputPath": {
                "type": "String"
            }
        }
    }
}

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ích kroků nahradit speciální znaky pomocí jazyka výrazu:

Kódování adresy URL proti původní řetězcové hodnotě
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).
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ů v kanálech používají k ohraničení parametrů řetězcové hodnoty jednoduchou uvozovku ('). K zahrnutí jedné uvozovky použijte dva po sobě jdoucí znaky jednoduchých uvozovek ve výrazu řetězce kanálu. Tady je příklad: Výraz @concat('Here is a double quote character: ". ', 'And here is a single quote character all within the same string: ''.') vrátí následující výsledek:

Here is a double quote character: ". And here is a single quote character all within the same string: '.

Ve výrazech toku dat ale tato syntaxe není podporovaná. Místo toho můžou být výrazy toku dat obklopené jednoduchými nebo dvojitými uvozovkami. Uzavřete text vyžadující jednoduché uvozovky do dvojitých uvozovek a text vyžadující dvojité uvozovky v jednoduchých uvozovkách v rámci řetězcových funkcí. Pokud potřebujete řetězec obsahující jednoduché i dvojité uvozovky, můžete použít concat() ke sloučení dvou podřetězců, které obsahují jednoduché uvozovky nebo dvojité uvozovky. Ekvivalent toku dat předchozího příkladu výrazu kanálu by byl concat('Here is a double quote character: ". ', "And here is a single quote character all within the same string: '."). V toku dat tento výraz vrátí stejný výsledek jako předchozí příklad pro výrazy kanálu.

Kurz

Tento kurz vás provede předáváním parametrů mezi kanálem a aktivitou i mezi aktivitami. Tento kurz konkrétně ukazuje kroky pro Azure Data Factory, i když kroky pro pracovní prostor Synapse jsou téměř ekvivalentní, ale s mírně odlišným uživatelským rozhraním.

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.
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.

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	Rozdělte řetězec při každém výskytu zadaného oddělovače, který vrátí výsledné podřetězce jako prvky pole.
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.
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	Ú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.
křižovatka	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.
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í	Ú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ě.
když	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.
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.
float	Vrátí číslo s plovoucí desetinou čárkou pro vstupní hodnotu.
int	Vrátí celočíselnou verzi řetězce.
json	Vrátí hodnotu typu JSON (JavaScript Object Notation) nebo objekt pro řetězec nebo XML.
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í jednoho čísla jiným číslem.
Max	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 vydělení jednoho čísla jiným číslem.
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.
pod	Vrátí výsledek od odečtení jednoho čísla od jiné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á značka>	Ano	String	Řetězec obsahující časové razítko
<Dny>	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á značka>	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á značka>	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á značka>	Ano	String	Řetězec obsahující časové razítko
<sekundy>	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á značka>	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

splynout

Vrátí první hodnotu, která není null, z jednoho nebo více parametrů. Prázdné řetězce, prázdné pole a prázdné objekty nejsou 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
<sbírka>	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á 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.
<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á 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.
<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á 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.
<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á značka>	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

denOfWeek

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

dayOfWeek('<timestamp>')

Parametr	Požaduje se	Type	Popis
<časová značka>	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

denOfYear

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

dayOfYear('<timestamp>')

Parametr	Požaduje se	Type	Popis
<časová značka>	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:

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í výsledek dělení jednoho čísla jiným číslem.

div(<dividend>, <divisor>)

Přesný návratový typ funkce závisí na typech jeho parametrů – podrobnosti najdete v příkladech.

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. Hodnota dělitele nuly způsobí chybu za běhu.

Vrácená hodnota	Typ	Popis
<quotient-result>	Celé číslo nebo plovoucí číslo	Výsledek vydělení prvního čísla druhým číslem

Příklad 1

Tyto příklady vydělí číslo 9 číslem 2:

div(9, 2.0)
div(9.0, 2)
div(9.0, 2.0)

A všechny vrátí tento výsledek: 4.5

Příklad 2

Tento příklad také vydělí číslo 9 číslem 2, ale protože oba parametry jsou celá čísla, zbytek se zahodí (celé číslo dělení):

div(9, 2)

Výraz vrátí výsledek 4. K získání hodnoty zbytku použijte funkci mod().

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
<sbírka>	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
<sbírka>	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á značka>	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"
      } ]
   }
}

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>', ...)

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
<sbírka>	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
<sbírka>	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
<sbírka>	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 vydělení jednoho čísla jiným číslem. Pro celočíselné dělení viz 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. Hodnota dělitele nuly způsobí chybu za běhu.

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 vypočítá zbytek, když je první číslo vyděleno druhým číslem:

mod(3, 2)

A vrátí 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é vynásobí násobení1

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 vyná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. Všimněte si, že každé vyvolání `rand()` bude mít jedinečný výsledek, což znamená, že hodnota, kterou jste zaznamenali při monitorování výstupu, nemusí být ve skutečné době běhu stejná.

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
<sbírka>	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

Rozdělte řetězec při každém výskytu zadaného oddělovače, který vrátí výsledné podřetězce jako prvky pole. Oddělovač je obvykle jeden znak, ale podporují se vícefaktorové oddělovače.

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

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec, který se má rozdělit na podřetězce
<oddělovač>	Ano	String	Řetězec, 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 původního řetězce

Příklad

Tento příklad vrátí pole obsahující podřetězce řetězce "a_b_c" na základě oddělovače "_":

split('a_b_c', '_')

Vrácená matice je: ["a","b","c"]

startOfDay

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

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

Parametr	Požaduje se	Type	Popis
<časová značka>	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á značka>	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á značka>	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í jednoho čísla od jiného čísla.

sub(<minuend>, <subtrahend>)

Parametr	Požaduje se	Type	Popis
<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

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á značka>	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
<sbírka>	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]

tiká

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

ticks('<timestamp>')

Parametr	Požaduje se	Type	Popis
<časová značka>	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"

zastřihnout

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.

Seznam systémových proměnných, které můžete použít ve výrazech, najdete v tématu Systémové proměnné.

Sdílet prostřednictvím

Výrazy a funkce ve službě Azure Data Factory a Azure Synapse Analytics

Výrazy

Příklady

Příklad komplexního výrazu

Editor dynamického obsahu

Datová sada s parametrem

Kanál s parametrem

Nahrazení speciálních znaků

Escaping single quote character

Kurz

Funkce

Datové funkce

Funkce řetězců

Funkce kolekcí

Logické funkce

Převodní funkce

Matematické funkce

Reference k funkcím

add

addDays

addHours

addMinutes

addSeconds

addToTime

a

pole

base64

base64ToBinary

base64ToString

binární

bool

splynout

concat

obsahuje

convertFromUtc

convertTimeZone

convertToUtc

createArray

identifikátor dataURI

dataUriToBinary

dataUriToString

denOfMonth

denOfWeek

denOfYear

decodeBase64

decodeDataUri

decodeUriComponent

div

encodeUriComponent

empty

endsWith

rovná se

1\.

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

formatDateTime

getFutureTime

getPastTime

greater

greaterOrEquals

guid

if

indexOf

int

json

křižovatka

join

Poslední

lastIndexOf

length

less

lessOrEquals

max

min

mod

mul

not

nebo

rand

range