Kifejezések és függvények az Azure Data Factoryben és az Azure Synapse Analyticsben

Cikk
05/17/2024

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk részletesen ismerteti az Azure Data Factory és az Azure Synapse Analytics által támogatott kifejezéseket és függvényeket.

Kifejezések

A definíció JSON-értékei lehetnek konstansok vagy futásidőben kiértékelt kifejezések. Példa:

"name": "value"

vagy

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

A kifejezések bárhol megjelenhetnek egy JSON-sztringértékben, és mindig egy másik JSON-értéket eredményeznek. Ha egy JSON-érték kifejezés, a rendszer az at-sign (@) eltávolításával nyeri ki a kifejezés törzsét. Ha @-val kezdődő literális sztringre van szükség, akkor a @@használatával kell megszabadulnia. Az alábbi példák a kifejezések kiértékelésének módját mutatják be.

JSON-érték	Eredmény
"paraméterek"	A rendszer a "paraméterek" karaktereket adja vissza.
"paraméterek[1]"	A rendszer a "parameters[1]" karaktereket adja vissza.
"@@"	A függvény egy 1 karakteres sztringet ad vissza, amely "@" karaktert tartalmaz.
" @"	A függvény egy 2 karakteres sztringet ad vissza, amely a "@" karaktert tartalmazza.

A kifejezések sztringeken belül is megjelenhetnek egy sztring interpoláció nevű funkcióval, amelyben a kifejezések be vannak csomagolva@{ ... }. Például: "name" : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Sztring interpolációval az eredmény mindig sztring. Tegyük fel, hogy definiáltam myNumber a következőt 42 foo:myString

JSON-érték	Eredmény
"@pipeline().parameters.myString"	Sztringként ad `foo` vissza.
"@{pipeline().parameters.myString}"	Sztringként ad `foo` vissza.
"@pipeline().parameters.myNumber"	`42` Számként adja vissza.
"@{pipeline().parameters.myNumber}"	Sztringként ad `42` vissza.
"Válasz: @{pipeline().parameters.myNumber}"	A sztringet `Answer is: 42`adja vissza.
"@concat('Válasz: ', string(pipeline().parameters.myNumber))"	A sztring visszaadása `Answer is: 42`
"Válasz: @@{pipeline().parameters.myNumber}"	A sztringet `Answer is: @{pipeline().parameters.myNumber}`adja vissza.

Az olyan vezérlőfolyamat-tevékenységekben, mint a ForEach-tevékenység, megadhat egy tömböt, amely át lesz iterálva a tulajdonságelemekhez, és a ForEach-tevékenység egyetlen enumerálásán keresztüli iterálására használható @item() . Ha például az elemek tömbök: [1, 2, 3], az első iterációban 1, @item() a második iterációban 2, a harmadik iterációban pedig 3 értéket ad vissza. A hasonló kifejezéssel tízszer is @range(0,10) iterálhat, kezdve a 0 és a 9 végződés között.

A "tevékenység neve" használatával @activity(rögzítheti a tevékenység kimenetét, és döntéseket hozhat. Fontolja meg a Web1 nevű webes tevékenységet. Az első tevékenység kimenetének a második törzsben való elhelyezéséhez a kifejezés általában a következőképpen néz ki: @activity('Web1').output vagy @activity('Web1').output.data vagy valami hasonló attól függően, hogy az első tevékenység kimenete hogyan néz ki.

Példák

Összetett kifejezési példa

Az alábbi példa egy összetett példát mutat be, amely a tevékenység kimenetének egy mély almezőjére hivatkozik. Ha egy almezőre kiértékelt folyamatparaméterre szeretne hivatkozni, használja a [] szintaxist pont(.) operátor helyett (mint az almező1 és az almező2 esetében), egy tevékenységkimenet részeként.

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

A fájlok dinamikus létrehozása és elnevezése gyakori minta. Tekintsünk át néhány dinamikus fájlelnevezési példát.

Dátum hozzáfűzése fájlnévhez: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
Dátum/idő hozzáfűzése az ügyfél időzónájában: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
Hozzáfűzési eseményindító ideje: @concat('Test_', pipeline().TriggerTime)
Egyéni fájlnevet ad ki egy leképezési Adatfolyam, amikor egyetlen fájlra ad ki dátumot:'Test_' + toString(currentDate()) + '.csv'

A fenti esetekben 4 dinamikus fájlnév jön létre a Test_ kezdve.

Dinamikus tartalomszerkesztő

A dinamikus tartalomszerkesztő automatikusan kikerüli a tartalom karaktereit a szerkesztés befejezésekor. A tartalomszerkesztőben például a következő tartalom egy sztring interpolációja két kifejezésfüggvényrel.

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

A dinamikus tartalomszerkesztő a fenti tartalmat kifejezéssé "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}"alakítja. Ennek a kifejezésnek az eredménye egy alább bemutatott JSON formátumú sztring.

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

Paraméterrel rendelkező adatkészlet

Az alábbi példában a BlobDataset egy elérési út nevű paramétert vesz fel. Az érték a folderPath tulajdonság értékének beállítására szolgál a következő kifejezéssel: dataset().path.

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

Folyamat paraméterrel

A következő példában a folyamat inputPath- és outputPath-paramétereket vesz fel. A paraméteres blobadatkészlet elérési útja ezen paraméterek értékeinek használatával van beállítva. Az itt használt szintaxis a következő: 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"
            }
        }
    }
}

Speciális karakterek cseréje

A dinamikus tartalomszerkesztő automatikusan eltávolítja a karaktereket, például a dupla idézőjelet, a fordított perjelet a tartalomban a szerkesztés befejezésekor. Ez problémát okoz, ha a sorcsatornát vagy a tabulátort a \n, \t a replace() függvény használatával szeretné lecserélni. A dinamikus tartalom kódnézetben történő szerkesztésével eltávolíthatja az extra \ karaktert a kifejezésből, vagy az alábbi lépéseket követve lecserélheti a speciális karaktereket a kifejezés nyelvével:

URL-kódolás az eredeti sztringértékhez
Cserélje le az URL-kódolt sztringet, például a vonalcsatornát (%0A), a kocsi visszatérését (%0D), a vízszintes lapot (%09).
URL-dekódolás

Például a változó companyName tulajdonsága, amelynek értéke egy újsoros karakter, a kifejezés @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) eltávolíthatja az újsoros karaktert.

Contoso-
Corporation

Egyetlen idézőjel eleje

A folyamatok kifejezésfüggvényei az egyszeres idézőjelet (') használják a sztringérték paramétereinek körülvéve. A folyamat sztringkifejezésében két egymást követő egy idézőjel karaktert használjon egyetlen idézőjel hozzáadásához. Íme egy példa: a kifejezés @concat('Here is a double quote character: ". ', 'And here is a single quote character all within the same string: ''.') a következő eredményt adja vissza:

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

Az adatfolyam-kifejezésekben azonban ez a szintaxis nem támogatott. Ehelyett az adatfolyam-kifejezéseket egyetlen vagy dupla idézőjelek is körülvehetik. A sztringfüggvényeken belül egyetlen idézőjelet igénylő szöveget, a sztringfüggvényeken belül pedig dupla idézőjeleket igénylő szöveget foglal magában. Ha egy és két idézőjelet is tartalmazó sztringre van szüksége, két olyan részsztringet egyesíthet concat() , amelyek mindegyike egyetlen vagy dupla idézőjelet tartalmaz. Az előző folyamatkifejezési példa adatfolyam-megfelelője a következő lenne concat('Here is a double quote character: ". ', "And here is a single quote character all within the same string: '."): . Egy adatfolyamban ez a kifejezés ugyanazt az eredményt adja vissza, mint a folyamatkifejezések előző példáját.

Oktatóanyag

Ez az oktatóanyag bemutatja, hogyan adhat át paramétereket egy folyamat és tevékenység, valamint a tevékenységek között. Az oktatóanyag kifejezetten az Azure Data Factory lépéseit mutatja be, bár a Synapse-munkaterület lépései szinte egyenértékűek, de kissé eltérő felhasználói felülettel.

Függvények

Függvényeket a kifejezéseken belül is meghívhat. A következő szakaszok a kifejezésekben használható függvényekről nyújtanak információkat.

Dátumfüggvények

Dátum- vagy időfüggvény	Task
addDays	Adjon hozzá néhány napot egy időbélyeghez.
addHours	Adjon hozzá több órát egy időbélyeghez.
addMinutes	Adjon hozzá néhány percet egy időbélyeghez.
addSeconds	Adjon hozzá néhány másodpercet egy időbélyeghez.
addToTime	Adjon hozzá több időegységet egy időbélyeghez. Lásd még : getFutureTime.
convertFromUtc	Időbélyeg konvertálása az univerzális idő szerint koordinált (UTC) időzónából a cél időzónába.
convertTimeZone	Időbélyeg konvertálása a forrás időzónából a cél időzónává.
convertToUtc	Időbélyeg konvertálása a forrás időzónából univerzális idő koordinált (UTC) időzónává.
dayOfMonth	Adja vissza a hónap napját egy időbélyegből.
dayOfWeek	A hét napját adja vissza egy időbélyegből.
dayOfYear	Az év napját adja vissza egy időbélyegből.
formatDateTime	Az időbélyeget sztringként adja vissza opcionális formátumban.
getFutureTime	Adja vissza az aktuális időbélyeget és a megadott időegységeket. Lásd még : addToTime.
getPastTime	Az aktuális időbélyeget adja vissza a megadott időegységekkel együtt. Lásd még : subtractFromTime.
startOfDay	Az időbélyeg napjának kezdetét adja vissza.
startOfHour	Az óra kezdetét adja vissza egy időbélyeghez.
startOfMonth	Adja vissza a hónap kezdetét egy időbélyeghez.
subtractFromTime	Vonjon ki több időegységet egy időbélyegből. Lásd még : getPastTime.
Kullancsok	`ticks` Adott időbélyeg tulajdonságértékének visszaadása.
utcNow	Az aktuális időbélyeg visszaadása sztringként.

Sztringfüggvények

A sztringek használatához használhatja ezeket a sztringfüggvényeket és néhány gyűjteményfüggvényt is. A sztringfüggvények csak sztringeken működnek.

Sztringfüggvény	Task
összefűzés	Két vagy több sztring egyesítése és az egyesített sztring visszaadása.
endsWith	Ellenőrizze, hogy egy sztring a megadott részsztringgel végződik-e.
Guid	Globálisan egyedi azonosító (GUID) létrehozása sztringként.
indexOf	Egy részszúrás kezdőpozíciójának visszaadása.
lastIndexOf	Adja vissza az alsztring utolsó előfordulásának kezdő pozícióját.
helyettesít	Cserélje le az alsztringet a megadott sztringre, és adja vissza a frissített sztringet.
hasít	Sztring felosztása egy adott elválasztó minden előfordulására, és az eredményül kapott részsztringeket egy tömb elemeiként adja vissza.
startsWith	Ellenőrizze, hogy egy sztring egy adott részsztringgel kezdődik-e.
Substring	Karaktereket ad vissza egy sztringből, a megadott pozíciótól kezdve.
toLower	Kisbetűs karakterláncot ad vissza.
toUpper	Karakterláncot ad vissza nagybetűs formátumban.
nyír	Távolítsa el a kezdő és záró szóközt egy sztringből, és adja vissza a frissített sztringet.

Gyűjteményfüggvények

Gyűjtemények, általában tömbök, sztringek és néha szótárak használatához használhatja ezeket a gyűjteményfüggvényeket.

Gyűjteményfüggvény	Task
Tartalmaz	Ellenőrizze, hogy egy gyűjtemény tartalmaz-e egy adott elemet.
üres	Ellenőrizze, hogy egy gyűjtemény üres-e.
első	Egy gyűjtemény első elemének visszaadása.
útkereszteződés	Olyan gyűjteményt ad vissza, amely csak a megadott gyűjtemények közös elemeit tartalmazza.
csatlakozás	Olyan sztringet ad vissza, amely egy tömb összes elemét tartalmazza, a megadott karakterrel elválasztva.
utolsó	Egy gyűjtemény utolsó elemének visszaadása.
length (hossz)	Egy sztring vagy tömb elemeinek számát adja vissza.
átugrik	Távolítsa el az elemeket a gyűjtemény elejéről, és adja vissza az összes többi elemet.
vesz	Elemeket ad vissza a gyűjtemény elejéről.
unió	Olyan gyűjteményt ad vissza, amely a megadott gyűjtemények összes elemét tartalmazza.

Logikai függvények

Ezek a függvények a feltételeken belül hasznosak, bármilyen típusú logika kiértékelésére használhatók.

Logikai összehasonlító függvény	Task
és	Ellenőrizze, hogy az összes kifejezés igaz-e.
Egyenlő	Ellenőrizze, hogy mindkét érték egyenértékű-e.
Nagyobb	Ellenőrizze, hogy az első érték nagyobb-e a másodiknál.
greaterOrEquals	Ellenőrizze, hogy az első érték nagyobb-e, mint a második érték.
ha	Ellenőrizze, hogy egy kifejezés igaz vagy hamis-e. Az eredmény alapján adjon vissza egy megadott értéket.
kevesebb	Ellenőrizze, hogy az első érték kisebb-e a másodiknál.
lessOrEquals	Ellenőrizze, hogy az első érték kisebb-e, mint a második érték.
nem	Ellenőrizze, hogy egy kifejezés hamis-e.
vagy	Ellenőrizze, hogy legalább egy kifejezés igaz-e.

Konverziós függvények

Ezek a függvények a nyelv natív típusai közötti konvertálásra szolgálnak:

húr
egész szám
float
Logikai
Tömbök
Szótárak

Konvertálási függvény	Task
tömb	Tömb visszaadása egyetlen megadott bemenetből. Több bemenet esetén lásd: createArray.
base64	Visszaadja egy sztring base64 kódolású verzióját.
base64ToBinary	Egy base64 kódolású sztring bináris verzióját adja vissza.
base64ToString	Egy base64 kódolású sztring sztringverzióját adja vissza.
bináris	Adja vissza egy bemeneti érték bináris verzióját.
Bool	Adja vissza egy bemeneti érték logikai verzióját.
összenő	Az első nem null értéket adja vissza egy vagy több paraméterből.
createArray	Több bemenetből származó tömböt ad vissza.
dataUri	Adja vissza egy bemeneti érték adat URI-jának értékét.
dataUriToBinary	Adja vissza egy adat URI bináris verzióját.
dataUriToString	Az adat URI sztringverziójának visszaadása.
decodeBase64	Egy base64 kódolású sztring sztringverzióját adja vissza.
decodeDataUri	Adja vissza egy adat URI bináris verzióját.
decodeUriComponent	Visszaad egy sztringet, amely a feloldó karaktereket dekódolt verziókra cseréli.
encodeUriComponent	Olyan sztringet ad vissza, amely az URL-cím szempontjából nem biztonságos karaktereket feloldó karakterekre cseréli.
lebeg	Egy bemeneti érték lebegőpontos számát adja vissza.
Int	Egy sztring egész verziójának visszaadása.
json	Adja vissza egy sztring vagy XML JavaScript Object Notation (JSON) típusértékét vagy objektumát.
húr	Adja vissza egy bemeneti érték sztringverziójának értékét.
uriComponent	Adja vissza egy bemeneti érték URI-kódolású verzióját úgy, hogy az URL-cím szempontjából nem biztonságos karaktereket feloldó karakterekre cseréli.
uriComponentToBinary	Adja vissza az URI-kódolt sztring bináris verzióját.
uriComponentToString	Adja vissza egy URI-kódolt sztring sztringverzióját.
xml	Sztring XML-verzióját adja vissza.
xpath	Ellenőrizze az XML-ben az XPath (XML Path Language) kifejezésnek megfelelő csomópontokat vagy értékeket, és adja vissza az egyező csomópontokat vagy értékeket.

Matematikai függvények

Ezek a függvények bármilyen típusú számhoz használhatók: egész számokhoz és lebegőpontosakhoz.

Matematikai függvény	Task
hozzáad	Két szám hozzáadásának eredményét adja vissza.
Div	Egy szám egy másik számmal való felosztásának eredményét adja vissza.
max	Számkészletből vagy tömbből a legmagasabb értéket adja vissza.
Min	A legkisebb értéket adja vissza számkészletből vagy tömbből.
Mod	Adja vissza a maradékot attól, hogy egy számot eloszt egy másik számmal.
mul	Adja vissza a szorzatot két szám szorzásából.
Rand	Véletlenszerű egész számot ad vissza egy megadott tartományból.
tartomány	Adott egész számból induló egész tömböt ad vissza.
al	Egy szám kivonásának eredményét adja vissza egy másik számból.

Függvényreferencia

Ez a szakasz az összes elérhető függvényt betűrendben sorolja fel.

add

Két szám hozzáadásának eredményét adja vissza.

add(<summand_1>, <summand_2>)

Paraméter	Kötelező	Típus	Leírás
<>summand_1, <summand_2>	Igen	Egész szám, lebegőpontos vagy vegyes	A hozzáadni kívánt számok

Visszaadott érték	Típus	Leírás
<eredmény-összeg>	Egész szám vagy lebegőpontos	A megadott számok hozzáadásának eredménye

Példa

Ez a példa a megadott számokat adja hozzá:

add(1, 1.5)

És ezt az eredményt adja vissza: 2.5

addDays

Adjon hozzá néhány napot egy időbélyeghez.

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

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<Napok>	Igen	Egész	A hozzáadandó napok pozitív vagy negatív száma
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<frissített időbélyeg>	Sztring	Az időbélyeg és a megadott számú nap

1\. példa

Ez a példa 10 napot ad hozzá a megadott időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-03-25T00:00:0000000Z"

2\. példa

Ez a példa öt napot von ki a megadott időbélyegből:

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

És ezt az eredményt adja vissza: "2018-03-10T00:00:0000000Z"

addHours

Adjon hozzá több órát egy időbélyeghez.

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

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<hours>	Igen	Egész	A hozzáadni kívánt órák pozitív vagy negatív száma
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<frissített időbélyeg>	Sztring	Az időbélyeg és a megadott számú óra

1\. példa

Ez a példa 10 órát ad hozzá a megadott időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-03-15T10:00:0000000Z"

2\. példa

Ez a példa öt órát von ki a megadott időbélyegből:

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

És ezt az eredményt adja vissza: "2018-03-15T10:00:0000000Z"

addMinutes

Adjon hozzá néhány percet egy időbélyeghez.

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

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<minutes>	Igen	Egész	A hozzáadandó percek pozitív vagy negatív száma
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<frissített időbélyeg>	Sztring	Az időbélyeg és a megadott számú perc

1\. példa

Ez a példa 10 percet ad hozzá a megadott időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-03-15T00:20:00.0000000Z"

2\. példa

Ez a példa öt percet von ki a megadott időbélyegből:

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

És ezt az eredményt adja vissza: "2018-03-15T00:15:00.0000000Z"

addSeconds

Adjon hozzá néhány másodpercet egy időbélyeghez.

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

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<repeta>	Igen	Egész	A hozzáadandó másodpercek pozitív vagy negatív száma
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<frissített időbélyeg>	Sztring	Az időbélyeg és a megadott számú másodperc

1\. példa

Ez a példa 10 másodpercet ad hozzá a megadott időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-03-15T00:00:10.0000000Z"

2\. példa

Ez a példa öt másodpercet von ki a megadott időbélyegből:

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

És ezt az eredményt adja vissza: "2018-03-15T00:00:25.0000000Z"

addToTime

Adjon hozzá több időegységet egy időbélyeghez. Lásd még : getFutureTime().

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

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<interval>	Igen	Egész	A hozzáadni kívánt időegységek száma
<timeUnit>	Igen	Sztring	Az intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<frissített időbélyeg>	Sztring	Az időbélyeg és a megadott számú időegység

1\. példa

Ez a példa egy napot ad hozzá a megadott időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-01-02T00:00:00.0000000Z"

2\. példa

Ez a példa egy napot ad hozzá a megadott időbélyeghez:

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

Az eredményt az opcionális "D" formátummal adja vissza: "Tuesday, January 2, 2018"

és

Ellenőrizze, hogy mindkét kifejezés igaz-e. Igaz értéket ad vissza, ha mindkét kifejezés igaz, vagy hamis értéket ad vissza, ha legalább egy kifejezés hamis.

and(<expression1>, <expression2>)

Paraméter	Kötelező	Típus	Leírás
<kifejezés1>, <kifejezés2>	Igen	Logikai	Az ellenőrizni kívánt kifejezések

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha mindkét kifejezés igaz. Hamis értéket ad vissza, ha legalább egy kifejezés hamis.

1\. példa

Ezek a példák ellenőrzik, hogy a megadott logikai értékek egyaránt igazak-e:

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

És a következő eredményeket adja vissza:

Első példa: Mindkét kifejezés igaz, ezért visszaadja true.
Második példa: Az egyik kifejezés hamis, ezért visszaadja false.
Harmadik példa: Mindkét kifejezés hamis, ezért visszaadja false.

2\. példa

Ezek a példák ellenőrzik, hogy a megadott kifejezések mindegyike igaz-e:

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

És a következő eredményeket adja vissza:

Első példa: Mindkét kifejezés igaz, ezért visszaadja true.
Második példa: Az egyik kifejezés hamis, ezért visszaadja false.
Harmadik példa: Mindkét kifejezés hamis, ezért visszaadja false.

array

Tömb visszaadása egyetlen megadott bemenetből. Több bemenet esetén lásd: createArray().

array('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	A tömb létrehozására szolgáló sztring

Visszaadott érték	Típus	Leírás
[<érték>]	Tömb	Az egyetlen megadott bemenetet tartalmazó tömb

Példa

Ez a példa létrehoz egy tömböt a "hello" sztringből:

array('hello')

És ezt az eredményt adja vissza: ["hello"]

base64

Visszaadja egy sztring base64 kódolású verzióját.

base64('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	A bemeneti sztring

Visszaadott érték	Típus	Leírás
<base64-sztring>	Sztring	A bemeneti sztring base64 kódolású verziója

Példa

Ez a példa a "hello" sztringet base64 kódolású sztringgé alakítja:

base64('hello')

És ezt az eredményt adja vissza: "aGVsbG8="

base64ToBinary

Egy base64 kódolású sztring bináris verzióját adja vissza.

base64ToBinary('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	A konvertálni kívánt base64 kódolású sztring

Visszaadott érték	Típus	Leírás
<binary-for-base64-string>	Sztring	A base64 kódolású sztring bináris verziója

Példa

Ez a példa az "aGVsbG8=" base64 kódolású sztringet bináris sztringgé alakítja:

base64ToBinary('aGVsbG8=')

És ezt az eredményt adja vissza:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Adja vissza egy base64 kódolású sztring sztringverzióját, amely hatékonyan dekódolja a base64 sztringet. Használja ezt a függvényt a decodeBase64() helyett. Bár mindkét függvény ugyanúgy működik, base64ToString() előnyben részesítjük.

base64ToString('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	A dekódolni kívánt base64-kódolású sztring

Visszaadott érték	Típus	Leírás
<dekódolt-base64-sztring>	Sztring	A base64 kódolású sztringek sztringverziója

Példa

Ez a példa az "aGVsbG8=" base64 kódolású sztringet csak egy sztringgé alakítja:

base64ToString('aGVsbG8=')

És ezt az eredményt adja vissza: "hello"

bináris

Sztring bináris verzióját adja vissza.

binary('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	Az átalakítandó sztring

Visszaadott érték	Típus	Leírás
<bináris-for-input-value>	Sztring	A megadott sztring bináris verziója

Példa

Ez a példa bináris sztringgé alakítja a "hello" sztringet:

binary('hello')

És ezt az eredményt adja vissza:

"0110100001100101011011000110110001101111"

logikai

Egy érték logikai verzióját adja vissza.

bool(<value>)

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Bármely	Az átalakítandó érték

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	A megadott érték logikai verziója

Példa

Ezek a példák a megadott értékeket logikai értékekké alakítják át:

bool(1)
bool(0)

És a következő eredményeket adja vissza:

Első példa: true
Második példa: false

összenő

Az első nem null értéket adja vissza egy vagy több paraméterből. Az üres sztringek, üres tömbök és üres objektumok nem null értékűek.

coalesce(<object_1>, <object_2>, ...)

Paraméter	Kötelező	Típus	Leírás
<>object_1, <object_2>, ...	Igen	Bármelyik, keverheti a típusokat	Egy vagy több, null értéket ellenőrizni kívánt elem

Visszaadott érték	Típus	Leírás
<első nem null értékű elem>	Bármely	Az első elem vagy érték, amely nem null értékű. Ha minden paraméter null értékű, akkor a függvény null értéket ad vissza.

Példa

Ezek a példák a megadott értékek közül az első nem null értéket, vagy null értéket adnak vissza, ha az összes érték null:

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

És a következő eredményeket adja vissza:

Első példa: true
Második példa: "hello"
Harmadik példa: null

összefűzés

Két vagy több sztring egyesítése és az egyesített sztring visszaadása.

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

Paraméter	Kötelező	Típus	Leírás
<szöveg1>, <szöveg2>, ...	Igen	Sztring	Legalább két egyesítendő sztring

Visszaadott érték	Típus	Leírás
<text1text2...>	Sztring	A kombinált bemeneti sztringekből létrehozott sztring

Példa

Ez a példa egyesíti a "Hello" és a "World" sztringeket:

concat('Hello', 'World')

És ezt az eredményt adja vissza: "HelloWorld"

contains

Ellenőrizze, hogy egy gyűjtemény tartalmaz-e egy adott elemet. Igaz értéket ad vissza az elem megtalálásakor, vagy hamis értéket ad vissza, ha nem található. Ez a függvény megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.

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

Ez a függvény az alábbi gyűjteménytípusokon működik:

Sztring az alsztring kereséséhez
Egy tömb, amely egy értéket keres
Szótár a kulcs megkereséséhez

Paraméter	Kötelező	Típus	Leírás
<gyűjtemény>	Igen	Sztring, tömb vagy szótár	Az ellenőrizni kívánt gyűjtemény
<value>	Igen	Sztring, tömb vagy szótár	A keresendő elem

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza az elem megtalálásakor. Hamis értéket ad vissza, ha nem található.

1\. példa

Ez a példa ellenőrzi a "hello world" sztringet a "világ" részsztringnél, és igaz értéket ad vissza:

contains('hello world', 'world')

2\. példa

Ez a példa ellenőrzi a "hello world" sztringet a "világegyetem" részláncában, és hamis értéket ad vissza:

contains('hello world', 'universe')

convertFromUtc

Időbélyeg konvertálása az univerzális idő szerint koordinált (UTC) időzónából a cél időzónába.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<destinationTimeZone>	Igen	Sztring	A cél időzóna neve. Az időzónanevekről a Microsoft időzóna-értékei című témakörben olvashat, de előfordulhat, hogy el kell távolítania az írásjeleket az időzóna nevéből.
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<konvertált időbélyeg>	Sztring	A cél időzónává konvertált időbélyeg

1\. példa

Ez a példa az időbélyeget a megadott időzónává alakítja:

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

És ezt az eredményt adja vissza: "2018-01-01T00:00:00Z"

2\. példa

Ez a példa az időbélyeget a megadott időzónává és formátummá alakítja:

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

És ezt az eredményt adja vissza: "Monday, January 1, 2018"

convertTimeZone

Időbélyeg konvertálása a forrás időzónából a cél időzónává.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<sourceTimeZone>	Igen	Sztring	A forrás időzóna neve. Az időzónanevekről a Microsoft időzóna-értékei című témakörben olvashat, de előfordulhat, hogy el kell távolítania az írásjeleket az időzóna nevéből.
<destinationTimeZone>	Igen	Sztring	A cél időzóna neve. Az időzónanevekről a Microsoft időzóna-értékei című témakörben olvashat, de előfordulhat, hogy el kell távolítania az írásjeleket az időzóna nevéből.
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<konvertált időbélyeg>	Sztring	A cél időzónává konvertált időbélyeg

1\. példa

Ez a példa a forrás időzónát a cél időzónává alakítja:

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

És ezt az eredményt adja vissza: "2018-01-01T00:00:00.0000000"

2\. példa

Ez a példa átalakít egy időzónát a megadott időzónává és formátumba:

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

És ezt az eredményt adja vissza: "Monday, January 1, 2018"

convertToUtc

Időbélyeg konvertálása a forrás időzónából univerzális idő koordinált (UTC) időzónává.

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<sourceTimeZone>	Igen	Sztring	A forrás időzóna neve. Az időzónanevekről a Microsoft időzóna-értékei című témakörben olvashat, de előfordulhat, hogy el kell távolítania az írásjeleket az időzóna nevéből.
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<konvertált időbélyeg>	Sztring	Az időbélyeg UTC-vé konvertálva

1\. példa

Ez a példa az időbélyeget UTC-vé alakítja:

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

És ezt az eredményt adja vissza: "2018-01-01T08:00:00.0000000Z"

2\. példa

Ez a példa az időbélyeget UTC-vé alakítja:

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

És ezt az eredményt adja vissza: "Monday, January 1, 2018"

createArray

Több bemenetből származó tömböt ad vissza. Egyetlen bemeneti tömb esetén lásd a tömb()-et.

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

Paraméter	Kötelező	Típus	Leírás
<object1>, <object2>, ...	Igen	Bármely, de nem vegyes	Legalább két elem a tömb létrehozásához

Visszaadott érték	Típus	Leírás
[<object1>, <object2>, ...]	Tömb	Az összes bemeneti elemből létrehozott tömb

Példa

Ez a példa a következő bemenetekből hoz létre tömböt:

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

És ezt az eredményt adja vissza: ["h", "e", "l", "l", "o"]

dataUri

Egy sztring egységes erőforrás-azonosítóját (URI) adja vissza.

dataUri('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	Az átalakítandó sztring

Visszaadott érték	Típus	Leírás
<data-uri>	Sztring	A bemeneti sztring adat-URI-ja

Példa

Ez a példa létrehoz egy adat URI-t a "hello" sztringhez:

dataUri('hello')

És ezt az eredményt adja vissza: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Adja vissza az egységes adaterőforrás-azonosító (URI) bináris verzióját. Használja ezt a függvényt a decodeDataUri() helyett. Bár mindkét függvény ugyanúgy működik, dataUriBinary() előnyben részesítjük.

dataUriToBinary('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	Az átalakítandó adat URI-ja

Visszaadott érték	Típus	Leírás
<binary-for-data-uri>	Sztring	Az adat URI bináris verziója

Példa

Ez a példa létrehoz egy bináris verziót az adat URI-hoz:

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

És ezt az eredményt adja vissza:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Adja vissza az egységes adaterőforrás-azonosító (URI) sztringverzióját.

dataUriToString('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	Az átalakítandó adat URI-ja

Visszaadott érték	Típus	Leírás
<sztring for-data-uri>	Sztring	Az adat URI sztringverziója

Példa

Ez a példa létrehoz egy sztringet ehhez az adat URI-hoz:

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

És ezt az eredményt adja vissza: "hello"

dayOfMonth

Adja vissza a hónap napját egy időbélyegből.

dayOfMonth('<timestamp>')

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring

Visszaadott érték	Típus	Leírás
<hónap napja>	Egész	A hónap napja a megadott időbélyegből

Példa

Ez a példa a hónap napjának számát adja vissza ebből az időbélyegből:

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

És ezt az eredményt adja vissza: 15

dayOfWeek

Adja vissza a hét napját egy időbélyegből.

dayOfWeek('<timestamp>')

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring

Visszaadott érték	Típus	Leírás
<hét napja>	Egész	A hét napja a megadott időbélyegből, ahol a vasárnap 0, a hétfő 1, és így tovább

Példa

Ez a példa a hét napjának számát adja vissza ebből az időbélyegből:

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

És ezt az eredményt adja vissza: 3

dayOfYear

Az év napját adja vissza egy időbélyegből.

dayOfYear('<timestamp>')

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring

Visszaadott érték	Típus	Leírás
<év napja>	Egész	Az év napja a megadott időbélyegből

Példa

Ez a példa az év napjának számát adja vissza ebből az időbélyegből:

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

És ezt az eredményt adja vissza: 74

decodeBase64

Adja vissza egy base64 kódolású sztring sztringverzióját, amely hatékonyan dekódolja a base64 sztringet. Fontolja meg a base64ToString() használatát ahelyett, hogy decodeBase64(). Bár mindkét függvény ugyanúgy működik, base64ToString() előnyben részesítjük.

decodeBase64('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	A dekódolni kívánt base64-kódolású sztring

Visszaadott érték	Típus	Leírás
<dekódolt-base64-sztring>	Sztring	A base64 kódolású sztringek sztringverziója

Példa

Ez a példa létrehoz egy sztringet egy base64 kódolású sztringhez:

decodeBase64('aGVsbG8=')

És ezt az eredményt adja vissza: "hello"

decodeDataUri

Adja vissza az egységes adaterőforrás-azonosító (URI) bináris verzióját. Fontolja meg a dataUriToBinary() használatát ahelyett, hogy decodeDataUri(). Bár mindkét függvény ugyanúgy működik, dataUriToBinary() előnyben részesítjük.

decodeDataUri('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	A dekódolni kívánt adat URI-sztringje

Visszaadott érték	Típus	Leírás
<binary-for-data-uri>	Sztring	Adat URI-sztring bináris verziója

Példa

Ez a példa az adat URI bináris verzióját adja vissza:

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

És ezt az eredményt adja vissza:

decodeUriComponent

Visszaad egy sztringet, amely a feloldó karaktereket dekódolt verziókra cseréli.

decodeUriComponent('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	A kódolandó feloldó karaktereket tartalmazó sztring

Visszaadott érték	Típus	Leírás
<dekódolt-uri>	Sztring	A frissített sztring a dekódolt escape karakterekkel

Példa

Ez a példa a sztringben szereplő feloldó karaktereket dekódolt verziókra cseréli:

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

És ezt az eredményt adja vissza: "https://contoso.com"

div

Egy szám egy másik számmal való felosztásának eredményét adja eredményül.

div(<dividend>, <divisor>)

A függvény pontos visszatérési típusa a paraméterek típusától függ – lásd a részletes példákat.

Paraméter	Kötelező	Típus	Leírás
<osztalék>	Igen	Egész szám vagy lebegőpontos	Az osztó által elosztandó szám
<osztó>	Igen	Egész szám vagy lebegőpontos	Az osztalékot megosztó szám. A nulla osztóérték futásidőben hibát okoz.

Visszaadott érték	Típus	Leírás
<hányados-eredmény>	Egész szám vagy lebegőpontos	Az első szám és a második szám osztásának eredménye

1\. példa

Ezek a példák a 9-es számot 2-vel osztják el:

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

És minden visszaadja ezt az eredményt: 4.5

2\. példa

Ez a példa a 9-es számot is 2-vel osztja el, de mivel mindkét paraméter egész szám, a többit elveti (egész számosztás):

div(9, 2)

A kifejezés az eredményt 4adja vissza. A maradék értékének lekéréséhez használja a mod() függvényt.

encodeUriComponent

Egy sztring egységes erőforrás-azonosító (URI) kódolt verzióját adja vissza az URL-cím szempontjából nem biztonságos karakterek feloldó karakterekre való lecserélésével. Fontolja meg az uriComponent() használatát ahelyett, hogy encodeUriComponent(). Bár mindkét függvény ugyanúgy működik, uriComponent() előnyben részesítjük.

encodeUriComponent('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	Az URI kódolású formátumba konvertálandó sztring

Visszaadott érték	Típus	Leírás
<kódolt-uri>	Sztring	Az URI-kódolású sztring escape karakterekkel

Példa

Ez a példa egy URI-kódolású verziót hoz létre ehhez a sztringhez:

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

És ezt az eredményt adja vissza: "http%3A%2F%2Fcontoso.com"

üres

Ellenőrizze, hogy egy gyűjtemény üres-e. Igaz értéket ad vissza, ha a gyűjtemény üres, vagy hamis értéket ad vissza, ha nem üres.

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

Paraméter	Kötelező	Típus	Leírás
<gyűjtemény>	Igen	Sztring, tömb vagy objektum	Az ellenőrizni kívánt gyűjtemény

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha a gyűjtemény üres. Hamis értéket ad vissza, ha nem üres.

Példa

Ezek a példák ellenőrzik, hogy a megadott gyűjtemények üresek-e:

empty('')
empty('abc')

És a következő eredményeket adja vissza:

Első példa: Egy üres sztringet ad át, így a függvény visszaadja a függvényt true.
Második példa: Adja át az "abc" sztringet, így a függvény visszaadja false.

endsWith

Ellenőrizze, hogy egy sztring egy adott részsztringgel végződik-e. Igaz értéket ad vissza az alsztring megtalálásakor, vagy hamis értéket ad vissza, ha nem található. Ez a függvény nem megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.

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

Paraméter	Kötelező	Típus	Leírás
<text>	Igen	Sztring	Az ellenőrizni kívánt sztring
<searchText>	Igen	Sztring	A befejezési részstring a kereséshez

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha a záró részstring megtalálható. Hamis értéket ad vissza, ha nem található.

1\. példa

Ez a példa ellenőrzi, hogy a "hello world" sztring a "világ" sztringgel végződik-e:

endsWith('hello world', 'world')

És ezt az eredményt adja vissza: true

2\. példa

Ez a példa ellenőrzi, hogy a "hello world" sztring a "világegyetem" sztringgel végződik-e:

endsWith('hello world', 'universe')

És ezt az eredményt adja vissza: false

egyenlő

Ellenőrizze, hogy mindkét érték, kifejezés vagy objektum egyenértékű-e. Igaz értéket ad vissza, ha mindkettő egyenértékű, vagy hamis értéket ad vissza, ha azok nem egyenértékűek.

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

Paraméter	Kötelező	Típus	Leírás
<object1>, <object2>	Igen	Különböző	Az összehasonlítandó értékek, kifejezések vagy objektumok

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha mindkettő egyenértékű. Hamis értéket ad vissza, ha nem egyenértékű.

Példa

Ezek a példák ellenőrzik, hogy a megadott bemenetek egyenértékűek-e.

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

És a következő eredményeket adja vissza:

Első példa: Mindkét érték egyenértékű, ezért a függvény visszaadja a függvényt true.
Második példa: Mindkét érték nem egyezik meg, ezért a függvény visszaadja a függvényt false.

első

Sztringből vagy tömbből az első elemet adja vissza.

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

Paraméter	Kötelező	Típus	Leírás
<gyűjtemény>	Igen	Sztring vagy tömb	Az a gyűjtemény, ahol az első elem megtalálható

Visszaadott érték	Típus	Leírás
<első gyűjteményelem>	Bármely	A gyűjtemény első eleme

Példa

Az alábbi példák az alábbi gyűjtemények első elemét keresik:

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

És adja vissza az alábbi eredményeket:

Első példa: "h"
Második példa: 0

float

Lebegőpontos szám sztringverziójának konvertálása tényleges lebegőpontos számmá.

float('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	A konvertálni kívánt érvényes lebegőpontos számmal rendelkező sztring

Visszaadott érték	Típus	Leírás
<lebegőpontos érték>	Lebegőpontos értékek	A megadott sztring lebegőpontos száma

Példa

Ez a példa sztringverziót hoz létre ehhez a lebegőpontos számhoz:

float('10.333')

És ezt az eredményt adja vissza: 10.333

formatDateTime

Időbélyeget ad vissza a megadott formátumban.

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

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<újraformált időbélyeg>	Sztring	A megadott formátumban frissített időbélyeg

Példa

Ez a példa egy időbélyeget a megadott formátumra konvertál:

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

És ezt az eredményt adja vissza: "2018-03-15T12:00:00"

getFutureTime

Adja vissza az aktuális időbélyeget és a megadott időegységeket.

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

Paraméter	Kötelező	Típus	Leírás
<interval>	Igen	Egész	A hozzáadni kívánt időegységek száma
<timeUnit>	Igen	Sztring	Az intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<frissített időbélyeg>	Sztring	Az aktuális időbélyeg és a megadott számú időegység

1\. példa

Tegyük fel, hogy az aktuális időbélyeg "2018-03-01T00:00:00.0000000Z". Ez a példa öt napot ad hozzá az időbélyeghez:

getFutureTime(5, 'Day')

És ezt az eredményt adja vissza: "2018-03-06T00:00:00.0000000Z"

2\. példa

Tegyük fel, hogy az aktuális időbélyeg "2018-03-01T00:00:00.0000000Z". Ez a példa öt napot ad hozzá, és az eredményt "D" formátumba alakítja:

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

És ezt az eredményt adja vissza: "Tuesday, March 6, 2018"

getPastTime

Az aktuális időbélyeget adja vissza a megadott időegységekkel együtt.

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

Paraméter	Kötelező	Típus	Leírás
<interval>	Igen	Egész	A kivonáshoz megadott időegységek száma
<timeUnit>	Igen	Sztring	Az intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<frissített időbélyeg>	Sztring	Az aktuális időbélyeg mínusz a megadott számú időegység

1\. példa

Tegyük fel, hogy az aktuális időbélyeg "2018-02-01T00:00:00.0000000Z". Ez a példa öt napot von ki az időbélyegből:

getPastTime(5, 'Day')

És ezt az eredményt adja vissza: "2018-01-27T00:00:00.0000000Z"

2\. példa

Tegyük fel, hogy az aktuális időbélyeg "2018-02-01T00:00:00.0000000Z". Ez a példa kivon öt napot, és az eredményt "D" formátumba konvertálja:

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

És ezt az eredményt adja vissza: "Saturday, January 27, 2018"

Nagyobb

Ellenőrizze, hogy az első érték nagyobb-e a másodiknál. Igaz értéket ad vissza, ha az első érték nagyobb, vagy hamis értéket ad vissza, ha kisebb.

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

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Egész szám, lebegőpontos vagy sztring	Az első érték, amely ellenőrzi, hogy nagyobb-e a második értéknél
<compareTo>	Igen	Egész szám, lebegőpontos vagy sztring	Az összehasonlító érték

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha az első érték nagyobb, mint a második érték. Hamis értéket ad vissza, ha az első érték egyenlő vagy kisebb, mint a második érték.

Példa

Ezek a példák ellenőrzik, hogy az első érték nagyobb-e, mint a második érték:

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

És adja vissza az alábbi eredményeket:

Első példa: true
Második példa: false

greaterOrEquals

Ellenőrizze, hogy az első érték nagyobb-e, mint a második érték. Igaz értéket ad vissza, ha az első érték nagyobb vagy egyenlő, vagy hamis értéket ad vissza, ha az első érték kisebb.

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

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Egész szám, lebegőpontos vagy sztring	Az első érték, amely ellenőrzi, hogy nagyobb vagy egyenlő-e a második értéknél
<compareTo>	Igen	Egész szám, lebegőpontos vagy sztring	Az összehasonlító érték

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha az első érték nagyobb vagy egyenlő a második értéknél. Hamis értéket ad vissza, ha az első érték kisebb, mint a második érték.

Példa

Ezek a példák ellenőrzik, hogy az első érték nagyobb vagy egyenlő-e, mint a második érték:

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

És adja vissza az alábbi eredményeket:

Első példa: true
Második példa: false

guid

Hozzon létre egy globálisan egyedi azonosítót (GUID) sztringként, például "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Emellett az alapértelmezett formátumtól (D) eltérő formátumot is megadhat a GUID számára, amely kötőjelekkel elválasztott 32 számjegyből áll.

guid('<format>')

Paraméter	Kötelező	Típus	Leírás
<format>	Nem	Sztring	A visszaadott GUID egyetlen formátumkijelölője . Alapértelmezés szerint a formátum "D", de használhatja az "N", a "D", a "B", a "P" vagy az "X" formátumot.

Visszaadott érték	Típus	Leírás
<GUID-érték>	Sztring	Véletlenszerűen létrehozott GUID

Példa

Ez a példa ugyanazt a GUID-t hozza létre, de 32 számjegyet, kötőjelekkel elválasztva, zárójelben:

guid('P')

És ezt az eredményt adja vissza: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

ha

Ellenőrizze, hogy egy kifejezés igaz vagy hamis-e. Az eredmény alapján adjon vissza egy megadott értéket.

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

Paraméter	Kötelező	Típus	Leírás
<kifejezés>	Igen	Logikai	Az ellenőrizni kívánt kifejezés
<valueIfTrue>	Igen	Bármely	A kifejezés igaz értékének visszaadása
<valueIfFalse>	Igen	Bármely	A visszaadandó érték, ha a kifejezés hamis

Visszaadott érték	Típus	Leírás
<megadott visszatérési érték>	Bármely	A megadott érték, amely attól függően ad vissza, hogy a kifejezés igaz vagy hamis

Példa

Ez a példa azért ad "yes" vissza, mert a megadott kifejezés igaz értéket ad vissza. Ellenkező esetben a példa a következőt adja "no"vissza:

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

indexOf

Egy részszűkítés kezdő pozícióját vagy indexértékét adja vissza. Ez a függvény nem megkülönbözteti a kis- és nagybetűt, és az indexek a 0 számmal kezdődnek.

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

Paraméter	Kötelező	Típus	Leírás
<text>	Igen	Sztring	Az a sztring, amely a keresendő részsztringgel rendelkezik
<searchText>	Igen	Sztring	A keresendő alsztring

Visszaadott érték	Típus	Leírás
<index-érték>	Egész	A megadott részsztring kezdőpozíciója vagy indexértéke. Ha a sztring nem található, adja vissza a -1 számot.

Példa

Ez a példa a "hello world" sztringben megkeresi a "világ" részsztring kezdő indexértékét:

indexOf('hello world', 'world')

És ezt az eredményt adja vissza: 6

egész

Egy sztring egész verziójának visszaadása.

int('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	Az átalakítandó sztring

Visszaadott érték	Típus	Leírás
<egész szám eredménye>	Egész	A megadott sztring egész verziója

Példa

Ez a példa létrehoz egy egész verziót a "10" sztringhez:

int('10')

És ezt az eredményt adja vissza: 10

json

Adja vissza egy sztring vagy XML JavaScript Object Notation (JSON) típusértékét vagy objektumát.

json('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring vagy XML	Az átalakítandó sztring vagy XML

Visszaadott érték	Típus	Leírás
<JSON-eredmény>	JSON natív típus vagy objektum	A megadott sztring vagy XML JSON-natív típusértéke vagy objektuma. Ha a sztring null értékű, a függvény egy üres objektumot ad vissza.

1\. példa

Ez a példa jSON-értékké alakítja a sztringet:

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

És ezt az eredményt adja vissza: [1, 2, 3]

2\. példa

Ez a példa jSON-ra konvertálja ezt a sztringet:

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

És ezt az eredményt adja vissza:

{
  "fullName": "Sophia Owen"
}

3. példa

Ez a példa ezt az XML-t JSON-ra konvertálja:

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

És ezt az eredményt adja vissza:

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

útkereszteződés

Olyan gyűjteményt ad vissza, amely csak a megadott gyűjtemények közös elemeit tartalmazza. Az eredményben való megjelenéshez egy elemnek meg kell jelennie a függvénynek átadott összes gyűjteményben. Ha egy vagy több elem neve megegyezik, az eredményben az utolsó ilyen nevű elem jelenik meg.

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

Paraméter	Kötelező	Típus	Leírás
<gyűjtemény1>, <gyűjtemény2>, ...	Igen	Tömb vagy objektum, de nem mindkettő	Azok a gyűjtemények, amelyekből csak a gyakori elemeket szeretné használni

Visszaadott érték	Típus	Leírás
<gyakori elemek>	Tömb vagy objektum, illetve	Olyan gyűjtemény, amely csak a megadott gyűjtemények gyakori elemeit tartalmazza

Példa

Ez a példa az alábbi tömbök gyakori elemeit találja meg:

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

És egy olyan tömböt ad vissza, amely csak az alábbi elemeket tartalmazza:[1, 2]

Csatlakozás

Olyan sztringet ad vissza, amely egy tömb összes elemét tartalmazza, és minden karaktert elválasztó karakter választ el egymástól.

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

Paraméter	Kötelező	Típus	Leírás
<gyűjtemény>	Igen	Tömb	Az összekapcsolni kívánt elemeket tartalmazó tömb
<Határoló>	Igen	Sztring	Az eredményül kapott sztringben szereplő karakterek között megjelenő elválasztó

Visszaadott érték	Típus	Leírás
<char1><elválasztó><karakter2><elválasztó...>	Sztring	A megadott tömb összes eleméből létrehozott eredményül kapott sztring

Példa

Ez a példa egy sztringet hoz létre a tömb összes eleméből a megadott karakterrel elválasztóként:

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

És ezt az eredményt adja vissza: "a.b.c"

utolsó

Egy gyűjtemény utolsó elemének visszaadása.

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

Paraméter	Kötelező	Típus	Leírás
<gyűjtemény>	Igen	Sztring vagy tömb	Az a gyűjtemény, amelyben az utolsó elem található

Visszaadott érték	Típus	Leírás
<last-collection-item>	Sztring vagy tömb, illetve	A gyűjtemény utolsó eleme

Példa

Az alábbi példák az alábbi gyűjtemények utolsó elemét keresik:

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

És a következő eredményeket adja vissza:

Első példa: "d"
Második példa: 3

lastIndexOf

Egy részszűkítés utolsó előfordulásának kezdő pozícióját vagy indexértékét adja vissza. Ez a függvény nem megkülönbözteti a kis- és nagybetűt, és az indexek a 0 számmal kezdődnek.

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

Paraméter	Kötelező	Típus	Leírás
<text>	Igen	Sztring	Az a sztring, amely a keresendő részsztringgel rendelkezik
<searchText>	Igen	Sztring	A keresendő alsztring

Visszaadott érték	Típus	Leírás
<end-index-value>	Egész	A megadott részstring utolsó előfordulásának kezdőpozíciója vagy indexértéke. Ha a sztring nem található, adja vissza a -1 számot.

Példa

Ez a példa a "hello world" sztringben a "világ" sztring utolsó előfordulásának kezdő indexértékét keresi meg:

lastIndexOf('hello world', 'world')

És ezt az eredményt adja vissza: 6

length (hossz)

A gyűjtemény elemeinek számát adja vissza.

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

Paraméter	Kötelező	Típus	Leírás
<gyűjtemény>	Igen	Sztring vagy tömb	A megszámlálandó elemeket tartalmazó gyűjtemény

Visszaadott érték	Típus	Leírás
<hossz vagy darabszám>	Egész	A gyűjtemény elemeinek száma

Példa

Az alábbi példák megszámolják a gyűjtemények elemeinek számát:

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

És adja vissza ezt az eredményt: 4

kevesebb

Ellenőrizze, hogy az első érték kisebb-e a másodiknál. Igaz értéket ad vissza, ha az első érték kisebb, vagy hamis értéket ad vissza, ha az első érték nagyobb.

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

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Egész szám, lebegőpontos vagy sztring	Az első érték, amely ellenőrzi, hogy a második értéknél kisebb-e
<compareTo>	Igen	Egész szám, lebegőpontos vagy sztring	Az összehasonlító elem

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha az első érték kisebb, mint a második érték. Hamis értéket ad vissza, ha az első érték egyenlő vagy nagyobb, mint a második érték.

Példa

Ezek a példák ellenőrzik, hogy az első érték kisebb-e, mint a második érték.

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

És adja vissza az alábbi eredményeket:

Első példa: true
Második példa: false

lessOrEquals

Ellenőrizze, hogy az első érték kisebb-e, mint a második érték. Igaz értéket ad vissza, ha az első érték kisebb vagy egyenlő, vagy hamis értéket ad vissza, ha az első érték nagyobb.

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

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Egész szám, lebegőpontos vagy sztring	Az első érték, amely ellenőrzi, hogy a második érték kisebb vagy egyenlő-e
<compareTo>	Igen	Egész szám, lebegőpontos vagy sztring	Az összehasonlító elem

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha az első érték kisebb vagy egyenlő a második értéknél. Hamis értéket ad vissza, ha az első érték nagyobb, mint a második érték.

Példa

Ezek a példák ellenőrzik, hogy az első érték kisebb vagy egyenlő-e, mint a második érték.

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

És adja vissza az alábbi eredményeket:

Első példa: true
Második példa: false

max.

A legmagasabb értéket adja vissza egy olyan listából vagy tömbből, amely mindkét végén számokat tartalmaz.

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

Paraméter	Kötelező	Típus	Leírás
<szám1>, <szám2>, ...	Igen	Egész szám, lebegőpontos vagy mindkettő	Az a számkészlet, amelyből a legmagasabb értéket szeretné megkapni
[<szám1>, <szám2>, ...]	Igen	Tömb – Egész szám, lebegőpontos vagy mindkettő	Az a számtömb, amelyből a legmagasabb értéket szeretné megkapni

Visszaadott érték	Típus	Leírás
<maximális érték>	Egész szám vagy lebegőpontos	A megadott tömb vagy számkészlet legnagyobb értéke

Példa

Ezek a példák a számhalmazból és a tömbből kapják meg a legmagasabb értéket:

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

És adja vissza ezt az eredményt: 3

p

A legkisebb értéket adja vissza számkészletből vagy tömbből.

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

Paraméter	Kötelező	Típus	Leírás
<szám1>, <szám2>, ...	Igen	Egész szám, lebegőpontos vagy mindkettő	Az a számkészlet, amelyből a legalacsonyabb értéket szeretné megadni
[<szám1>, <szám2>, ...]	Igen	Tömb – Egész szám, lebegőpontos vagy mindkettő	Az a számtömb, amelyből a legalacsonyabb értéket szeretné megkapni

Visszaadott érték	Típus	Leírás
<minimális érték>	Egész szám vagy lebegőpontos	A megadott számkészlet vagy megadott tömb legalacsonyabb értéke

Példa

Ezek a példák a számhalmaz és a tömb legalacsonyabb értékét kapják meg:

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

És adja vissza ezt az eredményt: 1

Mod

Adja vissza a maradékot attól, hogy egy számot eloszt egy másik számmal. Az egész számok osztását lásd: div().

mod(<dividend>, <divisor>)

Paraméter	Kötelező	Típus	Leírás
<osztalék>	Igen	Egész szám vagy lebegőpontos	Az osztó által elosztandó szám
<osztó>	Igen	Egész szám vagy lebegőpontos	Az osztalékot megosztó szám. A nulla osztóérték futásidőben hibát okoz.

Visszaadott érték	Típus	Leírás
<modulo-eredmény>	Egész szám vagy lebegőpontos	Az első szám és a második szám osztásának fennmaradó része

Példa

Ez a példa kiszámítja a maradékot, ha az első szám el van osztva a második számmal:

mod(3, 2)

És ezt az eredményt adja vissza: 1

mul

Adja vissza a szorzatot két szám szorzásából.

mul(<multiplicand1>, <multiplicand2>)

Paraméter	Kötelező	Típus	Leírás
<multiplicand1>	Igen	Egész szám vagy lebegőpontos	A szorzattal szorzandó szám2
<multiplicand2>	Igen	Egész szám vagy lebegőpontos	A szorzást megszorzó szám1

Visszaadott érték	Típus	Leírás
<termék eredménye>	Egész szám vagy lebegőpontos	Az első szám és a második szám szorzásából származó szorzat

Példa

Az alábbi példák megszorozzák az első számot a második számmal:

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

És adja vissza az alábbi eredményeket:

Első példa: 2
Második példa 3

nem

Ellenőrizze, hogy egy kifejezés hamis-e. Igaz értéket ad vissza, ha a kifejezés hamis, vagy igaz értéket ad vissza.

not(<expression>)

Paraméter	Kötelező	Típus	Leírás
<kifejezés>	Igen	Logikai	Az ellenőrizni kívánt kifejezés

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha a kifejezés hamis. Hamis értéket ad vissza, ha a kifejezés igaz.

1\. példa

Ezek a példák ellenőrzik, hogy a megadott kifejezések hamisak-e:

not(false)
not(true)

És adja vissza az alábbi eredményeket:

Első példa: A kifejezés hamis, ezért a függvény visszaadja a függvényt true.
Második példa: A kifejezés igaz, ezért a függvény visszaadja a függvényt false.

2\. példa

Ezek a példák ellenőrzik, hogy a megadott kifejezések hamisak-e:

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

És adja vissza az alábbi eredményeket:

Első példa: A kifejezés hamis, ezért a függvény visszaadja a függvényt true.
Második példa: A kifejezés igaz, ezért a függvény visszaadja a függvényt false.

vagy

Ellenőrizze, hogy legalább egy kifejezés igaz-e. Igaz értéket ad vissza, ha legalább egy kifejezés igaz, vagy hamis értéket ad vissza, ha mindkettő hamis.

or(<expression1>, <expression2>)

Paraméter	Kötelező	Típus	Leírás
<kifejezés1>, <kifejezés2>	Igen	Logikai	Az ellenőrizni kívánt kifejezések

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha legalább egy kifejezés igaz. Hamis értéket ad vissza, ha mindkét kifejezés hamis.

1\. példa

Ezek a példák ellenőrzik, hogy legalább egy kifejezés igaz-e:

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

És adja vissza az alábbi eredményeket:

Első példa: Legalább egy kifejezés igaz, ezért a függvény visszaadja a függvényt true.
Második példa: Mindkét kifejezés hamis, ezért a függvény visszaadja a függvényt false.

2\. példa

Ezek a példák ellenőrzik, hogy legalább egy kifejezés igaz-e:

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

És adja vissza az alábbi eredményeket:

Első példa: Legalább egy kifejezés igaz, ezért a függvény visszaadja a függvényt true.
Második példa: Mindkét kifejezés hamis, ezért a függvény visszaadja a függvényt false.

Rand

Véletlenszerű egész számot ad vissza egy megadott tartományból, amely csak a kezdő végén található.

rand(<minValue>, <maxValue>)

Paraméter	Kötelező	Típus	Leírás
<minValue>	Igen	Egész	A tartomány legalacsonyabb egésze
<maxValue>	Igen	Egész	A függvény által visszaadható tartomány legmagasabb egészét követő egész szám

Visszaadott érték	Típus	Leírás
<véletlenszerű eredmény>	Egész	A megadott tartományból visszaadott véletlenszerű egész szám. Vegye figyelembe, hogy minden meghívás `rand()` egyedi eredményt fog eredményezni, ami azt jelenti, hogy a kimeneti monitorozás során megfigyelt érték nem lehet ugyanaz a tényleges futási időpontban.

Példa

Ez a példa véletlenszerű egész számot kap a megadott tartományból, a maximális érték kivételével:

rand(1, 5)

A következő számok egyikét adja eredményül: 1, 2, 3vagy 4

tartomány

Adott egész számból induló egész tömböt ad vissza.

range(<startIndex>, <count>)

Paraméter	Kötelező	Típus	Leírás
<startIndex>	Igen	Egész	Egész szám, amely első elemként indítja el a tömböt
<count>	Igen	Egész	A tömb egész számainak száma

Visszaadott érték	Típus	Leírás
[<tartomány-eredmény>]	Tömb	A megadott indextől kezdődő egész számokat tartalmazó tömb

Példa

Ez a példa létrehoz egy egész számot tartalmazó tömböt, amely a megadott indexből indul ki, és a megadott számú egész számmal rendelkezik:

range(1, 4)

És ezt az eredményt adja vissza: [1, 2, 3, 4]

helyettesít

Cserélje le az alsztringet a megadott sztringre, és adja vissza az eredménysztringet. Ez a függvény megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.

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

Paraméter	Kötelező	Típus	Leírás
<text>	Igen	Sztring	Az a sztring, amely a lecserélendő részsztringgel rendelkezik
<oldText>	Igen	Sztring	A lecserélendő részszúrás
<newText>	Igen	Sztring	A helyettesítő sztring

Visszaadott érték	Típus	Leírás
<frissített szöveg>	Sztring	Az alsztring cseréje után frissített sztring Ha az alsztring nem található, adja vissza az eredeti sztringet.

Példa

Ez a példa megkeresi a "régi" részsztringet a "régi sztringben" és a "régi" helyett az "új" szöveget:

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

És ezt az eredményt adja vissza: "the new string"

Kihagyás

Távolítsa el az elemeket a gyűjtemény elejéről, és adja vissza az összes többi elemet.

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

Paraméter	Kötelező	Típus	Leírás
<gyűjtemény>	Igen	Tömb	Az a gyűjtemény, amelynek elemeit el szeretné távolítani
<count>	Igen	Egész	Pozitív egész szám az elöl eltávolítandó elemek számához

Visszaadott érték	Típus	Leírás
[<frissített gyűjtemény>]	Tömb	A megadott elemek eltávolítása után frissített gyűjtemény

Példa

Ez a példa eltávolít egy elemet, a szám 0-t a megadott tömb elejéről:

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

És visszaadja ezt a tömböt a fennmaradó elemekkel: [1,2,3]

hasít

Sztring felosztása egy adott elválasztó minden előfordulására, és az eredményül kapott részsztringeket egy tömb elemeiként adja vissza. Az elválasztó jellemzően egyetlen karakter, de a többkarakteres elválasztójelek támogatottak.

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

Paraméter	Kötelező	Típus	Leírás
<text>	Igen	Sztring	Az alsztringekre elválasztandó sztring
<Határoló>	Igen	Sztring	A határolóként használni kívánt sztring

Visszaadott érték	Típus	Leírás
[<substring1,substring2><>,...]	Tömb	Az eredeti sztring részsztringeit tartalmazó tömb

Példa

Ez a példa egy tömböt ad vissza, amely a "a_b_c" sztring részsztringeit tartalmazza a "_" elválasztó alapján:

split('a_b_c', '_')

A visszaadott tömb a következő: ["a","b","c"]

startOfDay

Az időbélyeg napjának kezdetét adja vissza.

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

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<frissített időbélyeg>	Sztring	A megadott időbélyeg, de a napi nulla órajeltől kezdve

Példa

Ez a példa az időbélyeg napjának kezdetét találja:

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

És ezt az eredményt adja vissza: "2018-03-15T00:00:00.0000000Z"

startOfHour

Az óra kezdetét adja vissza egy időbélyeghez.

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

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<frissített időbélyeg>	Sztring	A megadott időbélyeg, de az óra nulla percjelétől kezdve

Példa

Ez a példa az óra kezdetét találja az időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Adja vissza a hónap kezdetét egy időbélyeghez.

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

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<frissített időbélyeg>	Sztring	A megadott időbélyeg, de a hónap első napján kezdődik a nullaórás jelöléssel

Példa

Ez a példa a hónap kezdetét adja vissza ehhez az időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-03-01T00:00:00.0000000Z"

startsWith

Ellenőrizze, hogy egy sztring egy adott részsztringgel kezdődik-e. Igaz értéket ad vissza az alsztring megtalálásakor, vagy hamis értéket ad vissza, ha nem található. Ez a függvény nem megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.

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

Paraméter	Kötelező	Típus	Leírás
<text>	Igen	Sztring	Az ellenőrizni kívánt sztring
<searchText>	Igen	Sztring	A keresendő kezdő sztring

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha a kezdő részstring megtalálható. Hamis értéket ad vissza, ha nem található.

1\. példa

Ez a példa ellenőrzi, hogy a "hello world" sztring a "hello" sztringgel kezdődik-e:

startsWith('hello world', 'hello')

És ezt az eredményt adja vissza: true

2\. példa

Ez a példa ellenőrzi, hogy a "hello world" sztring az "üdvözlés" részsztringgel kezdődik-e:

startsWith('hello world', 'greetings')

És ezt az eredményt adja vissza: false

húr

Egy érték sztringverziójának visszaadása.

string(<value>)

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Bármely	Az átalakítandó érték

Visszaadott érték	Típus	Leírás
<sztring-érték>	Sztring	A megadott érték sztringverziója

1\. példa

Ez a példa a sztringverziót hozza létre ehhez a számhoz:

string(10)

És ezt az eredményt adja vissza: "10"

2\. példa

Ez a példa létrehoz egy sztringet a megadott JSON-objektumhoz, és a fordított perjel (\) karaktert használja a kettős idézőjel (").

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

És ezt az eredményt adja vissza: "{ \\"name\\": \\"Sophie Owen\\" }"

al

Egy szám kivonásának eredményét adja vissza egy másik számból.

sub(<minuend>, <subtrahend>)

Paraméter	Kötelező	Típus	Leírás
<kisebbítendő>	Igen	Egész szám vagy lebegőpontos	Az a szám, amelyből kivonja a részösszeget
<kivonandó>	Igen	Egész szám vagy lebegőpontos	A minuendből kivonandó szám

Visszaadott érték	Típus	Leírás
<eredmény>	Egész szám vagy lebegőpontos	A második szám kivonásának eredménye az első számból

Példa

Ez a példa kivonja a második számot az első számból:

sub(10.3, .3)

És ezt az eredményt adja vissza: 10

Substring

A megadott pozícióból vagy indexből származó karaktereket ad vissza egy sztringből. Az indexértékek a 0 számmal kezdődnek.

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

Paraméter	Kötelező	Típus	Leírás
<text>	Igen	Sztring	Az a sztring, amelynek a karaktereit meg szeretné adni
<startIndex>	Igen	Egész	0-nál egyenlő vagy annál nagyobb pozitív szám, amelyet kiindulási pozícióként vagy indexértékként szeretne használni
<length> (hossz)	Igen	Egész	Az alsztringben használni kívánt karakterek pozitív száma

Visszaadott érték	Típus	Leírás
<részszűrési eredmény>	Sztring	A megadott számú karakterből álló részsztring, amely a forrássztring megadott indexpozíciójával kezdődik

Példa

Ez a példa a megadott sztringből létrehoz egy ötkarakteres részszúrást a 6-os indexértéktől kezdve:

substring('hello world', 6, 5)

És ezt az eredményt adja vissza: "world"

subtractFromTime

Vonjon ki több időegységet egy időbélyegből. Lásd még : getPastTime.

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

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<interval>	Igen	Egész	A kivonáshoz megadott időegységek száma
<timeUnit>	Igen	Sztring	Az intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<frissített időbélyeg>	Sztring	Az időbélyeg mínusz a megadott számú időegység

1\. példa

Ez a példa egy napot von ki ebből az időbélyegből:

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

És ezt az eredményt adja vissza: "2018-01-01T00:00:00:0000000Z"

2\. példa

Ez a példa egy napot von ki ebből az időbélyegből:

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

Ezt az eredményt az opcionális "D" formátummal adja vissza: "Monday, January, 1, 2018"

Elvétel

Elemeket ad vissza a gyűjtemény elejéről.

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

Paraméter	Kötelező	Típus	Leírás
<gyűjtemény>	Igen	Sztring vagy tömb	A gyűjtemény, amelynek elemeit szeretné
<count>	Igen	Egész	Pozitív egész szám az elölről kívánt elemek számához

Visszaadott érték	Típus	Leírás
<alkészlet vagy [<részhalmaz>]>	Sztring vagy tömb, illetve	Olyan sztring vagy tömb, amely az eredeti gyűjtemény elejéről vett elemek megadott számát tartalmazza

Példa

Ezek a példák a megadott számú elemet kapják meg a gyűjtemények elejéről:

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

És adja vissza az alábbi eredményeket:

Első példa: "abc"
Második példa: [0, 1, 2]

Kullancsok

ticks Adott időbélyeg tulajdonságértékének visszaadása. A kullancs egy 100 nanoszekundumos intervallum.

ticks('<timestamp>')

Paraméter	Kötelező	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeg sztringje

Visszaadott érték	Típus	Leírás
<ticks-number>	Egész	A Gergely-naptárban 0001. január 1-jei éjfél óta eltelt kullancsok száma a bemeneti időbélyeg óta

toLower

Kisbetűs karakterláncot ad vissza. Ha a sztring egyik karakterének nincs kisbetűs verziója, az a visszaadott sztringben változatlan marad.

toLower('<text>')

Paraméter	Kötelező	Típus	Leírás
<text>	Igen	Sztring	A kisbetűs formátumban visszaadandó sztring

Visszaadott érték	Típus	Leírás
<kisbetűs szöveg>	Sztring	Az eredeti sztring kisbetűs formátumban

Példa

Ez a példa kisbetűssé alakítja a sztringet:

toLower('Hello World')

És ezt az eredményt adja vissza: "hello world"

toUpper

Karakterláncot ad vissza nagybetűs formátumban. Ha a sztring egyik karakterének nincs nagybetűs verziója, az a visszaadott sztringben változatlan marad.

toUpper('<text>')

Paraméter	Kötelező	Típus	Leírás
<text>	Igen	Sztring	A nagybetűs formátumban visszaadandó sztring

Visszaadott érték	Típus	Leírás
<nagybetűs szöveg>	Sztring	Az eredeti sztring nagybetűs formátumban

Példa

Ez a példa a sztringet nagybetűssé alakítja:

toUpper('Hello World')

És ezt az eredményt adja vissza: "HELLO WORLD"

nyír

Távolítsa el a kezdő és záró szóközt egy sztringből, és adja vissza a frissített sztringet.

trim('<text>')

Paraméter	Kötelező	Típus	Leírás
<text>	Igen	Sztring	Az a sztring, amely az eltávolítandó kezdő és záró szóközt tartalmazza

Visszaadott érték	Típus	Leírás
<frissített szöveg>	Sztring	Az eredeti sztring frissített verziója kezdő vagy záró szóköz nélkül

Példa

Ez a példa eltávolítja a kezdő és záró szóközt a "„Helló világ!” alkalmazás": sztringből:

trim(' Hello World  ')

És ezt az eredményt adja vissza: "Hello World"

unió

Olyan gyűjteményt ad vissza, amely a megadott gyűjtemények összes elemét tartalmazza. Az eredményben való megjelenéshez egy elem jelenhet meg a függvénynek átadott gyűjteményekben. Ha egy vagy több elem neve megegyezik, az eredményben az utolsó ilyen nevű elem jelenik meg.

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

Paraméter	Kötelező	Típus	Leírás
<gyűjtemény1>, <gyűjtemény2>, ...	Igen	Tömb vagy objektum, de nem mindkettő	Azok a gyűjtemények, amelyekből az összes elemet meg szeretné kapni

Visszaadott érték	Típus	Leírás
<updatedCollection>	Tömb vagy objektum, illetve	Gyűjtemény a megadott gyűjtemények összes elemével – nincs ismétlődés

Példa

Ez a példa a gyűjtemények összes elemét lekéri:

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

És ezt az eredményt adja vissza: [1, 2, 3, 10, 101]

uriComponent

Egy sztring egységes erőforrás-azonosító (URI) kódolt verzióját adja vissza az URL-cím szempontjából nem biztonságos karakterek feloldó karakterekre való lecserélésével. Használja ezt a függvényt a kódoltUriComponent() helyett. Bár mindkét függvény ugyanúgy működik, uriComponent() előnyben részesítjük.

uriComponent('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	Az URI kódolású formátumba konvertálandó sztring

Visszaadott érték	Típus	Leírás
<kódolt-uri>	Sztring	Az URI-kódolású sztring escape karakterekkel

Példa

Ez a példa egy URI-kódolású verziót hoz létre ehhez a sztringhez:

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

És ezt az eredményt adja vissza: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Adja vissza az egységes erőforrás-azonosító (URI) összetevő bináris verzióját.

uriComponentToBinary('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	A konvertálni kívánt URI-kódolt sztring

Visszaadott érték	Típus	Leírás
<binary-for-coded-uri>	Sztring	Az URI-kódolt sztring bináris verziója. A bináris tartalom base64 kódolású, és az .`$content`

Példa

Ez a példa létrehozza az URI-kódolt sztring bináris verzióját:

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

És ezt az eredményt adja vissza:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Az egységes erőforrás-azonosító (URI) kódolt sztring sztringverzióját adja vissza, amely hatékonyan dekódolja az URI-kódolt sztringet.

uriComponentToString('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	A dekódolni kívánt URI-kódolt sztring

Visszaadott érték	Típus	Leírás
<dekódolt-uri>	Sztring	Az URI kódolású sztring dekódolt verziója

Példa

Ez a példa létrehozza a dekódolt sztringverziót ehhez az URI-kódolt sztringhez:

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

És ezt az eredményt adja vissza: "https://contoso.com"

utcNow

Adja vissza az aktuális időbélyeget.

utcNow('<format>')

Másik formátumot is megadhat a <formátumparaméterrel>.

Paraméter	Kötelező	Típus	Leírás
<format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
<aktuális időbélyeg>	Sztring	Az aktuális dátum és idő

1\. példa

Tegyük fel, hogy ma 2018. április 15-én 13:00:00-kor van. Ez a példa az aktuális időbélyeget kapja:

utcNow()

És ezt az eredményt adja vissza: "2018-04-15T13:00:00.0000000Z"

2\. példa

Tegyük fel, hogy ma 2018. április 15-én 13:00:00-kor van. Ez a példa az aktuális időbélyeget a választható "D" formátummal kapja meg:

utcNow('D')

És ezt az eredményt adja vissza: "Sunday, April 15, 2018"

xml

JSON-objektumot tartalmazó sztring XML-verzióját adja vissza.

xml('<value>')

Paraméter	Kötelező	Típus	Leírás
<value>	Igen	Sztring	Az átalakítandó JSON-objektummal rendelkező sztring A JSON-objektumnak csak egy gyökértulajdonságúnak kell lennie, amely nem lehet tömb. Használja a fordított perjelet (\) a kettős idézőjel (").

Visszaadott érték	Típus	Leírás
<xml-verzió>	Objektum	A megadott sztringhez vagy JSON-objektumhoz tartozó kódolt XML

1\. példa

Ez a példa létrehozza a sztring XML-verzióját, amely egy JSON-objektumot tartalmaz:

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

Az eredmény XML-ének visszaadása:

<name>Sophia Owen</name>

2\. példa

Tegyük fel, hogy rendelkezik ezzel a JSON-objektummal:

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

Ez a példa létrehoz egy XML-fájlt egy olyan sztringhez, amely a következő JSON-objektumot tartalmazza:

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

Az eredmény XML-ének visszaadása:

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

xpath

Ellenőrizze az XML-ben az XPath (XML Path Language) kifejezésnek megfelelő csomópontokat vagy értékeket, és adja vissza az egyező csomópontokat vagy értékeket. Egy XPath-kifejezés vagy csak "XPath" segít navigálni egy XML-dokumentumstruktúra között, hogy kijelölhesse a csomópontokat vagy számítási értékeket az XML-tartalomban.

xpath('<xml>', '<xpath>')

Paraméter	Kötelező	Típus	Leírás
<xml>	Igen	Bármely	Az XPath-kifejezésértéknek megfelelő csomópontok vagy értékek keresésére szolgáló XML-sztring
<xpath>	Igen	Bármely	Az egyező XML-csomópontok vagy -értékek megkeresésére használt XPath-kifejezés

Visszaadott érték	Típus	Leírás
<xml-node>	XML	XML-csomópont, ha csak egyetlen csomópont felel meg a megadott XPath-kifejezésnek
<value>	Bármely	Xml-csomópont értéke, ha csak egyetlen érték felel meg a megadott XPath-kifejezésnek
[<xml-node1>, <xml-node2>, ...] -or- [<érték1>, <érték2>, ...]	Tömb	A megadott XPath-kifejezésnek megfelelő XML-csomópontokat vagy értékeket tartalmazó tömb

1\. példa

Az 1. példában ez a példa megkeresi a <count></count> csomópontnak megfelelő csomópontokat, és hozzáadja ezeket a csomópontértékeket a sum() függvényhez:

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

És ezt az eredményt adja vissza: 30

2\. példa

Ebben a példában mindkét kifejezés megkeresi a <location></location> csomópontnak megfelelő csomópontokat a megadott argumentumokban, amelyek névtérrel rendelkező XML-t tartalmaznak. A kifejezések a fordított perjel (\) karaktert használják a kettős idézőjel (").

1. kifejezés

xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
2. kifejezés

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

Az alábbi argumentumok:

Ez az XML,amely tartalmazza az XML-dokumentum névterét: xmlns="http://contoso.com"

<?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>

Itt vagy XPath-kifejezés:
- /*[name()=\"file\"]/*[name()=\"location\"]
- /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

Az alábbi eredménycsomópont felel meg a csomópontnak <location></location> :

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

3. példa

A 3. példában ez a példa megkeresi a csomópont értékét <location></location> :

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

És ezt az eredményt adja vissza: "Paris"

Feljegyzés

Megjegyzéseket fűzhet az adatfolyam-kifejezésekhez, a folyamatkifejezésekhez azonban nem.

A kifejezésekben használható rendszerváltozók listáját a Rendszerváltozók című témakörben találja.

Megosztás a következőn keresztül:

Kifejezések és függvények az Azure Data Factoryben és az Azure Synapse Analyticsben

Kifejezések

Példák

Összetett kifejezési példa

Dinamikus tartalomszerkesztő

Paraméterrel rendelkező adatkészlet

Folyamat paraméterrel

Speciális karakterek cseréje

Egyetlen idézőjel eleje

Oktatóanyag

Függvények

Dátumfüggvények

Sztringfüggvények

Gyűjteményfüggvények

Logikai függvények

Konverziós függvények

Matematikai függvények

Függvényreferencia

add

addDays

addHours

addMinutes

addSeconds

addToTime

és

array

base64

base64ToBinary

base64ToString

bináris

logikai

összenő

összefűzés

contains

convertFromUtc

convertTimeZone

convertToUtc

createArray

dataUri

dataUriToBinary

dataUriToString

dayOfMonth

dayOfWeek

dayOfYear

decodeBase64

decodeDataUri

decodeUriComponent

div

encodeUriComponent

üres

endsWith

egyenlő

első

float

formatDateTime

getFutureTime

getPastTime

Nagyobb

greaterOrEquals

guid

ha

indexOf

egész

json

útkereszteződés

Csatlakozás

utolsó

lastIndexOf

length (hossz)

kevesebb

lessOrEquals

max.

p

Mod

mul

nem

vagy

Rand

tartomány