Výrazy a funkce v Azure Data Factory a Azure synapse Analytics

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tento článek poskytuje podrobné informace o výrazech a funkcích, které podporuje 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. Například:

"name": "value"

nebo

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

Výrazy se můžou objevit kdekoli v hodnotě řetězce JSON a vždycky mají za následek jinou hodnotu JSON. Pokud je hodnotou JSON výraz, tělo výrazu se extrahuje odebráním znaku při přihlášení ( @ ). Pokud je vyžadován řetězcový literál, který začíná @ , musí být uvozen pomocí @ @ . Následující příklady znázorňují, jak jsou výrazy vyhodnocovány.

Hodnota JSON Výsledek
ukazatelů Vrátí se znaky Parameters.
"Parameters [1]" Vrátí se znaky Parameters [1].
"@@" Vrátí se 1 řetězec znaků, který obsahuje znak @ .
" @" Je vrácen 2 řetězec znaků, který obsahuje znak ' @ '.

Výrazy lze také zobrazit uvnitř řetězců pomocí funkce s názvem interpolace řetězce , kde jsou výrazy zabaleny @{ ... } . Příklad: "name" : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Při použití řetězcové interpolace je výsledkem vždy řetězec. Řekněme, že jsem definoval (a) jako myNumber 42 myString foo :

Hodnota JSON Výsledek
" @ Pipeline (). Parameters. MyString" Vrátí hodnotu foo jako řetězec.
" @ {Pipeline (). Parameters. MyString}" Vrátí hodnotu foo jako řetězec.
" @ Pipeline (). Parameters. MyNumber" Vrátí hodnotu 42 jako číslo.
" @ {Pipeline (). Parameters. MyNumber}" Vrátí hodnotu 42 jako řetězec.
"Odpověď je: @ {Pipeline (). Parameters. myNumber}" Vrátí řetězec Answer is: 42 .
" @ Concat (' Answer: '; 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 poskytnout pole, které se má iterovat pro položky vlastností a použít @item () pro iteraci v rámci jednoho výčtu v aktivitě foreach. Například pokud je položka pole: [1, 2, 3], @item () vrátí 1 v první iteraci, 2 v druhé iteraci a 3 v třetí iteraci. Můžete také použít @range výraz (0, 10) jako výraz pro iteraci desetkrát počínaje 0 končící hodnotou 9.

Můžete použít @activity (' Activity name ') k zachycení výstupu aktivity a rozhodování. Vezměte v úvahu aktivitu webu nazvanou WEB1. Pro vložení výstupu první aktivity do těla druhé by výraz vypadal obvykle takto: @activity (' WEB1 '). Output nebo @activity (' WEB1 '). Output. data nebo něco podobného, v závislosti na tom, jaký výstup první aktivity vypadá jako.

Příklady

Příklad komplexního výrazu

Následující příklad ukazuje komplexní příklad, který odkazuje na hloubkové dílčí pole výstupu aktivity. Chcete-li odkazovat na parametr kanálu, který je vyhodnocen jako dílčí pole, použijte syntaxi [] namísto operátoru tečka (.) (jako v případě dílčího pole1 a subfield2) jako součást výstupu aktivity.

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

Vytváření souborů dynamicky a jejich pojmenování je běžný vzor. Podíváme se na několik příkladů dynamického pojmenovávání souborů.

  1. Datum připojení k názvu souboru: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))

  2. Připojit datum a čas v časovém pásmu zákazníka: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))

  3. Čas připojení triggeru: @concat('Test_', pipeline().TriggerTime)

  4. výstup vlastního názvu souboru v mapování dat Flow při uvádění do jednoho souboru s datem:'Test_' + toString(currentDate()) + '.csv'

Ve výše uvedených případech se 4 dynamické názvy souborů vytvářejí od Test_.

Editor dynamického obsahu

Editor dynamického obsahu automaticky řídí znaky v obsahu při dokončení úprav. Například následující obsah v Editoru obsahu je interpolace řetězce se dvěma funkcemi výrazu.

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

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

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

Datová sada s parametrem

V následujícím příkladu převezme BlobDataset parametr s názvem path. 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řijímá parametry inputPath a outputPath . Cesta pro parametrizovanou datovou sadu objektů BLOB je nastavena pomocí hodnot těchto parametrů. Zde použitá syntaxe 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 řídí znaky, jako jsou dvojité uvozovky, zpětné lomítko v obsahu při dokončení úprav. To způsobuje problémy, pokud chcete nahradit posun řádku nebo tabulátor pomocí \n, \t ve funkci Replace (). Můžete upravit dynamický obsah v zobrazení kódu pro odebrání nadbytečného výrazu ve výrazu, nebo můžete postupovat podle následujících kroků pro nahrazení speciálních znaků pomocí jazyka výrazů:

  1. Kódování adresy URL proti původní hodnotě řetězce
  2. Nahraďte řetězec kódovaný v adrese URL, například posun řádku (% 0A), znak návratu na začátek řádku (% 0D), horizontální kartu (%09).
  3. Dekódování adresy URL

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

Contoso-
Corporation

Řídicí znak jednoduché uvozovky

Funkce výrazu používají jednoduché uvozovky pro parametry řetězcové hodnoty. Pomocí dvou jednoduchých uvozovek můžete v řetězcových funkcích řídicího znaku. Například výraz @concat('Baba', '''s ', 'book store') bude vrácen pod výsledek.

Baba's book store

Kurz

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

Functions

Můžete volat funkce v rámci výrazů. Následující části obsahují informace o funkcích, které lze použít ve výrazu.

Datové funkce

Funkce data a času Úkol
addDays Přidání počtu dní do časového razítka.
addHours Přidejte do časového razítka několik hodin.
addMinutes Přidejte do časového razítka počet minut.
addSeconds Přidejte do časového razítka počet sekund.
addToTime Přidání počtu časových jednotek k časovému razítku. Viz také getFutureTime.
convertFromUtc Převeďte časové razítko ze koordinovaného světového času (UTC) na cílové časové pásmo.
convertTimeZone Převede časové razítko ze zdrojového časového pásma na cílové časové pásmo.
convertToUtc Převede časové razítko ze zdrojového časového pásma na koordinovaný světový čas (UTC).
dayOfMonth Vrátí den v měsíci součásti z časového razítka.
dayOfWeek Vrátí den v týdnu komponenty z časového razítka.
dayOfYear Vrátí den komponenty v roce z časového razítka.
formatDateTime Vrátí časové razítko jako řetězec v volitelném formátu.
getFutureTime Vrátí aktuální časové razítko plus zadané časové jednotky. Viz také addToTime.
getPastTime Vrátí aktuální časové razítko minus zadané časové jednotky. Viz také subtractFromTime.
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.
subtractFromTime Odečte počet časových jednotek od časového razítka. Viz také getPastTime.
Ticks Vrátí ticks hodnotu vlastnosti pro zadané časové razítko.
utcNow Vrátí aktuální časové razítko jako řetězec.

Funkce řetězců

Chcete-li pracovat s řetězci, můžete použít tyto řetězcové funkce a také některé funkce kolekce. Funkce řetězce fungují pouze v řetězcích.

Funkce String Úkol
spojuje Kombinací dvou nebo více řetězců a vrácení kombinovaného řetězce.
endsWith Zkontroluje, zda řetězec končí zadaným podřetězcem.
guid Vygeneruje globálně jedinečný identifikátor (GUID) jako řetězec.
indexOf Vrátí počáteční pozici podřetězce.
lastIndexOf Vrátí počáteční pozici pro poslední výskyt podřetězce.
náhrady Nahraďte podřetězec zadaným řetězcem a vraťte aktualizovaný řetězec.
rozdělení Vrátí pole, které obsahuje podřetězce oddělené čárkami, z většího řetězce na základě zadaného oddělovače v původním řetězci.
startsWith Kontroluje, zda řetězec začíná konkrétním podřetězcem.
podřetězec Vrátí znaky z řetězce počínaje od zadané pozice.
toLower Vrátí řetězec ve formátu s malými písmeny.
toUpper Vrátí řetězec ve formátu velkými písmeny.
sklon Odstraňte úvodní a koncové mezery z řetězce a vraťte aktualizovaný řetězec.

Funkce kolekcí

Chcete-li pracovat s kolekcemi, všeobecně se jedná o pole, řetězce a někdy slovníky, můžete použít tyto funkce kolekce.

Funkce kolekce Úkol
zobrazí Kontroluje, zda kolekce obsahuje konkrétní položku.
empty Zkontroluje, jestli je kolekce prázdná.
první Vrátí první položku z kolekce.
průnik Vrátí kolekci, která má v zadaných kolekcích jenom společné položky.
zúčastnit Vrátí řetězec, který obsahuje všechny položky z pole oddělené zadaným znakem.
posledního Vrátí poslední položku z kolekce.
length Vrátí počet položek v řetězci nebo poli.
přímo Odebere položky z přední části kolekce a vrátí všechny ostatní položky.
nezbytná Vrátí položky od začátku kolekce.
sjednocovací Vrátí kolekci, která obsahuje všechny položky ze zadaných kolekcí.

Logické funkce

Tyto funkce jsou užitečné v rámci podmínek, které je možné použít k vyhodnocení jakéhokoli typu logiky.

Funkce logického porovnání Úkol
and Ověřte, zda jsou všechny výrazy pravdivé.
rovná Zkontroluje, jestli jsou obě hodnoty ekvivalentní.
greater Ověřte, zda je první hodnota větší než druhá hodnota.
greaterOrEquals Ověřte, zda je první hodnota větší než nebo rovna druhé hodnotě.
Přestože Zkontroluje, jestli je výraz pravdivý, nebo nepravdivý. Na základě výsledku vrátí zadanou hodnotu.
tolik Ověřte, zda je první hodnota menší než druhá hodnota.
lessOrEquals Ověřte, zda je první hodnota menší nebo rovna druhé hodnotě.
mění Zkontroluje, jestli je výraz nepravdivý.
nebo Ověřte, zda je alespoň jeden výraz pravdivý.

Převodní funkce

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

  • řetězec
  • integer
  • float
  • boolean
  • řadách
  • slovníky
Převodní funkce Úkol
array Vrátí pole z jednoho zadaného vstupu. Více vstupů naleznete v tématu createArray.
base64 Vrátí verzi kódovanou pro řetězec ve formátu base64.
base64ToBinary Vrátí binární verzi řetězce zakódovaného ve formátu base64.
base64ToString Vrátí verzi řetězce pro řetězec kódovaný v kódování Base64.
tvaru Vrátí binární verzi pro vstupní hodnotu.
bool Vrátí logickou verzi pro vstupní hodnotu.
COALESCE Vrátí první hodnotu, která není null, z jednoho nebo více parametrů.
createArray Vrátí pole z více vstupů.
dataUri Vrátí identifikátor URI dat pro vstupní hodnotu.
dataUriToBinary Vrátí binární verzi pro identifikátor 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 kódování Base64.
decodeDataUri Vrátí binární verzi pro identifikátor URI dat.
decodeURIComponent – Vrátí řetězec, který nahradí řídicí znaky pomocí dekódování verzí.
encodeURIComponent – Vrátí řetězec, který nahradí URL – nebezpečné znaky pomocí řídicích znaků.
float Vrátí číslo s plovoucí desetinnou čárkou pro vstupní hodnotu.
int Vrátí celočíselnou verzi řetězce.
JSON Vrátí hodnotu nebo objekt typu JavaScript Object Notation (JSON) pro řetězec nebo XML.
řetězec Vrátí verzi řetězce pro vstupní hodnotu.
uriComponent Vrátí verzi kódovanou identifikátorem URI pro vstupní hodnotu nahrazením znaků, které nejsou bezpečné, pomocí řídicích znaků.
uriComponentToBinary Vrátí binární verzi řetězce zakódovaného identifikátorem URI.
uriComponentToString Vrátí verzi řetězce pro řetězec kódovaný pomocí identifikátoru URI.
XML Vrátí verzi XML pro řetězec.
cestou Zkontroluje 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 oba typy čísel: celá čísla a Floaty.

Funkce Math Úkol
add Vrátí výsledek z přidání dvou čísel.
div Vrátí výsledek z dělení dvou čísel.
počet Vrátí nejvyšší hodnotu ze sady čísel nebo pole.
min Vrátí nejnižší hodnotu ze sady čísel nebo pole.
střední Vrátí zbytek po dělení dvou čísel.
mul Vrátí produkt pro vynásobení dvou čísel.
funkcí Vrátí náhodné celé číslo ze zadaného rozsahu.
oblasti Vrátí celočíselné pole, které začíná zadaným celým číslem.
jednotk Vrátí výsledek odečtením druhého čísla od prvního čísla.

Odkaz na funkci

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

add

Vrátí výsledek z přidání dvou čísel.

add(<summand_1>, <summand_2>)
Parametr Povinné Typ Description
<summand_1> <summand_2> Yes Integer, float nebo mixed Čísla, která mají být přidána
Vrácená hodnota Typ Description
<výsledek – součet> Integer nebo float Výsledek přidání zadaných čísel

Příklad

V tomto příkladu se přidají zadaná čísla:

add(1, 1.5)

A vrátí tento výsledek: 2.5

addDays

Přidání počtu dní do časového razítka.

addDays('<timestamp>', <days>, '<format>'?)
Parametr Povinné Typ Description
<časové razítko> Ano Řetězec Řetězec, který obsahuje časové razítko
<denní> Yes Integer Kladný nebo záporný počet dní, které se mají přidat
<formátovat> No Řetězec Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<Aktualizováno – časové razítko> Řetězec Časové razítko plus zadaný počet dní

Příklad 1

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

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 několik hodin.

addHours('<timestamp>', <hours>, '<format>'?)
Parametr Povinné Typ Description
<časové razítko> Ano Řetězec Řetězec, který obsahuje časové razítko
<hodin> Yes Integer Kladný nebo záporný počet hodin, které se mají přidat
<formátovat> No Řetězec Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<Aktualizováno – časové razítko> Řetězec Č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 počet minut.

addMinutes('<timestamp>', <minutes>, '<format>'?)
Parametr Povinné Typ Description
<časové razítko> Ano Řetězec Řetězec, který obsahuje časové razítko
<minuty> Yes Integer Kladný nebo záporný počet minut, který se má přidat
<formátovat> No Řetězec Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<Aktualizováno – časové razítko> Řetězec Časové razítko plus zadaný počet minut

Příklad 1

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

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 počet sekund.

addSeconds('<timestamp>', <seconds>, '<format>'?)
Parametr Povinné Typ Description
<časové razítko> Ano Řetězec Řetězec, který obsahuje časové razítko
<Second> Yes Integer Kladný nebo záporný počet sekund, které se mají přidat
<formátovat> No Řetězec Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<Aktualizováno – časové razítko> Řetězec Č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 na zadané časové razítko:

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

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

addToTime

Přidání počtu časových jednotek k časovému razítku. Viz také getFutureTime ().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parametr Povinné Typ Description
<časové razítko> Ano Řetězec Řetězec, který obsahuje časové razítko
<doba> Yes Integer Počet zadaných časových jednotek, které se mají přidat
<timeUnit> Ano Řetězec Jednotka času, která se má použít v intervalu: "druhé", "Minute", "hodina", "den", "týden", "měsíc", "rok"
<formátovat> No Řetězec Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<Aktualizováno – časové razítko> Řetězec Č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

Ověřte, zda jsou oba výrazy pravdivé. Vrátí hodnotu true, pokud mají oba výrazy hodnotu true, nebo vrátí hodnotu false, pokud je alespoň jeden výraz nepravdivý.

and(<expression1>, <expression2>)
Parametr Povinné Typ Description
<výraz1>, <Výraz2> Yes Logická hodnota Výrazy, které mají být zkontrolovány
Vrácená hodnota Typ Description
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 nepravdivý.

Příklad 1

Tyto příklady kontrolují, zda 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 mají hodnotu true, takže se vrátí true .
  • Druhý příklad: jeden výraz má hodnotu NEPRAVDA, takže se vrátí false .
  • Třetí příklad: oba výrazy mají hodnotu false, takže se vrátí false .

Příklad 2

V těchto příkladech se zkontroluje, 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 nepravdivý, proto vrátí false .
  • Třetí příklad: Oba výrazy mají hodnotu false, proto vrátí false hodnotu .

array

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

array('<value>')
Parametr Povinné Typ Description
<Hodnotu> Ano Řetězec Řetězec pro vytvoření pole
Vrácená hodnota Typ Description
[<value>] Pole Pole, které obsahuje 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í pro řetězec verzi s kódováním base64.

base64('<value>')
Parametr Povinné Typ Description
<Hodnotu> Ano Řetězec Vstupní řetězec
Vrácená hodnota Typ Description
<Řetězec base64> Řetězec Verze zakódovaná v kódování 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 Povinné Typ Description
<Hodnotu> Ano Řetězec Řetězec s kódováním base64, který se má převést
Vrácená hodnota Typ Description
<binary-for-base64-string> Řetězec Binární verze řetězce s kódováním base64

Příklad

Tento příklad převede řetězec "aGVsbG8=" v kódování base64 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 efektivně dekóduje řetězec base64. Tuto funkci použijte místo decodeBase64(). Přestože obě funkce fungují stejným způsobem, base64ToString() je upřednostňován.

base64ToString('<value>')
Parametr Povinné Typ Description
<Hodnotu> Ano Řetězec Řetězec s kódováním base64 pro dekódování
Vrácená hodnota Typ Description
<dekódovaný řetězec base64> Řetězec Verze řetězce pro řetězec s kódováním base64

Příklad

Tento příklad převede řetězec "aGVsbG8=" zakódovaný v kódování base64 na řetězec:

base64ToString('aGVsbG8=')

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

binární

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

binary('<value>')
Parametr Povinné Typ Description
<Hodnotu> Ano Řetězec Řetězec, který se má převést
Vrácená hodnota Typ Description
<binary-for-input-value> Řetězec 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 pro hodnotu.

bool(<value>)
Parametr Povinné Typ Description
<osa> Yes Všechny Hodnota, která se má převést
Vrácená hodnota Typ Description
true nebo false Logická hodnota Logická verze zadané hodnoty

Příklad

Tyto příklady převádějí zadané hodnoty na logické hodnoty:

bool(1)
bool(0)

A vrátí tyto výsledky:

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

COALESCE

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

coalesce(<object_1>, <object_2>, ...)
Parametr Povinné Typ Description
<object_1> <object_2>... Yes Libovolný, můžou kombinovat typy. Jedna nebo více položek pro kontrolu hodnoty null
Vrácená hodnota Typ Description
<první položka, která není null,> Všechny První položka nebo hodnota, která není null. Pokud jsou všechny parametry null, tato funkce vrátí hodnotu null.

Příklad

Tyto příklady vrátí první hodnotu jinou než null ze zadaných hodnot nebo hodnotu 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

Kombinací dvou nebo více řetězců a vrácení kombinovaného řetězce.

concat('<text1>', '<text2>', ...)
Parametr Povinné Typ Description
<text1>, <Text2>,... Ano Řetězec Aspoň dva řetězce, které se mají zkombinovat
Vrácená hodnota Typ Description
<text1text2...> Řetězec Řetězec vytvořený z kombinovaných vstupních řetězců

Příklad

V tomto příkladu jsou kombinovány řetězce "Hello" a "World":

concat('Hello', 'World')

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

obsahuje

Kontroluje, zda kolekce obsahuje konkrétní položku. Vrátí hodnotu true, pokud se položka najde, nebo vrátí hodnotu false, pokud nebyla nalezena. Tato funkce rozlišuje velká a malá 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 , ve kterém se má najít hodnota
  • Slovník , ve kterém se má najít klíč
Parametr Povinné Typ Description
<kolekce> Yes Řetězec, pole nebo slovník Kolekce, která má být zkontrolována
<osa> Yes Řetězec, pole nebo slovník, v uvedeném pořadí Položka, která se má najít
Vrácená hodnota Typ Description
true nebo false Logická hodnota Vrátí hodnotu true, pokud se položka najde. Pokud se nenajde, vrátí se hodnota false.

Příklad 1

Tento příklad zkontroluje řetězec "Hello World" pro podřetězec "World" a vrátí hodnotu true:

contains('hello world', 'world')

Příklad 2

Tento příklad zkontroluje řetězec "Hello World" pro podřetězec "Universe" a vrátí hodnotu false:

contains('hello world', 'universe')

convertFromUtc

Převeďte časové razítko ze koordinovaného světového času (UTC) na cílové časové pásmo.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parametr Povinné Typ Description
<Časové razítko> Ano Řetězec Řetězec obsahující časové razítko
<Destinationtimezone> Ano Řetězec Název cílového časového pásma. Názvy časových pásem najdete v tématu Hodnoty indexu časových pásem Microsoftu,ale možná budete muset z názvu časového pásma odebrat jakoukoli interpunkci.
<Formát> No Řetězec Specifikátor jednoho formátu nebo vzor vlastního formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss:fffffffK), který vyhovuje standardu ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<převedené časové razítko> Řetězec Č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 Povinné Typ Description
<Časové razítko> Ano Řetězec Řetězec obsahující časové razítko
<Sourcetimezone> Ano Řetězec Název zdrojového časového pásma. Názvy časových pásem najdete v tématu Hodnoty indexu časových pásem Microsoftu,ale možná budete muset z názvu časového pásma odebrat jakoukoli interpunkci.
<Destinationtimezone> Ano Řetězec Název cílového časového pásma. Názvy časových pásem najdete v tématu Hodnoty indexu časových pásem Microsoftu,ale možná budete muset z názvu časového pásma odebrat jakoukoli interpunkci.
<Formát> No Řetězec Specifikátor jednoho formátu nebo vzor vlastního formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss:fffffffK), který vyhovuje standardu ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<převedené časové razítko> Řetězec Č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 koordinovaný univerzální čas (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parametr Povinné Typ Description
<Časové razítko> Ano Řetězec Řetězec obsahující časové razítko
<Sourcetimezone> Ano Řetězec Název zdrojového časového pásma. Názvy časových pásem najdete v tématu Hodnoty indexu časových pásem Microsoftu,ale možná budete muset z názvu časového pásma odebrat jakoukoli interpunkci.
<Formát> No Řetězec Specifikátor jednoho formátu nebo vzor vlastního formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss:fffffffK), který vyhovuje standardu ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<převedené časové razítko> Řetězec Časové razítko převedené 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ů. Pro pole s jedním vstupem naleznete v tématu Array ().

createArray('<object1>', '<object2>', ...)
Parametr Povinné Typ Description
<objekt1> <objekt2>... Yes Libovolná, ale ne smíšená Aspoň dvě položky pro vytvoření pole
Vrácená hodnota Typ Description
[<objekt1>, <objekt2>,...] 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"]

dataUri

Vrátí v řetězci datový identifikátor URI (Uniform Resource Identifier).

dataUri('<value>')
Parametr Povinné Typ Description
<osa> Ano Řetězec Řetězec, který se má převést
Vrácená hodnota Typ Description
<identifikátor URI dat> Řetězec 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 pro datový identifikátor URI (Uniform Resource Identifier). Použijte tuto funkci místo decodeDataUri (). I když obě funkce fungují stejným způsobem, dataUriBinary() jsou upřednostňovány.

dataUriToBinary('<value>')
Parametr Povinné Typ Description
<osa> Ano Řetězec Identifikátor URI dat, který se má převést
Vrácená hodnota Typ Description
<binární data pro identifikátor URI> Řetězec 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 datový identifikátor URI (Uniform Resource Identifier).

dataUriToString('<value>')
Parametr Povinné Typ Description
<osa> Ano Řetězec Identifikátor URI dat, který se má převést
Vrácená hodnota Typ Description
<řetězec pro datový identifikátor URI> Řetězec 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"

dayOfMonth

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

dayOfMonth('<timestamp>')
Parametr Povinné Typ Description
<časové razítko> Ano Řetězec Řetězec, který obsahuje časové razítko
Vrácená hodnota Typ Description
<den měsíce> Integer Den v měsíci ze zadaného časového razítka

Příklad

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

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

A vrátí tento výsledek: 15

dayOfWeek

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

dayOfWeek('<timestamp>')
Parametr Povinné Typ Description
<časové razítko> Ano Řetězec Řetězec, který obsahuje časové razítko
Vrácená hodnota Typ Description
<den týdne> Integer Den v týdnu ze zadaného časového razítka, kde neděle je 0, pondělí a tak dále

Příklad

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

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

A vrátí tento výsledek: 3

dayOfYear

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

dayOfYear('<timestamp>')
Parametr Povinné Typ Description
<časové razítko> Ano Řetězec Řetězec, který obsahuje časové razítko
Vrácená hodnota Typ Description
<den roku> 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 kódovaný v kódování Base64 a efektivně dekódování řetězce base64. Zvažte použití base64ToString () spíše než decodeBase64() . I když obě funkce fungují stejným způsobem, base64ToString() jsou upřednostňovány.

decodeBase64('<value>')
Parametr Povinné Typ Description
<osa> Ano Řetězec Řetězec kódovaný v kódování Base64 k dekódování
Vrácená hodnota Typ Description
<dekódované – řetězec base64> Řetězec Verze řetězce pro řetězec kódovaný v kódování Base64

Příklad

Tento příklad vytvoří řetězec pro řetězec kódovaný v kódování Base64:

decodeBase64('aGVsbG8=')

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

decodeDataUri

Vrátí binární verzi pro datový identifikátor URI (Uniform Resource Identifier). Zvažte použití dataUriToBinary ()místo decodeDataUri() . I když obě funkce fungují stejným způsobem, dataUriToBinary() jsou upřednostňovány.

decodeDataUri('<value>')
Parametr Povinné Typ Description
<osa> Ano Řetězec Řetězec identifikátoru URI dat k dekódování
Vrácená hodnota Typ Description
<binární data pro identifikátor URI> Řetězec Binární verze řetězce identifikátoru URI dat

Příklad

Tento příklad vrátí binární verzi pro tento identifikátor 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 pomocí dekódování verzí.

decodeUriComponent('<value>')
Parametr Povinné Typ Description
<osa> Ano Řetězec Řetězec s řídicími znaky k dekódování
Vrácená hodnota Typ Description
<Dekódovatelné – identifikátor URI> Řetězec Aktualizovaný řetězec s dekódovými řídicími znaky

Příklad

Tento příklad nahrazuje řídicí znaky v tomto řetězci pomocí Dekódovatelné verze:

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

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

div

Vrátí celočíselný výsledek z vydělení dvou čísel. Chcete-li získat zbývající výsledek, viz mod ().

div(<dividend>, <divisor>)
Parametr Povinné Typ Description
<podíl> Yes Integer nebo float Číslo, které se má rozdělit dělitelem
<dělitel> Yes Integer nebo float Číslo, které vydělí dividendy, ale nemůže být 0
Vrácená hodnota Typ Description
<podíl – výsledek> Integer Celočíselný výsledek vydělení prvního čísla druhým číslem

Příklad

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

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

A vrátí tento výsledek: 2

encodeURIComponent –

Nahrazením znaků, které nejsou v adrese URL, pomocí řídicích znaků vrátíte verzi kódovanou podle identifikátoru URI (Uniform Resource Identifier) pro řetězec. Zvažte použití uriComponent ()místo encodeUriComponent() . I když obě funkce fungují stejným způsobem, uriComponent() jsou upřednostňovány.

encodeUriComponent('<value>')
Parametr Povinné Typ Description
<osa> Ano Řetězec Řetězec, který se má převést na formát kódovaný identifikátorem URI
Vrácená hodnota Typ Description
<kódovaný identifikátor URI> Řetězec Řetězec kódovaný identifikátorem URI s řídicími znaky

Příklad

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

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

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

empty

Zkontroluje, 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 Povinné Typ Description
<kolekce> Yes Řetězec, pole nebo objekt Kolekce, která má být zkontrolována
Vrácená hodnota Typ Description
true nebo false Logická hodnota Vrátí hodnotu pravda, 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ává prázdný řetězec, takže funkce vrátí hodnotu true .
  • Druhý příklad: předá řetězec "ABC", takže funkce vrátí false .

endsWith

Zkontroluje, jestli řetězec končí určitým podřetězcem. Vrátí hodnotu true, pokud se podřetězec najde, nebo vrátí hodnotu false, pokud nebyla nalezena. Tato funkce nerozlišuje velká a malá písmena.

endsWith('<text>', '<searchText>')
Parametr Povinné Typ Description
<textové> Ano Řetězec Řetězec, který má být zkontrolován
<Prohledávanýtext> Ano Řetězec Koncový dílčí řetězec, který se má najít
Vrácená hodnota Typ Description
true nebo false Logická hodnota Vrátí hodnotu pravda, pokud je nalezen poslední podřetězec. Pokud se nenajde, vrátí se hodnota false.

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

Zkontroluje, jestli jsou 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 Povinné Typ Description
<objekt1>, <objekt2> Yes Některé Hodnoty, výrazy nebo objekty, které se mají porovnat
Vrácená hodnota Typ Description
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í, zda 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>])
Parametr Povinné Typ Description
<kolekce> Yes Řetězec nebo pole Kolekce, ve které se má najít první položka
Vrácená hodnota Typ Description
<první kolekce – položka> Všechny První položka v kolekci

Příklad

Tyto příklady vyhledají 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 pro číslo s plovoucí desetinnou čárkou na skutečné číslo s plovoucí desetinnou čárkou.

float('<value>')
Parametr Povinné Typ Description
<osa> Ano Řetězec Řetězec, který má platné číslo s plovoucí desetinnou čárkou, které se má převést
Vrácená hodnota Typ Description
<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 Povinné Typ Description
<časové razítko> Ano Řetězec Řetězec, který obsahuje časové razítko
<formátovat> No Řetězec Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<přeformátované – časové razítko> Řetězec Aktualizované časové razítko v zadaném formátu

Příklad

Tento příklad převede časové razítko na určený 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 plus zadané časové jednotky.

getFutureTime(<interval>, <timeUnit>, <format>?)
Parametr Povinné Typ Description
<doba> Yes Integer Počet zadaných časových jednotek, které se mají přidat
<timeUnit> Ano Řetězec Jednotka času, která se má použít v intervalu: "druhé", "Minute", "hodina", "den", "týden", "měsíc", "rok"
<formátovat> No Řetězec Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<aktualizované časové razítko> Řetězec 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.0000000Z. 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.0000000Z. Tento příklad přidá pět dní a převede výsledek do formátu "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 Povinné Typ Description
<Interval> Yes Integer Počet zadaných časových jednotek, které se mají odečíst
<timeUnit> Ano Řetězec Jednotka času, která se má použít s intervalem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Formát> No Řetězec Specifikátor jednoho formátu nebo vzor vlastního formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss:fffffffK), který vyhovuje standardu ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<aktualizované časové razítko> Řetězec 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.0000000Z. Tento příklad odečte od tohoto časového razítka pět dnů:

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.0000000Z. Tento příklad odečte pět dní a převede výsledek do formátu "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 Povinné Typ Description
<Hodnotu> Yes Integer, Float nebo String První hodnota pro kontrolu, zda je větší než druhá hodnota
<Compareto> Yes Celé číslo, float nebo řetězec (v uvedeném pořadí) Porovnávaná hodnota
Vrácená hodnota Typ Description
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

V těchto příkladech se zkontroluje, jestli je první hodnota větší než druhá hodnota:

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

A vraťte 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 Povinné Typ Description
<Hodnotu> Yes Integer, Float nebo String První hodnota pro kontrolu, jestli je větší než nebo rovna druhé hodnotě
<Compareto> Yes Celé číslo, float nebo řetězec (v uvedeném pořadí) Porovnávaná hodnota
Vrácená hodnota Typ Description
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

V těchto příkladech se zkontroluje, jestli je první hodnota větší nebo rovna druhé hodnotě:

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

A vraťte tyto výsledky:

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

guid

Vygenerování globálně jedinečného identifikátoru (GUID) jako řetězce, 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 Povinné Typ Description
<Formát> No Řetězec Jeden specifikátor 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 Description
<Hodnota GUID> Řetězec Náhodně vygenerovaný identifikátor GUID

Příklad

Tento příklad vygeneruje stejný identifikátor GUID, ale jako 32 číslic oddělených spojovníky 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 nepravdivý. Na základě výsledku vrátí zadanou hodnotu.

if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parametr Povinné Typ Description
<Výraz> Yes Logická hodnota Výraz, který se má zkontrolovat
<hodnotaIfTrue> Yes Všechny Hodnota, která se má vrátit, když je výraz pravdivý
<valueIfFalse> Yes Všechny Hodnota, která se má vrátit, když je výraz nepravdivý
Vrácená hodnota Typ Description
<specified-return-value> Všechny Zadaná hodnota, která se vrátí na základě toho, jestli je výraz pravdivý nebo nepravdivý

Příklad

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

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

Indexof

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

indexOf('<text>', '<searchText>')
Parametr Povinné Typ Description
<Text> Ano Řetězec Řetězec, který má podřetězec, který se má najít
<searchText> Ano Řetězec Podřetězec, který se má najít
Vrácená hodnota Typ Description
<index-value> Integer Počáteční pozice nebo hodnota indexu pro zadaný podřetězec.

Pokud řetězec není nalezen, vrátí číslo -1.

Příklad

Tento příklad vyhledá počáteční hodnotu indexu pro podřetězec "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 Povinné Typ Description
<Hodnotu> Ano Řetězec Řetězec, který se má převést
Vrácená 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 JavaScript Object Notation (JSON) nebo objekt pro řetězec nebo XML.

json('<value>')
Parametr Povinné Typ Description
<Hodnotu> Yes Řetězec nebo XML Řetězec nebo XML, který se má převést
Vrácená 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, funkce vrátí 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 formát 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 formát JSON:

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

A vrátí tento výsledek:

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

průnik

Vrátí kolekci, která má v zadaných kolekcích jenom společné položky. Aby se položka zobrazila ve výsledku, musí se objevit 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 se stejným názvem.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parametr Povinné Typ Description
<collection1> <Collection2>... Yes Pole nebo objekt, ale ne obojí Kolekce, ze kterých mají být pouze běžné položky
Vrácená hodnota Typ Description
<společné položky> Pole nebo objekt, v uvedeném pořadí Kolekce, která má v zadaných kolekcích jenom společné položky

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 následujícími položkami: [1, 2]

join

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

join([<collection>], '<delimiter>')
Parametr Povinné Typ Description
<kolekce> Yes Pole Pole, ve kterém se mají položky připojit
<oddělovač> Ano Řetězec Oddělovač, který se zobrazí mezi jednotlivými znaky ve výsledném řetězci
Vrácená hodnota Typ Description
<CHAR1 >< oddělovač >< CHAR2 >< oddělovač>... Řetězec 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č:

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 Povinné Typ Description
<kolekce> Yes Řetězec nebo pole Kolekce, ve které se má najít poslední položka
Vrácená hodnota Typ Description
<Poslední kolekce – položka> Řetězec nebo pole, v uvedeném pořadí Poslední položka v kolekci

Příklad

Tyto příklady vyhledají 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ězce. Tato funkce nerozlišuje velká a malá písmena a indexy začínají číslem 0.

lastIndexOf('<text>', '<searchText>')
Parametr Povinné Typ Description
<textové> Ano Řetězec Řetězec, který obsahuje dílčí řetězec, který se má najít
<Prohledávanýtext> Ano Řetězec Dílčí řetězec, který se má najít
Vrácená hodnota Typ Description
<ending-index-value> Integer Počáteční pozice nebo hodnota indexu posledního výskytu zadaného podřetězce

Pokud řetězec není nalezen, vrátí číslo -1.

Příklad

Tento příklad vyhledá počáteční hodnotu indexu pro poslední výskyt 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 Povinné Typ Description
<Kolekce> Yes Řetězec nebo pole Kolekce s položkami, které se mají spočítat
Vrácená hodnota Typ Description
<length-or-count> Integer Počet položek v kolekci

Příklad

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

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

A vraťte 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 Povinné Typ Description
<Hodnotu> Yes Integer, Float nebo String První hodnota pro kontrolu, jestli je menší než druhá hodnota
<Compareto> Yes Celé číslo, float nebo řetězec (v uvedeném pořadí) Položka porovnání
Vrácená hodnota Typ Description
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 zkontrolují, jestli je první hodnota menší než druhá hodnota.

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

A vraťte 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ětší.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parametr Povinné Typ Description
<Hodnotu> Yes Integer, Float nebo String První hodnota pro kontrolu, jestli je menší než nebo rovna druhé hodnotě
<Compareto> Yes Celé číslo, float nebo řetězec (v uvedeném pořadí) Položka porovnání
Vrácená hodnota Typ Description
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 zkontrolují, jestli je první hodnota menší nebo rovna druhé hodnotě.

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

A vraťte 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 zahrnutá.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parametr Povinné Typ Description
<number1>, <number2>, ... Yes Celé číslo, float nebo obojí Sada čísel, ze kterých chcete nejvyšší hodnotu
[<number1>, <number2>, ...] Yes Pole – Integer, Float nebo obojí Pole čísel, ze kterých chcete nejvyšší hodnotu
Vrácená hodnota Typ Description
<max-value (maximální hodnota)> Integer nebo Float Nejvyšší hodnota v zadaném poli nebo sadě čísel

Příklad

Tyto příklady čítá nejvyšší hodnotu ze sady čísel a pole:

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

A vraťte tento výsledek: 3

min

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

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parametr Povinné Typ Description
<number1>, <number2>, ... Yes Celé číslo, float nebo obojí Sada čísel, ze kterých chcete nejnižší hodnotu
[<number1>, <number2>, ...] Yes Pole – Integer, Float nebo obojí Pole čísel, ze kterých chcete nejnižší hodnotu
Vrácená hodnota Typ Description
<min-value (minimální hodnota)> Integer nebo Float Nejnižší hodnota v zadané sadě čísel nebo zadaném poli

Příklad

V těchto příkladech je nejnižší hodnota v sadě čísel a v poli:

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

A vraťte tento výsledek: 1

Mod

Vrátí zbytek rozdělení dvou čísel. Pokud chcete získat výsledek celého čísla, podívejte se na div().

mod(<dividend>, <divisor>)
Parametr Povinné Typ Description
<Dividenda> Yes Integer nebo Float Číslo, které se má dělit dělitelem
<Dělitel> Yes Integer nebo Float Číslo, které dělí dělenec, ale nemůže být 0.
Vrácená hodnota Typ Description
<modulo-result> Integer nebo Float Zbytek po vydělení prvního čísla druhým číslem

Příklad

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

mod(3, 2)

A vraťte tento výsledek: 1

mul (více)

Vrátí součásek vynásobením dvou čísel.

mul(<multiplicand1>, <multiplicand2>)
Parametr Povinné Typ Description
<násobenía1> Yes Integer nebo Float Číslo, které se má vynásobit násobeníma2
<násobenía2> Yes Integer nebo Float Číslo, které násobí násobky1
Vrácená hodnota Typ Description
<product-result> Integer nebo Float Produkt vynásobením 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 vraťte tyto výsledky:

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

not

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

not(<expression>)
Parametr Povinné Typ Description
<Výraz> Yes Logická hodnota Výraz, který se má zkontrolovat
Vrácená hodnota Typ Description
true nebo false Logická hodnota Pokud je výraz nepravdivý, vrátí hodnotu true. Pokud je výraz pravdivý, vrátí hodnotu false.

Příklad 1

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

not(false)
not(true)

A vraťte tyto výsledky:

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

Příklad 2

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

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

A vrátí tyto výsledky:

  • První příklad: výraz má hodnotu false, takže funkce vrátí hodnotu true .
  • Druhý příklad: výraz má hodnotu true, takže funkce vrátí hodnotu false .

nebo

Ověřte, zda je alespoň jeden výraz pravdivý. Vrátí hodnotu true, pokud má alespoň jeden výraz hodnotu true, nebo vrátí hodnotu false, pokud jsou obě hodnoty false.

or(<expression1>, <expression2>)
Parametr Povinné Typ Description
<výraz1>, <Výraz2> Yes Logická hodnota Výrazy, které mají být zkontrolovány
Vrácená hodnota Typ Description
true nebo false Logická hodnota Vrátí hodnotu true, pokud má alespoň jeden výraz hodnotu true. Vrátí hodnotu false, pokud jsou oba výrazy nepravdivé.

Příklad 1

Tyto příklady kontrolují, zda alespoň jeden výraz má hodnotu true:

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

A vrátí tyto výsledky:

  • První příklad: nejméně jeden výraz má hodnotu true, takže funkce vrátí hodnotu true .
  • Druhý příklad: oba výrazy mají hodnotu false, takže funkce vrátí hodnotu false .

Příklad 2

Tyto příklady kontrolují, zda alespoň jeden výraz má hodnotu true:

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

A vrátí tyto výsledky:

  • První příklad: nejméně jeden výraz má hodnotu true, takže funkce vrátí hodnotu true .
  • Druhý příklad: oba výrazy mají hodnotu false, takže funkce vrátí hodnotu false .

rand

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

rand(<minValue>, <maxValue>)
Parametr Povinné Typ Description
<minValue> Yes Integer Nejnižší celé číslo v rozsahu
<maxValue> Yes Integer Celé číslo, které následuje po nejvyšší celé číslo v rozsahu, který může funkce vracet
Vrácená 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í jeden z těchto čísel jako výsledek: 1 , 2 , 3 nebo 4

range

Vrátí celočíselné pole, které začíná zadaným celým číslem.

range(<startIndex>, <count>)
Parametr Povinné Typ Description
<Indexu> Yes Integer Celočíselná hodnota, která spouští pole jako první položku
<výpočtu> Yes Integer Počet celých čísel v poli
Vrácená hodnota Typ Description
[<Rozsah-> výsledků ] Pole Pole s celými čísly počínaje zadaným indexem

Příklad

Tento příklad vytvoří celočíselné pole, které začíná od zadaného indexu a má zadaný počet celých čísel:

range(1, 4)

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

náhrady

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

replace('<text>', '<oldText>', '<newText>')
Parametr Povinné Typ Description
<textové> Ano Řetězec Řetězec, který má podřetězec, který má být nahrazen
<oldText> Ano Řetězec Dílčí řetězec, který má být nahrazen
<newText> Ano Řetězec Řetězec pro nahrazení
Vrácená hodnota Typ Description
<aktualizovaný text> Řetězec Aktualizovaný řetězec po nahrazení podřetězce

Pokud dílčí řetězec nebyl nalezen, vrátí původní řetězec.

Příklad

Tento příklad najde "starý" podřetězec v "starém řetězci" a nahradí "Old" novou:

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

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

Přeskočit

Odebere položky z přední části kolekce a vrátí všechny ostatní položky.

skip([<collection>], <count>)
Parametr Povinné Typ Description
<kolekce> Yes Pole Kolekce, jejíž položky chcete odebrat
<výpočtu> Yes Integer Kladné celé číslo pro počet položek, které se mají odebrat na začátku
Vrácená hodnota Typ Description
[<aktualizováno> kolekce ] Pole Aktualizovaná kolekce po odebrání zadaných položek

Příklad

Tento příklad odebere jednu položku, číslo 0, od začátku zadaného pole:

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

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

split

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

split('<text>', '<delimiter>')
Parametr Povinné Typ Description
<textové> Ano Řetězec Řetězec, který se má oddělit k podřetězcům na základě zadaného oddělovače v původním řetězci
<oddělovač> Ano Řetězec Znak v původním řetězci, který má být použit jako oddělovač
Vrácená hodnota Typ Description
[<subřetězec1>, <subřetězec2>,...] Pole Pole, které obsahuje 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 založeného na zadaném znaku jako oddělovač:

split('a_b_c', '_')

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

startOfDay

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

startOfDay('<timestamp>', '<format>'?)
Parametr Povinné Typ Description
<časové razítko> Ano Řetězec Řetězec, který obsahuje časové razítko
<formátovat> No Řetězec Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<Aktualizováno – časové razítko> Řetězec Zadané časové razítko, ale začíná nulovou časovou značkou dne

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 Povinné Typ Description
<časové razítko> Ano Řetězec Řetězec, který obsahuje časové razítko
<formátovat> No Řetězec Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<Aktualizováno – časové razítko> Řetězec Zadané časové razítko, ale začíná na označení 0 minuta za hodinu

Příklad

Tento příklad vyhledá 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 Povinné Typ Description
<Časové razítko> Ano Řetězec Řetězec obsahující časové razítko
<Formát> No Řetězec Specifikátor jednoho formátu nebo vzor vlastního formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss:fffffffK), který vyhovuje standardu ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<aktualizované časové razítko> Řetězec Zadané časové razítko, ale začíná prvním dnem v měsíci se značkou nula 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á konkrétním dílčím řetězcem. Vrátí hodnotu true, pokud je nalezen podřetězec, nebo vrátí hodnotu false, pokud nebyl nalezen. Tato funkce rozlišuje malá a velká písmena.

startsWith('<text>', '<searchText>')
Parametr Povinné Typ Description
<Text> Ano Řetězec Řetězec, který se má zkontrolovat
<searchText> Ano Řetězec Počáteční řetězec, který se má najít
Vrácená hodnota Typ Description
true nebo false Logická hodnota Vrátí hodnotu true, pokud je nalezen počáteční podřetězec. Pokud se nenašla hodnota false, vrátí hodnotu false.

Příklad 1

Tento příklad zkontroluje, jestli řetězec "hello world" začíná podřetězci "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ězci "greetings":

startsWith('hello world', 'greetings')

A vrátí tento výsledek: false

řetězec

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

string(<value>)
Parametr Povinné Typ Description
<Hodnotu> Yes Všechny Hodnota, která se má převést
Vrácená hodnota Typ Description
<řetězcová hodnota> Řetězec 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 znak zpětného lomítka ( ) jako řídicí znak pro dvojité \ uvozovky (").

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

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

Dílčí

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

sub(<minuend>, <subtrahend>)
Parametr Povinné Typ Description
<minuend (minuend)> Yes Integer nebo Float Číslo, od kterého se má odečíst dílčí operátor
<subtrahend (subtrahend( subtrahend> Yes Integer nebo Float Číslo, které se odečte od minuendu
Vrácená hodnota Typ Description
<Výsledek> Integer nebo Float Výsledek 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 Povinné Typ Description
<Text> Ano Řetězec Řetězec, jehož znaky chcete
<Startindex> Yes Integer Kladné číslo rovné nebo větší než 0, které chcete použít jako počáteční pozici nebo hodnotu indexu
<Délka> Yes Integer Kladný počet znaků, které chcete mít v podřetězci
Vrácená hodnota Typ Description
<výsledek podřetězce> Řetězec Podřetězec se zadaným počtem znaků začínající na zadané pozici indexu ve zdrojovém řetězci

Příklad

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

substring('hello world', 6, 5)

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

subtractFromTime

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

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parametr Povinné Typ Description
<Časové razítko> Ano Řetězec Řetězec obsahující časové razítko
<Interval> Yes Integer Počet zadaných časových jednotek, které se mají odečíst
<timeUnit> Ano Řetězec Jednotka času, která se má použít s intervalem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Formát> No Řetězec Specifikátor jednoho formátu nebo vzor vlastního formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss:fffffffK), který vyhovuje standardu ISO 8601 a zachovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<aktualizované časové razítko> Řetězec Č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 zepředu kolekce.

take('<collection>', <count>)
take([<collection>], <count>)
Parametr Povinné Typ Description
<Kolekce> Yes Řetězec nebo pole Kolekce, jejíž položky chcete
<Počet> Yes Integer Kladné celé číslo pro počet položek, které chcete zepředu
Vrácená hodnota Typ Description
<subset> nebo [<subset>] String (Řetězec) nebo Array (Pole) Ř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 zadat počet položek z přední části těchto kolekcí:

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

A vraťte tyto výsledky:

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

Klíšťata

Vrátí hodnotu ticks vlastnosti pro zadané časové razítko. Odškrtá se interval 100 nanosekund.

ticks('<timestamp>')
Parametr Povinné Typ Description
<Časové razítko> Ano Řetězec Řetězec časového razítka
Vrácená hodnota Typ Description
<takty – číslo> Integer Počet tiků od zadaného časového razítka

toLower

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

toLower('<text>')
Parametr Povinné Typ Description
<textové> Ano Řetězec Řetězec, který se má vrátit ve formátu malého písmene
Vrácená hodnota Typ Description
<malý text> Řetězec 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á velké písmeno, tento znak zůstane ve vráceném řetězci beze změny.

toUpper('<text>')
Parametr Povinné Typ Description
<textové> Ano Řetězec Řetězec, který se má vrátit ve formátu velkého písmene
Vrácená hodnota Typ Description
<Velká písmena textu> Řetězec Původní řetězec ve formátu velkých písmen

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"

sklon

Odstraňte úvodní a koncové mezery z řetězce a vraťte aktualizovaný řetězec.

trim('<text>')
Parametr Povinné Typ Description
<textové> Ano Řetězec Řetězec, který má počáteční a koncovou mezeru, která se má odebrat
Vrácená hodnota Typ Description
<updatedText> Řetězec Aktualizovaná verze původního řetězce bez počátečního nebo koncového znaku

Příklad

Tento příklad odstraní úvodní a koncové mezery 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í. Aby se zobrazila ve výsledku, může se položka objevit v jakékoli 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 se stejným názvem.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parametr Povinné Typ Description
<collection1> <Collection2>... Yes Pole nebo objekt, ale ne obojí Kolekce, ze kterých chcete všechny položky
Vrácená hodnota Typ Description
<aktualizacecollection> Pole nebo objekt, v uvedeném pořadí Kolekce se všemi položkami ze zadané kolekce – žádné duplicity

Příklad

Tento příklad načte 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

Nahrazením znaků, které nejsou v adrese URL, pomocí řídicích znaků vrátíte verzi kódovanou podle identifikátoru URI (Uniform Resource Identifier) pro řetězec. Použijte tuto funkci místo encodeURIComponent – (). I když obě funkce fungují stejným způsobem, uriComponent() jsou upřednostňovány.

uriComponent('<value>')
Parametr Povinné Typ Description
<osa> Ano Řetězec Řetězec, který se má převést na formát kódovaný identifikátorem URI
Vrácená hodnota Typ Description
<kódovaný identifikátor URI> Řetězec Řetězec kódovaný identifikátorem URI s řídicími znaky

Příklad

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

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

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

uriComponentToBinary

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

uriComponentToBinary('<value>')
Parametr Povinné Typ Description
<osa> Ano Řetězec Řetězec kódovaný identifikátorem URI, který se má převést
Vrácená hodnota Typ Description
<binární-pro kódovaný identifikátor URI> Řetězec Binární verze řetězce zakódovaného identifikátorem URI. Binární obsah je kódovaný v kódování Base64 a reprezentován $content .

Příklad

Tento příklad vytvoří binární verzi pro tento řetězec kódovaný pomocí identifikátoru 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ý v identifikátoru URI (Uniform Resource Identifier), který efektivně Dekóduje řetězec kódovaný identifikátorem URI.

uriComponentToString('<value>')
Parametr Povinné Typ Description
<osa> Ano Řetězec Řetězec kódovaný identifikátorem URI k dekódování
Vrácená hodnota Typ Description
<Dekódovatelné – identifikátor URI> Řetězec Dekódovaná verze řetězce zakódovaného identifikátorem URI

Příklad

Tento příklad vytvoří dekódovanou verzi řetězce pro tento řetězec kódovaný pomocí identifikátoru 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 s parametrem <formát>.

Parametr Povinné Typ Description
<formátovat> No Řetězec Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu.
Vrácená hodnota Typ Description
<aktuální – časové razítko> Řetězec Aktuální datum a čas

Příklad 1

Dnes Předpokládejme 15. dubna 2018 v 1:00:00 odp. 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

Dnes Předpokládejme 15. dubna 2018 v 1:00:00 odp. 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 Povinné Typ Description
<osa> Ano Řetězec Řetězec s objektem JSON, který se má převést

Objekt JSON musí mít pouze jednu kořenovou vlastnost, která nemůže být polem.
\Jako řídicí znak dvojité uvozovky (") použijte znak zpětného lomítka ().

Vrácená hodnota Typ Description
<verze XML> Objekt 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>

cestou

Zkontroluje 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 pouze "XPath", vám pomůže přejít na strukturu dokumentu XML, abyste mohli vybrat uzly nebo výpočetní hodnoty v obsahu XML.

xpath('<xml>', '<xpath>')
Parametr Povinné Typ Description
<XML> Yes Všechny Řetězec XML pro vyhledání uzlů nebo hodnot, které odpovídají hodnotě výrazu XPath
<cestou> Yes Všechny Výraz XPath, který slouží k vyhledání odpovídajícího uzlu XML nebo hodnot
Vrácená hodnota Typ Description
<uzel XML> XML Uzel XML, pokud pouze jeden uzel odpovídá zadanému výrazu XPath
<osa> Všechny Hodnota z uzlu XML, pokud je pouze jedna hodnota shodná se zadaným výrazem XPath
[<XML-uzel1>, <xml-Uzel2>,...]
-nebo-
[<hodnota1>, <hodnota2>,...]
Pole Pole s uzly XML nebo hodnotami, které odpovídají zadanému výrazu XPath

Příklad 1

V příkladu 1 Tento příklad najde uzly, které odpovídají uzlu, <count></count> 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 vyhledají uzly, které odpovídají <location></location> uzlu, v zadaných argumentech, které obsahují XML s oborem názvů. Výrazy používají znak zpětného lomítka ( \ ) jako řídicí znak pro dvojité 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ý zahrnuje obor názvů dokumentu XML, xmlns="http://contoso.com" :

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

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

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

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

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

Příklad 3

Následující příklad v příkladu 3 najde hodnotu v <location></location> uzlu:

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

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

Další kroky

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