Olvasás angol nyelven

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


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 42 foo: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()

Megjegyzé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"

Megjegyzés

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

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