esemény
Tanúsítványt szerezhet a Microsoft Fabricben – ingyenesen!
nov. 19. 23 - dec. 10. 23
A Microsoft Fabric közösségi csapata korlátozott ideig ingyenes DP-600 vizsgautalványokat kínál.
Előkészítés mostEzt a böngészőt már nem támogatjuk.
Frissítsen a Microsoft Edge-re, hogy kihasználhassa a legújabb funkciókat, a biztonsági frissítéseket és a technikai támogatást.
Ez a cikk részletesen ismerteti a Data Factory által a Microsoft Fabricben támogatott kifejezéseket és függvényeket.
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: 42 adja vissza. |
"@concat('Válasz: ', string(pipeline().parameters.myNumber))" | A sztring visszaadása Answer is: 42 |
"Válasz: @@{pipeline().parameters.myNumber}" | A sztringet Answer is: @{pipeline().parameters.myNumber} adja vissza. |
Az olyan vezérlőfolyamat-tevékenységekben, mint a ForEach-tevékenység, megadhat egy tömböt, amely át lesz iterálva a tulajdonságelemekhez, és a ForEach-tevékenység egyetlen enumerálásán keresztüli iterálására használható @item() . Ha például az elemek tömbök: [1, 2, 3], az első iterációban 1, @item() a második iterációban 2, a harmadik iterációban pedig 3 értéket ad vissza. A hasonló kifejezéssel 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.
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.
@concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
@concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
@concat('Test_', pipeline().TriggerTime)
'Test_' + toString(currentDate()) + '.csv'
A fenti esetekben négy dinamikus fájlnév jön létre Test_ kezdve.
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"
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:
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
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
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
.
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á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. |
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é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. |
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. |
Ezek a függvények a nyelv natív típusai közötti konvertálásra szolgálnak:
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. |
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. |
Ez a szakasz az összes elérhető függvényt betűrendben sorolja fel.
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
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"
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"
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"
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"
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"
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:
true
.false
.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:
true
.false
.false
.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"]
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="
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"
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"
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"
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:
true
false
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:
true
"hello"
null
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"
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:
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')
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"
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"
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"
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"]
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="
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"
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"
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
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
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
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"
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"
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"
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
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"
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:
true
.false
.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
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:
true
.false
.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:
"h"
0
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
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"
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"
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"
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:
true
false
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:
true
false
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)"
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')
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
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
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"
} ]
}
}
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]
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"
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:
"d"
3
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
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
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:
true
false
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:
true
false
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
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
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
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:
2
3
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:
true
.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:
true
.false
.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:
true
.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:
true
.false
.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
, 3
vagy 4
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]
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"
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]
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"]
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"
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"
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"
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
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\\" }"
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
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"
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"
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:
"abc"
[0, 1, 2]
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 |
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"
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"
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"
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]
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"
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"
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"
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"
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>
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
esemény
Tanúsítványt szerezhet a Microsoft Fabricben – ingyenesen!
nov. 19. 23 - dec. 10. 23
A Microsoft Fabric közösségi csapata korlátozott ideig ingyenes DP-600 vizsgautalványokat kínál.
Előkészítés mostOktatás
Modul
Introduction to expressions in Power Automate - Training
Learn how to write expressions in Power Automate.