A Data Factory kifejezései és függvényei a Microsoft Fabricben

Ez a cikk részletesen ismerteti a Data Factory által a Microsoft Fabricben támogatott kifejezéseket és függvényeket.

Kifejezések

A definícióban szereplő kifejezésértékek lehetnek konstansok vagy futásidőben kiértékelt kifejezések. Példa:

"value"

vagy

"@pipeline().parameters.password"

A kifejezések bárhol megjelenhetnek egy sztringértékben, és mindig egy másik sztringértéket eredményeznek. Ha egy é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.

Kifejezés értéke	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: "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 42foo:myString

Kifejezés értéke	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: 42adja 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 10-szer is @range(0,10) iterálhat a 0-val kezdődő 9-zel kezdődően.

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'))
• DateTime 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ájlba ad ki dátumot:'Test_' + toString(currentDate()) + '.csv'

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

Dinamikus tartalomszerkesztő

A dinamikus tartalomszerkesztő automatikusan feloldja a tartalomban lévő karaktereket a szerkesztés befejezésekor. A tartalomszerkesztőben például az alábbi tartalom egy kifejezésfüggvény sztringinterpolációja.

"@{toUpper('myData')}"

A dinamikus tartalomszerkesztő a fenti tartalmat kifejezéssé "@{toUpper('myData')}"alakítja. Ennek a kifejezésnek az eredménye az alább bemutatott formázott sztring.

"MYDATA"

Speciális karakterek cseréje

A dinamikus tartalomszerkesztő automatikusan kikerüli 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 tartalmat kódnézetben szerkesztheti, hogy eltávolítsa 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:

1. URL-kódolás az eredeti sztringértékhez
2. 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).
3. 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 kifejezésfüggvények sztringértékparaméterekhez egyetlen idézőjelet használnak. A sztringfüggvények ' karakterei elől két idézőjelet használhat. A kifejezés @concat('Baba', '''s ', 'book store') például az eredmény alatt jelenik meg.

Baba's book store

Folyamat hatókörének változói

Ezek a rendszerváltozók a folyamat bármely pontján hivatkozhatók.

Változó neve	Leírás
@pipeline().DataFactory	Annak az adatnak vagy Synapse-munkaterületnek a neve, amelyben a folyamat fut
@pipeline().Pipeline	A folyamat neve
@pipeline().RunId	Az adott folyamatfuttatás azonosítója
@pipeline().TriggerId	A folyamatot meghívó eseményindító azonosítója
@pipeline().TriggerName	A folyamatot meghívó eseményindító neve
@pipeline().TriggerTime	A folyamatot meghívó eseményindító futtatásának időpontja. Ez az az időpont, amikor az eseményindító ténylegesen aktiválódott a folyamatfuttatás meghívásához, és kissé eltérhet az eseményindító ütemezett időpontjától.
@pipeline().GroupId	Annak a csoportnak az azonosítója, amelyhez a folyamatfuttatás tartozik.
@pipeline()?. TriggerByPipelineName	A folyamatfuttatást kiváltó folyamat neve. Akkor alkalmazható, ha a folyamatfuttatást egy ExecutePipeline-tevékenység aktiválja. Kiértékelése null értékre, ha más körülmények között használják. Jegyezze fel a kérdőjelet a következő után: @pipeline()
@pipeline()?. TriggerByPipelineRunId	A folyamatfuttatást kiváltó folyamat futtatási azonosítója. Akkor alkalmazható, ha a folyamatfuttatást egy ExecutePipeline-tevékenység aktiválja. Kiértékelése null értékre, ha más körülmények között használják. Jegyezze fel a kérdőjelet a következő után: @pipeline()

Feljegyzés

Az eseményindítóhoz kapcsolódó dátum- és időrendszerváltozók (mind a folyamat, mind az eseményindító hatókörében) AZ UTC dátumokat ad vissza ISO 8601 formátumban, például 2017-06-01T22:20:00.4061448Z.

Funkciók

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	Feladatok
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	Feladatok
Concat	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	Olyan tömböt ad vissza, amely vesszővel elválasztott részsztringeket tartalmaz egy nagyobb sztringtől az eredeti sztring megadott elválasztó karaktere alapján.
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.
Berendezés	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	Feladatok
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.
Keresztező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.
Ugrál	Távolítsa el az elemeket a gyűjtemény elejéről, és adja vissza az összes többi elemet.
take	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	Feladatok
É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	Feladatok
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.
coalesce	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.
Úszó	Egy bemeneti érték lebegőpontos számát adja vissza.
Int	Egy sztring egész verziójának visszaadása.
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	Feladatok
Hozzáadása	Két szám hozzáadásának eredményét adja vissza.
Div	Két szám osztásából származó eredményt 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	A maradékot adja vissza két szám felosztásától.
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	A második szám kivonásának eredményét adja vissza az első 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	Szükséges	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	Szükséges	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<Nap>	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	Szükséges	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	Szükséges	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	Szükséges	Típus	Leírás
<Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó sztring
<Másodperc>	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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

coalesce

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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

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

decodeUriComponent('<value>')

Paraméter	Szükséges	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

A két szám osztásából származó egész számot adja vissza. A fennmaradó eredmény lekéréséhez lásd a mod()-t.

div(<dividend>, <divisor>)

Paraméter	Szükséges	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, de nem lehet 0

Visszaadott érték	Típus	Leírás
<hányados-eredmény>	Egész	Az egész szám eredménye, hogy az első számot a második számmal osztja el

Példa

Mindkét példa az első számot a második számmal osztja el:

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

És adja vissza ezt az eredményt: 2

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	Szükséges	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	Szükséges	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 érzékeny a kis- és nagybetűkre.

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

Paraméter	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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 érzékeny a kis- és nagybetűkre, és az indexek a 0 számmal kezdődnek.

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

Paraméter	Szükséges	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	Szükséges	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	Szükséges	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"
      } ]
   }
}

Keresztező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	Szükséges	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	Szükséges	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	Szükséges	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 érzékeny a kis- és nagybetűkre, és az indexek a 0 számmal kezdődnek.

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

Paraméter	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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

min.

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

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

Paraméter	Szükséges	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

A maradékot adja vissza két szám felosztásától. Az egész szám eredményének lekéréséhez lásd : div().

mod(<dividend>, <divisor>)

Paraméter	Szükséges	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, de nem lehet 0.

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 az első számot a második számmal osztja el:

mod(3, 2)

És adja vissza ezt az eredményt: 1

Mul

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

mul(<multiplicand1>, <multiplicand2>)

Paraméter	Szükséges	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 többszörös szorzást és 1-et tartalmazó szám

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

Ezek a példák az első számot a második számmal többszörösre iktatják:

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	Szükséges	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	Szükséges	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	Szükséges	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

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	Szükséges	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	Szükséges	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	Szükséges	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

Olyan tömböt ad vissza, amely az eredeti sztringben megadott elválasztó karakter alapján vesszővel elválasztott részsztringeket tartalmaz.

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

Paraméter	Szükséges	Típus	Leírás
<text>	Igen	Sztring	A sztring, amely az eredeti sztringben megadott elválasztó alapján elválasztható részsztringekre
<Határoló>	Igen	Sztring	Az eredeti sztring elválasztó karaktere

Visszaadott érték	Típus	Leírás
[<substring1,substring2><>,...]	Tömb	Az eredeti sztring részsztringeket tartalmazó tömbje, vesszővel elválasztva

Példa

Ez a példa egy tömböt hoz létre, amely a megadott sztringből származó részsztringeket tartalmazza a megadott karakter alapján elválasztóként:

split('a_b_c', '_')

Ezt a tömböt adja eredményül: ["a","b","c"]

startOfDay

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

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

Paraméter	Szükséges	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	Szükséges	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	Szükséges	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 érzékeny a kis- és nagybetűkre.

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

Paraméter	Szükséges	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	Szükséges	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

A második szám kivonásának eredményét adja vissza az első számból.

sub(<minuend>, <subtrahend>)

Paraméter	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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"

Berendezés

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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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	Szükséges	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\"]

A csomópontnak megfelelő <location></location> eredménycsomópont:

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

Kapcsolódó tartalom

Az általános paraméterhasználatra vonatkozó utasításokért tekintse meg a Data Factory paramétereit a Fabricben