Výrazy a funkcie pre Data Factory v službe Microsoft Fabric

Tento článok obsahuje podrobnosti o výrazoch a funkciách podporovaných službou Data Factory v službe Microsoft Fabric.

Výrazy

Hodnoty výrazov v definícii môžu byť literály alebo výrazy, ktoré sa vyhodnocujú za behu. Napríklad:

"value"

or

"@pipeline().parameters.password"

Výrazy sa môžu zobraziť kdekoľvek v reťazcovej hodnote a výsledkom je vždy iná reťazcová hodnota. Ak je hodnota výrazom, telo výrazu sa extrahuje odstránením znaku zavináča (@). Ak je potrebný reťazec literálu, ktorý sa začína znakom @, musí sa uvoziť pomocou @@. Nasledujúce príklady ukazujú, ako sa vyhodnocujú výrazy.

Hodnota výrazu	Result
"parametre"	Vrátia sa znaky "parametre".
"parametre[1]"	Vrátia sa znaky "parametre[1]".
"@@"	Vráti sa reťazec s 1 znakom, ktorý obsahuje znak @.
" @"	Vráti sa 2-znakový reťazec, ktorý obsahuje znak "@".

Výrazy sa môžu zobraziť aj vo vnútri reťazcov pomocou funkcie nazývanej interpolácia reťazcov , kde sú výrazy zabalené do @{ ... }. Príklad: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Pri použití interpolácie reťazcov je výsledkom vždy reťazec. Povedzme, že som definoval myNumber ako 42 a myString ako foo:

Hodnota výrazu	Result
"@pipeline().parameters.myString"	Vráti foo sa ako reťazec.
"@{pipeline().parameters.myString}"	Vráti foo sa ako reťazec.
"@pipeline().parameters.myNumber"	Vráti 42 sa ako číslo.
"@{pipeline().parameters.myNumber}"	Vráti 42 sa ako reťazec.
"Odpoveď je: @{pipeline().parameters.myNumber}"	Vráti reťazec Answer is: 42.
"@concat('Odpoveď je: ', reťazec(pipeline().parameters.myNumber))"	Vráti reťazec. Answer is: 42
"Odpoveď je: @@{pipeline().parameters.myNumber}"	Vráti reťazec Answer is: @{pipeline().parameters.myNumber}.

V aktivitách toku ovládania, ako je aktivita ForEach, môžete poskytnúť pole, ktoré sa má iterovať pre položky vlastností a použiť @item() na iteráciu jedného výčtu v aktivite ForEach. Ak je napríklad položka pole: [1, 2, 3], @item() vráti hodnotu 1 v prvej iterácii, 2 v druhej iterácii a 3 v tretej iterácii. Môžete tiež použiť @range(0,10) výraz like na iteráciu 10-krát, začínajúc 0 končiac 9.

Môžete použiť @activity("názov aktivity") na zachytenie výstupu aktivity a prijímanie rozhodnutí. Predstavte si webovú aktivitu s názvom Web1. Pre umiestnenie výstupu prvej aktivity do tela druhej výraz vo všeobecnosti vyzerá takto: 'Web1').output alebo @activity('Web1').output.data alebo niečo podobné v závislosti od toho, @activity(ako vyzerá výstup prvej aktivity.

Examples

Príklad zložitého výrazu

Nižšie uvedený príklad ukazuje komplexný príklad, ktorý odkazuje na hlbokú podoblasť výstupu činnosti. Ak chcete odkazovať na parameter kanála, ktorý sa vyhodnotí ako podpole, použite syntax [] namiesto operátora dot(.) (ako v prípade podpoľa1 a podpoľa2) ako súčasť výstupu aktivity.

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

Dynamické vytváranie súborov a ich pomenovanie je bežným vzorom. Pozrime sa na niekoľko príkladov dynamického pomenovania súborov.

• Dátum pripojenia k názvu súboru: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
• Pripojiť dátum a čas v časovom pásme zákazníka: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
• Čas spúšťania pripojenia: @concat('Test_', pipeline().TriggerTime)
• Výstup vlastného názvu súboru v toku údajov mapovania pri výstupe do jedného súboru s dátumom: 'Test_' + toString(currentDate()) + '.csv'

Vo vyššie uvedených prípadoch sa vytvoria štyri dynamické názvy súborov počnúc Test_.

Dynamický editor obsahu

Editor dynamického obsahu po dokončení úprav automaticky unikne znakom v obsahu. Napríklad nasledujúci obsah v editore obsahu je interpolácia reťazca s funkciou výrazu.

"@{toUpper('myData')}"

Editor dynamického obsahu konvertuje vyššie uvedený obsah na výraz "@{toUpper('myData')}". Výsledkom tohto výrazu je formátovaný reťazec uvedený nižšie.

"MYDATA"

Nahradenie špeciálnych znakov

Editor dynamického obsahu automaticky unikne znakom, ako sú dvojité úvodzovky, spätná lomka v obsahu, keď dokončíte úpravy. To spôsobuje problémy, ak chcete nahradiť posuv riadka alebo tab pomocou funkcie\n, \t v replace(). Dynamický obsah môžete upraviť v zobrazení kódu a odstrániť tak nadbytočné \ vo výraze, alebo môžete podľa nasledujúcich krokov nahradiť špeciálne znaky pomocou jazyka výrazov:

1. Kódovanie URL adresy oproti pôvodnej hodnote reťazca
2. Nahraďte reťazec kódovaný v URL adrese, napríklad posuv riadka (%0A), návrat riadka (%0D), vodorovná tab(%09).
3. Dekódovanie URL

Napríklad premenná companyName so znakom nového riadka v hodnote, výraz @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) môže odstrániť znak nového riadka.

Contoso- Corporation

Escapujúci znak v úvodzovkách

Funkcie výrazov používajú pre parametre hodnoty reťazca jednu úvodzovku. Použite dve jednoduché úvodzovky na únik znaku ' v reťazcových funkciách. Napríklad výraz @concat('Baba', '''s ', 'book store') sa vráti pod výsledok.

Baba's book store

Premenné rozsahu kanála

Na tieto systémové premenné je možné odkazovať kdekoľvek v kanáli.

Názov premennej	Description
@pipeline().DataFactory	ID pracovného priestoru, v ktorom je spustený kanál spustený
@pipeline().Pipeline	ID potrubia
@pipeline().PipelineName	Názov potrubia
@pipeline().RunId	ID konkrétneho spustenia kanála
@pipeline().TriggerId	ID spúšťača, ktorý vyvolal kanál
@pipeline().TriggerName	Názov spúšťača, ktorý vyvolal kanál
@pipeline().TriggerTime	Čas spustenia spúšťača, ktoré vyvolalo kanál. Toto je čas, v ktorom sa spúšťač skutočne spustil na vyvolanie spustenia kanála, a môže sa mierne líšiť od naplánovaného času spúšťača.
@pipeline().GroupId	ID skupiny, do ktorej patrí spustenie kanála.
@pipeline()?. TriggeredByPipelineName	Názov kanála, ktorý spustí spustenie kanála. Platí vtedy, keď je spustenie kanála spustené aktivitou ExecutePipeline. Vyhodnotiť na hodnotu Null pri použití za iných okolností. Všimnite si otáznik za @pipeline()
@pipeline()?. TriggeredByPipelineRunId	ID spustenia kanála, ktorý spustí spustenie kanála. Platí vtedy, keď je spustenie kanála spustené aktivitou ExecutePipeline. Vyhodnotiť na hodnotu Null pri použití za iných okolností. Všimnite si otáznik za @pipeline()

Poznámka

Systémové premenné dátumu a času súvisiace so spúšťačom (v rozsahoch kanála aj spúšťača) vracajú dátumy UTC vo formáte ISO 8601, 2017-06-01T22:20:00.4061448Znapríklad .

Functions

Funkcie môžete volať v rámci výrazov. Nasledujúce časti poskytujú informácie o funkciách, ktoré možno použiť vo výraze.

Funkcie dátumu

Funkcia dátumu alebo času	Task
addDays	Pridajte k časovej pečiatke počet dní.
addHours	Pridajte k časovej pečiatke počet hodín.
addMinutes	Pridajte do časovej pečiatky počet minút.
addSeconds	Pridajte k časovej pečiatke počet sekúnd.
addToTime	Pridajte do časovej pečiatky počet časových jednotiek. Pozri tiež getFutureTime.
konvertovať z Utc	Prevod časovej pečiatky z koordinovaného svetového času (UTC) na cieľové časové pásmo.
convertTimeZone	Konvertujte časovú pečiatku zo zdrojového časového pásma na cieľové časové pásmo.
convertToUtc	Konvertujte časovú pečiatku zo zdrojového časového pásma na svetovú koordinovanú časovú pečiatku (UTC).
dayOfMonth	Vráťte komponent deň v mesiaci z časovej pečiatky.
dayOfWeek	Vráťte komponent deň v týždni z časovej pečiatky.
deňOfYear	Vráťte komponent deň v roku z časovej pečiatky.
formatDateTime	Vráťte časovú pečiatku ako reťazec vo voliteľnom formáte.
getFutureTime	Vráťte aktuálnu časovú pečiatku plus zadané časové jednotky. Pozri tiež addToTime.
getPastTime	Vráťte aktuálnu časovú pečiatku mínus zadané časové jednotky. Pozri tiež subtractFromTime.
začiatok dňa	Vráťte začiatok dňa pre časovú pečiatku.
začiatokHodiny	Vráťte začiatok hodiny pre časovú pečiatku.
začiatok mesiaca	Vráťte začiatok mesiaca pre časovú pečiatku.
odčítaťZČasu	Odčítajte od časovej pečiatky počet časových jednotiek. Pozri tiež getPastTime.
Kliešte	Vráťte ticks hodnotu vlastnosti pre zadanú časovú pečiatku
utcNow	Vráťte aktuálnu časovú pečiatku ako reťazec.

Reťazcové funkcie

Na prácu s reťazcami môžete použiť tieto reťazcové funkcie a tiež niektoré funkcie zberu. Reťazcové funkcie fungujú iba na reťazcoch.

Funkcia reťazca	Task
CONCAT	Skombinujte dva alebo viac reťazcov a vráťte kombinovaný reťazec.
končíS	Skontrolujte, či reťazec končí zadaným podreťazcom.
guid	Vygenerujte globálne jedinečný identifikátor (GUID) ako reťazec.
indexZ	Vráťte počiatočnú pozíciu pre podreťazec.
lastIndexOf	Vráťte počiatočnú pozíciu pre posledný výskyt podreťazca.
nahradiť	Nahraďte podreťazec zadaným reťazcom a vráťte aktualizovaný reťazec.
rozdeliť	Vráti pole, ktoré obsahuje podreťazce oddelené čiarkami, z väčšieho reťazca na základe zadaného oddeľovacieho znaku v pôvodnom reťazci.
začína s	Skontrolujte, či reťazec začína konkrétnym podreťazcom.
Podreťazec	Vracajú znaky z reťazca, začínajúc od zadanej pozície.
naNižšie	Vráťte reťazec vo formáte malých písmen.
doHorný	Vráťte reťazec vo formáte veľkých písmen.
pristrihnúť	Odstráňte úvodné a koncové medzery z reťazca a vráťte aktualizovaný reťazec.

Funkcie zberu

Ak chcete pracovať s kolekciami, zvyčajne poľami, reťazcami a niekedy aj slovníkmi, môžete použiť tieto funkcie zberu.

Funkcia zberu	Task
Obsahuje	Skontrolujte, či kolekcia obsahuje konkrétnu položku.
prázdny	Skontrolujte, či nie je kolekcia prázdna.
prvý	Vráťte prvú položku z kolekcie.
priesečník	Vráťte kolekciu, ktorá obsahuje iba spoločné položky v zadaných kolekciách.
pripojiť	Vráti reťazec, ktorý obsahuje všetky položky z poľa oddelené zadaným znakom.
minulý	Vrátenie poslednej položky z kolekcie.
dĺžka	Vráťte počet položiek v reťazci alebo poli.
preskočiť	Odstráňte položky z prednej časti kolekcie a vráťte všetky ostatné položky .
vziať	Vrátenie položiek z prednej časti kolekcie.
únia	Vráťte kolekciu, ktorá obsahuje všetky položky zo zadaných kolekcií.

Logické funkcie

Tieto funkcie sú užitočné vo vnútri podmienok, možno ich použiť na vyhodnotenie akéhokoľvek typu logiky.

Funkcia logického porovnávania	Task
a	Skontrolujte, či sú všetky výrazy pravdivé.
Rovná	Skontrolujte, či sú obe hodnoty ekvivalentné.
Väčšie	Skontrolujte, či je prvá hodnota väčšia ako druhá hodnota.
väčší alebo rovná sa	Skontrolujte, či je prvá hodnota väčšia alebo rovná druhej hodnote.
ak	Skontrolujte, či je výraz pravdivý alebo nepravdivý. Na základe výsledku vráťte zadanú hodnotu.
menej	Skontrolujte, či je prvá hodnota menšia ako druhá hodnota.
lessOrEquals	Skontrolujte, či je prvá hodnota menšia alebo rovná druhej hodnote.
nie	Skontrolujte, či je výraz nepravdivý.
alebo	Skontrolujte, či je aspoň jeden výraz pravdivý.

Konverzné funkcie

Tieto funkcie sa používajú na konverziu medzi jednotlivými natívnymi typmi v jazyku:

• reťazec
• typ Integer
• s pohyblivou desatinnou čiarkou
• boolean
• Polia
• Slovníky

Funkcia konverzie	Task
pole	Vráti pole z jedného zadaného vstupu. Viaceré vstupy nájdete v téme createArray.
Základňa64	Vráťte verziu s kódovaním base64 pre reťazec.
base64ToBinary	Vráťte binárnu verziu pre reťazec s kódovaním base64.
base64ToString	Vráťte verziu reťazca pre reťazec s kódovaním base64.
binárny	Vráťte binárnu verziu pre vstupnú hodnotu.
Bool	Vráťte booleovskú verziu pre vstupnú hodnotu.
Splynúť	Vráťte prvú hodnotu, ktorá nie je nulová z jedného alebo viacerých parametrov.
createArray	Vráťte pole z viacerých vstupov.
dataUri	Vráťte identifikátor URI údajov pre vstupnú hodnotu.
dataUriToBinary	Vráťte binárnu verziu pre identifikátor URI údajov.
dataUriToString	Vráťte verziu reťazca pre identifikátor URI údajov.
decodeBase64	Vráťte verziu reťazca pre reťazec s kódovaním base64.
decodeDataUri	Vráťte binárnu verziu pre identifikátor URI údajov.
decodeUriComponent	Vráti reťazec, ktorý nahradí znaky escape dekódovanými verziami.
encodeUriComponent	Vráti reťazec, ktorý nahradí znaky, ktoré nie sú bezpečné pre URL adresu, únikovými znakmi.
plávať	Vráťte číslo s pohyblivou desatinnou čiarkou pre vstupnú hodnotu.
Int	Vráťte celočíselnú verziu reťazca.
povrázok	Vráťte verziu reťazca pre vstupnú hodnotu.
uriKomponent	Vráťte verziu zakódovanú identifikátorom URI pre vstupnú hodnotu nahradením znakov nebezpečných pre adresu URL príkazovými znakmi.
uriComponentToBinary	Vráťte binárnu verziu pre reťazec kódovaný URI.
uriComponentToString	Vráťte verziu reťazca pre reťazec s kódovaním URI.
XML	Vráťte verziu XML pre reťazec.
xpath	Skontrolujte, či sa v jazyku XML nachádzajú uzly alebo hodnoty, ktoré sa zhodujú s výrazom XPath (XML Path Language), a vráťte zodpovedajúce uzly alebo hodnoty.

Matematické funkcie

Tieto funkcie možno použiť pre oba typy čísel: celé čísla a floaty.

Matematická funkcia	Task
sčítať	Vráťte výsledok sčítaním dvoch čísel.
Div	Vráťte výsledok z delenia dvoch čísel.
Max	Vráťte najvyššiu hodnotu z množiny čísel alebo poľa.
Min	Vráťte najnižšiu hodnotu z množiny čísel alebo poľa.
Mod	Vráťte zvyšok z delenia dvoch čísel.
mul	Vráťte produkt z násobenia dvoch čísel.
Rand	Vráťte náhodné celé číslo zo zadaného rozsahu.
rozsah	Vráti celočíselné pole, ktoré začína zadaným celým číslom.
Sub	Vráťte výsledok odčítaním druhého čísla od prvého čísla.

Referenčné informácie o funkcii

V tejto časti sú uvedené všetky dostupné funkcie v abecednom poradí.

sčítať

Vráťte výsledok sčítaním dvoch čísel.

add(<summand_1>, <summand_2>)

Parameter	Required	Typ	Description
< >summand_1 summand_2<>	Yes	Celočíselné, pohyblivé alebo zmiešané	Čísla, ktoré treba sčítať

Vrátená hodnota	Typ	Description
< výsledok-súčet>	Celé číslo alebo float	Výsledok sčítania zadaných čísel

Príklad

V tomto príklade sa sčítajú zadané čísla:

add(1, 1.5)

A vráti tento výsledok: 2.5

addDays

Pridajte k časovej pečiatke počet dní.

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< dni>	Yes	Celé číslo	Kladný alebo záporný počet dní, ktoré sa majú pridať
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< aktualizovaná časová pečiatka>	Povrázok	Časová pečiatka plus zadaný počet dní

Príklad 1

Tento príklad pridá 10 dní k zadanej časovej pečiatke:

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

A vráti tento výsledok: "2018-03-25T00:00:0000000Z"

Príklad 2

V tomto príklade sa od zadanej časovej pečiatky odpočíta päť dní:

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

A vráti tento výsledok: "2018-03-10T00:00:0000000Z"

addHours

Pridajte k časovej pečiatke počet hodín.

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< hodiny>	Yes	Celé číslo	Kladný alebo záporný počet hodín, ktoré sa majú pridať
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< aktualizovaná časová pečiatka>	Povrázok	Časová pečiatka plus zadaný počet hodín

Príklad 1

Tento príklad pridá 10 hodín k zadanej časovej pečiatke:

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

A vráti tento výsledok: "2018-03-15T10:00:0000000Z"

Príklad 2

V tomto príklade sa od zadanej časovej pečiatky odpočíta päť hodín:

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

A vráti tento výsledok: "2018-03-15T10:00:0000000Z"

addMinutes

Pridajte do časovej pečiatky počet minút.

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< zápis>	Yes	Celé číslo	Kladný alebo záporný počet minút, ktoré sa majú pridať
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< aktualizovaná časová pečiatka>	Povrázok	Časová pečiatka plus zadaný počet minút

Príklad 1

Tento príklad pridá 10 minút k zadanej časovej pečiatke:

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

A vráti tento výsledok: "2018-03-15T00:20:00.0000000Z"

Príklad 2

Tento príklad odpočíta päť minút od zadanej časovej pečiatky:

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

A vráti tento výsledok: "2018-03-15T00:15:00.0000000Z"

addSeconds

Pridajte k časovej pečiatke počet sekúnd.

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< Sekúnd>	Yes	Celé číslo	Kladný alebo záporný počet sekúnd na pridanie
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< aktualizovaná časová pečiatka>	Povrázok	Časová pečiatka plus zadaný počet sekúnd

Príklad 1

Tento príklad pridá 10 sekúnd k zadanej časovej pečiatke:

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

A vráti tento výsledok: "2018-03-15T00:00:10.0000000Z"

Príklad 2

Tento príklad odpočíta päť sekúnd od zadanej časovej pečiatky:

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

A vráti tento výsledok: "2018-03-15T00:00:25.0000000Z"

addToTime

Pridajte do časovej pečiatky počet časových jednotiek. Pozri tiež getFutureTime().

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< Interval>	Yes	Celé číslo	Počet zadaných časových jednotiek, ktoré sa majú pridať
< časová jednotka>	Yes	Povrázok	Jednotka času, ktorá sa má použiť s intervalom: "Sekunda", "Minúta", "Hodina", "Deň", "Týždeň", "Mesiac", "Rok"
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< aktualizovaná časová pečiatka>	Povrázok	Časová pečiatka plus zadaný počet časových jednotiek

Príklad 1

Tento príklad pridá jeden deň k zadanej časovej pečiatke:

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

A vráti tento výsledok: "2018-01-02T00:00:00.0000000Z"

Príklad 2

Tento príklad pridá jeden deň k zadanej časovej pečiatke:

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

A vráti výsledok pomocou voliteľného formátu "D": "Tuesday, January 2, 2018"

and

Skontrolujte, či sú oba výrazy pravdivé. Vráťte hodnotu true, ak sú oba výrazy pravdivé, alebo hodnotu false, ak je aspoň jeden výraz nepravdivý.

and(<expression1>, <expression2>)

Parameter	Required	Typ	Description
< výraz1>, <výraz2>	Yes	booleovský	Výrazy, ktoré sa majú skontrolovať

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Vráťte hodnotu true, keď sú oba výrazy pravdivé. Vráti hodnotu false, ak je aspoň jeden výraz false.

Príklad 1

Tieto príklady kontrolujú, či sú zadané booleovské hodnoty pravdivé:

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

A vráti tieto výsledky:

• Prvý príklad: Oba výrazy sú pravdivé, takže vráti true.
• Druhý príklad: Jeden výraz je nepravdivý, takže vráti false.
• Tretí príklad: Oba výrazy sú nepravdivé, takže vráti false.

Príklad 2

Tieto príklady kontrolujú, či sú zadané výrazy pravdivé:

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

A vráti tieto výsledky:

• Prvý príklad: Oba výrazy sú pravdivé, takže vráti true.
• Druhý príklad: Jeden výraz je nepravdivý, takže vráti false.
• Tretí príklad: Oba výrazy sú nepravdivé, takže vráti false.

pole

Vráti pole z jedného zadaného vstupu. Pre viaceré vstupy pozri createArray().

array('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec na vytvorenie poľa

Vrátená hodnota	Typ	Description
[<hodnota>]	Pole	Pole, ktoré obsahuje jeden zadaný vstup

Príklad

Tento príklad vytvorí pole z reťazca "hello":

array('hello')

A vráti tento výsledok: ["hello"]

Základňa64

Vráťte verziu s kódovaním base64 pre reťazec.

base64('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Vstupný reťazec

Vrátená hodnota	Typ	Description
< base64-struna>	Povrázok	Verzia pre vstupný reťazec s kódovaním base64

Príklad

Tento príklad konvertuje reťazec "hello" na reťazec s kódovaním base64:

base64('hello')

A vráti tento výsledok: "aGVsbG8="

base64ToBinary

Vráťte binárnu verziu pre reťazec s kódovaním base64.

base64ToBinary('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec s kódovaním base64 na konverziu

Vrátená hodnota	Typ	Description
< binárny-pre-base64-string>	Povrázok	Binárna verzia reťazca s kódovaním base64

Príklad

Tento príklad konvertuje reťazec s kódovaním "aGVsbG8=" base64 na binárny reťazec:

base64ToBinary('aGVsbG8=')

A vráti tento výsledok:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Vráťte verziu reťazca pre reťazec s kódovaním base64, čím sa reťazec base64 efektívne dekóduje. Túto funkciu použite namiesto decodeBase64(). Aj keď obe funkcie fungujú rovnako, uprednostňuje sa. base64ToString()

base64ToString('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec s kódovaním base64 na dekódovanie

Vrátená hodnota	Typ	Description
< dekódovaný-base64-reťazec>	Povrázok	Verzia reťazca pre reťazec s kódovaním base64

Príklad

Tento príklad konvertuje reťazec s kódovaním "aGVsbG8=" base64 len na reťazec:

base64ToString('aGVsbG8=')

A vráti tento výsledok: "hello"

binárny

Vráťte binárnu verziu reťazca.

binary('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec, ktorý sa má skonvertovať

Vrátená hodnota	Typ	Description
< binárne-pre-vstupnú-hodnotu>	Povrázok	Binárna verzia pre zadaný reťazec

Príklad

Tento príklad konvertuje reťazec "hello" na binárny reťazec:

binary('hello')

A vráti tento výsledok:

"0110100001100101011011000110110001101111"

Bool

Vráťte booleovskú verziu pre hodnotu.

bool(<value>)

Parameter	Required	Typ	Description
< hodnota>	Yes	Ľubovoľný	Hodnota, ktorá sa má previesť

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Booleovská verzia pre zadanú hodnotu

Príklad

Tieto príklady konvertujú zadané hodnoty na booleovské hodnoty:

bool(1)
bool(0)

A vráti tieto výsledky:

• Prvý príklad: true
• Druhý príklad: false

zjednotiť

Vráťte prvú hodnotu, ktorá nie je nulová z jedného alebo viacerých parametrov. Prázdne reťazce, prázdne polia a prázdne objekty nemajú hodnotu null.

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

Parameter	Required	Typ	Description
< >object_1, <object_2>...	Yes	Akékoľvek, môže miešať typy	Jedna alebo viac položiek na kontrolu hodnoty null

Vrátená hodnota	Typ	Description
< prvá-nenulová-položka>	Ľubovoľný	Prvá položka alebo hodnota, ktorá nemá hodnotu null. Ak sú všetky parametre null, táto funkcia vráti hodnotu null.

Príklad

Tieto príklady vrátia prvú hodnotu bez hodnoty null zo zadaných hodnôt alebo hodnotu null, ak sú všetky hodnoty null:

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

A vráti tieto výsledky:

• Prvý príklad: true
• Druhý príklad: "hello"
• Tretí príklad: null

CONCAT

Skombinujte dva alebo viac reťazcov a vráťte kombinovaný reťazec.

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

Parameter	Required	Typ	Description
< text1>, <text2>, ...	Yes	Povrázok	Kombinácia aspoň dvoch strún

Vrátená hodnota	Typ	Description
< text1text2...>	Povrázok	Reťazec vytvorený z kombinovaných vstupných reťazcov

Príklad

Tento príklad kombinuje reťazce "Hello" a "World":

concat('Hello', 'World')

A vráti tento výsledok: "HelloWorld"

Obsahuje

Skontrolujte, či kolekcia obsahuje konkrétnu položku. Vráti hodnotu true, keď sa položka nájde, alebo vráti hodnotu false, ak sa nenájde. V tejto funkcii sa rozlišujú veľké a malé písmená.

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

Táto funkcia konkrétne funguje na týchto typoch kolekcií:

• Reťazec na vyhľadanie podreťazca
• Pole na vyhľadanie hodnoty
• Slovník na vyhľadanie kľúča

Parameter	Required	Typ	Description
< zbierka>	Yes	Reťazec, pole alebo slovník	Zbierka na kontrolu
< hodnota>	Yes	Reťazec, pole alebo slovník	Položka, ktorú treba nájsť

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Vráti hodnotu true, keď sa položka nájde. Ak sa nenájde, vráti nepravdivé.

Príklad 1

Tento príklad skontroluje reťazec "hello world" pre podreťazec "world" a vráti hodnotu true:

contains('hello world', 'world')

Príklad 2

Tento príklad skontroluje reťazec "hello world" pre podreťazec "universe" a vráti hodnotu false:

contains('hello world', 'universe')

konvertovať z Utc

Prevod časovej pečiatky z koordinovaného svetového času (UTC) na cieľové časové pásmo.

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< destinationTimeZone>	Yes	Povrázok	Názov cieľového časového pásma. Názvy časových pásiem nájdete v téme Hodnoty časových pásiem spoločnosti Microsoft, ale možno budete musieť z názvu časového pásma odstrániť interpunkčné znamienka.
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< konvertovaná-časová pečiatka>	Povrázok	Časová pečiatka skonvertovaná na cieľové časové pásmo

Príklad 1

Tento príklad skonvertuje časovú pečiatku na zadané časové pásmo:

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

A vráti tento výsledok: "2018-01-01T00:00:00Z"

Príklad 2

Tento príklad skonvertuje časovú pečiatku na zadané časové pásmo a formát:

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

A vráti tento výsledok: "Monday, January 1, 2018"

convertTimeZone

Konvertujte časovú pečiatku zo zdrojového časového pásma na cieľové časové pásmo.

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< sourceTimeZone>	Yes	Povrázok	Názov zdrojového časového pásma. Názvy časových pásiem nájdete v téme Hodnoty časových pásiem spoločnosti Microsoft, ale možno budete musieť z názvu časového pásma odstrániť interpunkčné znamienka.
< destinationTimeZone>	Yes	Povrázok	Názov cieľového časového pásma. Názvy časových pásiem nájdete v téme Hodnoty časových pásiem spoločnosti Microsoft, ale možno budete musieť z názvu časového pásma odstrániť interpunkčné znamienka.
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< konvertovaná-časová pečiatka>	Povrázok	Časová pečiatka skonvertovaná na cieľové časové pásmo

Príklad 1

Tento príklad skonvertuje zdrojové časové pásmo na cieľové časové pásmo:

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

A vráti tento výsledok: "2018-01-01T00:00:00.0000000"

Príklad 2

V tomto príklade sa časové pásmo skonvertuje na zadané časové pásmo a formát:

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

A vráti tento výsledok: "Monday, January 1, 2018"

convertToUtc

Konvertujte časovú pečiatku zo zdrojového časového pásma na svetovú koordinovanú časovú pečiatku (UTC).

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< sourceTimeZone>	Yes	Povrázok	Názov zdrojového časového pásma. Názvy časových pásiem nájdete v téme Hodnoty časových pásiem spoločnosti Microsoft, ale možno budete musieť z názvu časového pásma odstrániť interpunkčné znamienka.
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< konvertovaná-časová pečiatka>	Povrázok	Časová pečiatka skonvertovaná na UTC

Príklad 1

Tento príklad konvertuje časovú pečiatku na UTC:

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

A vráti tento výsledok: "2018-01-01T08:00:00.0000000Z"

Príklad 2

Tento príklad konvertuje časovú pečiatku na UTC:

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

A vráti tento výsledok: "Monday, January 1, 2018"

createArray

Vráťte pole z viacerých vstupov. Pre polia s jedným vstupom pozri array().

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

Parameter	Required	Typ	Description
< objekt1>, <objekt2>, ...	Yes	Akékoľvek, ale nie zmiešané	Aspoň dve položky na vytvorenie poľa

Vrátená hodnota	Typ	Description
[<objekt1>, <objekt2>, ...]	Pole	Pole vytvorené zo všetkých vstupných položiek

Príklad

Tento príklad vytvorí pole z týchto vstupov:

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

A vráti tento výsledok: ["h", "e", "l", "l", "o"]

dataUri

Vráťte identifikátor URI (Data Uniform Resource Identifier) pre reťazec.

dataUri('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec, ktorý sa má skonvertovať

Vrátená hodnota	Typ	Description
< data-uri>	Povrázok	Identifikátor URI údajov pre vstupný reťazec

Príklad

Tento príklad vytvorí identifikátor URI údajov pre reťazec "hello":

dataUri('hello')

A vráti tento výsledok: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Vráťte binárnu verziu pre identifikátor URI (Data Uniform Resource Identifier). Túto funkciu použite namiesto decodeDataUri(). Aj keď obe funkcie fungujú rovnako, uprednostňuje sa. dataUriBinary()

dataUriToBinary('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Identifikátor URI údajov, ktorý sa má skonvertovať

Vrátená hodnota	Typ	Description
< binárne-pre-údaje-identifikátor URI>	Povrázok	Binárna verzia identifikátora URI údajov

Príklad

Tento príklad vytvorí binárnu verziu pre tento identifikátor URI údajov:

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

A vráti tento výsledok:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Vráťte verziu reťazca pre identifikátor URI (Data Uniform Resource Identifier).

dataUriToString('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Identifikátor URI údajov, ktorý sa má skonvertovať

Vrátená hodnota	Typ	Description
< reťazec-pre-údaje-identifikátor URI>	Povrázok	Verzia reťazca pre identifikátor URI údajov

Príklad

Tento príklad vytvorí reťazec pre tento identifikátor URI údajov:

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

A vráti tento výsledok: "hello"

dayOfMonth

Vráťte deň v mesiaci z časovej pečiatky.

dayOfMonth('<timestamp>')

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku

Vrátená hodnota	Typ	Description
< deň v mesiaci>	Celé číslo	Deň v mesiaci od zadanej časovej pečiatky

Príklad

Tento príklad vráti číslo pre deň v mesiaci z tejto časovej pečiatky:

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

A vráti tento výsledok: 15

dayOfWeek

Vráťte deň v týždni z časovej pečiatky.

dayOfWeek('<timestamp>')

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku

Vrátená hodnota	Typ	Description
< deň v týždni>	Celé číslo	Deň v týždni od zadanej časovej pečiatky, kde nedeľa je 0, pondelok je 1 atď.

Príklad

Tento príklad vráti číslo pre deň v týždni z tejto časovej pečiatky:

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

A vráti tento výsledok: 3

deňOfYear

Vráťte deň v roku z časovej pečiatky.

dayOfYear('<timestamp>')

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku

Vrátená hodnota	Typ	Description
< deň v roku>	Celé číslo	Deň v roku od zadanej časovej pečiatky

Príklad

Tento príklad vráti číslo dňa v roku z tejto časovej pečiatky:

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

A vráti tento výsledok: 74

decodeBase64

Vráťte verziu reťazca pre reťazec s kódovaním base64, čím sa reťazec base64 efektívne dekóduje. Zvážte použitie base64ToString() namiesto decodeBase64(). Aj keď obe funkcie fungujú rovnako, uprednostňuje sa. base64ToString()

decodeBase64('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec s kódovaním base64 na dekódovanie

Vrátená hodnota	Typ	Description
< dekódovaný-base64-reťazec>	Povrázok	Verzia reťazca pre reťazec s kódovaním base64

Príklad

Tento príklad vytvorí reťazec pre reťazec s kódovaním base64:

decodeBase64('aGVsbG8=')

A vráti tento výsledok: "hello"

decodeDataUri

Vráťte binárnu verziu pre identifikátor URI (Data Uniform Resource Identifier). Zvážte použitie dataUriToBinary() namiesto decodeDataUri(). Aj keď obe funkcie fungujú rovnako, uprednostňuje sa. dataUriToBinary()

decodeDataUri('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec identifikátora URI údajov na dekódovanie

Vrátená hodnota	Typ	Description
< binárne-pre-údaje-identifikátor URI>	Povrázok	Binárna verzia reťazca identifikátora URI údajov

Príklad

Tento príklad vráti binárnu verziu pre tento identifikátor URI údajov:

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

A vráti tento výsledok:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Vráti reťazec, ktorý nahradí znaky escape dekódovanými verziami.

decodeUriComponent('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec s únikovými znakmi na dekódovanie

Vrátená hodnota	Typ	Description
< decoded-uri>	Povrázok	Aktualizovaný reťazec s dekódovanými znakmi escape

Príklad

Tento príklad nahrádza znaky escape v tomto reťazci dekódovanými verziami:

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

A vráti tento výsledok: "https://contoso.com"

Div

Vráťte celočíselný výsledok delením dvoch čísel. Ak chcete získať zvyšný výsledok, pozrite si mod().

div(<dividend>, <divisor>)

Parameter	Required	Typ	Description
< dividenda>	Yes	Celé číslo alebo float	Číslo, ktoré sa má vydeliť deliteľom
< deliteľ>	Yes	Celé číslo alebo float	Číslo, ktoré delí dividendu, ale nemôže byť 0

Vrátená hodnota	Typ	Description
< Kvocient-výsledok>	Celé číslo	Celé číslo je výsledkom vydelenia prvého čísla druhým číslom

Príklad

Oba príklady delia prvé číslo druhým číslom:

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

A vráťte tento výsledok: 2

encodeUriComponent

Vráťte verziu kódovanú v URI (Uniform Resource Identifier) pre reťazec nahradením znakov nebezpečných pre URL adresu únikovými znakmi. Zvážte použitie uriComponent() namiesto encodeUriComponent(). Aj keď obe funkcie fungujú rovnako, uprednostňuje sa. uriComponent()

encodeUriComponent('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec, ktorý sa má skonvertovať do formátu kódovaného URI

Vrátená hodnota	Typ	Description
< encoded-uri>	Povrázok	Reťazec kódovaný v URI s únikovými znakmi

Príklad

Tento príklad vytvorí verziu kódovanú URI pre tento reťazec:

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

A vráti tento výsledok: "http%3A%2F%2Fcontoso.com"

prázdny

Skontrolujte, či nie je kolekcia prázdna. Vráťte hodnotu true, keď je kolekcia prázdna, alebo vrátiť hodnotu false, ak nie je prázdna.

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

Parameter	Required	Typ	Description
< zbierka>	Yes	Reťazec, pole alebo objekt	Zbierka na kontrolu

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Vráti hodnotu true, keď je kolekcia prázdna. Ak nie je prázdny, vráti hodnotu false.

Príklad

Tieto príklady kontrolujú, či sú zadané kolekcie prázdne:

empty('')
empty('abc')

A vráti tieto výsledky:

• Prvý príklad: Odovzdá prázdny reťazec, takže funkcia vráti true.
• Druhý príklad: Odovzdá reťazec "abc", takže funkcia vráti false.

končíS

Skontrolujte, či reťazec končí konkrétnym podreťazcom. Vráti hodnotu true, keď sa nájde podreťazec, alebo vráti hodnotu false, ak sa nenájde. V tejto funkcii sa nerozlišujú veľké a malé písmená.

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

Parameter	Required	Typ	Description
< Text>	Yes	Povrázok	Reťazec, ktorý sa má skontrolovať
< vyhľadávanieText>	Yes	Povrázok	Koncový podreťazec, ktorý sa má nájsť

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Vráti hodnotu true, keď sa nájde koncový podreťazec. Ak sa nenájde, vráti nepravdivé.

Príklad 1

Tento príklad kontroluje, či reťazec "hello world" končí reťazcom "world":

endsWith('hello world', 'world')

A vráti tento výsledok: true

Príklad 2

Tento príklad kontroluje, či reťazec "hello world" končí reťazcom "universe":

endsWith('hello world', 'universe')

A vráti tento výsledok: false

Rovná

Skontrolujte, či sú hodnoty, výrazy alebo objekty ekvivalentné. Vráťte hodnotu true, ak sú obe ekvivalentné, alebo hodnotu false, ak nie sú ekvivalentné.

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

Parameter	Required	Typ	Description
< objekt1>, <objekt2>	Yes	Rôznorodý	Hodnoty, výrazy alebo objekty na porovnanie

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Vráťte hodnotu true, keď sú obe ekvivalentné. Vráťte hodnotu false, ak nie je ekvivalentná.

Príklad

Tieto príklady kontrolujú, či sú zadané vstupy ekvivalentné.

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

A vráti tieto výsledky:

• Prvý príklad: Obe hodnoty sú ekvivalentné, takže funkcia vráti true.
• Druhý príklad: Obe hodnoty nie sú ekvivalentné, takže funkcia vráti false.

prvý

Vráťte prvú položku z reťazca alebo poľa.

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

Parameter	Required	Typ	Description
< zbierka>	Yes	Reťazec alebo pole	Kolekcia, kde nájdete prvú položku

Vrátená hodnota	Typ	Description
< prvá-zbierka-položka>	Ľubovoľný	Prvá položka v kolekcii

Príklad

Tieto príklady nachádzajú prvú položku v týchto zbierkach:

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

A vráťte tieto výsledky:

• Prvý príklad: "h"
• Druhý príklad: 0

s pohyblivou desatinnou čiarkou

Konvertujte reťazcovú verziu pre číslo s pohyblivou desatinnou čiarkou na skutočné číslo s pohyblivou desatinnou čiarkou.

float('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec, ktorý má platné číslo s pohyblivou desatinnou čiarkou na konverziu

Vrátená hodnota	Typ	Description
< pohyblivá hodnota>	Plávať	Číslo s pohyblivou desatinnou čiarkou pre zadaný reťazec

Príklad

Tento príklad vytvorí verziu reťazca pre toto číslo s pohyblivou desatinnou čiarkou:

float('10.333')

A vráti tento výsledok: 10.333

formatDateTime

Vráťte časovú pečiatku v zadanom formáte.

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< preformátovaná-časová pečiatka>	Povrázok	Aktualizovaná časová pečiatka v zadanom formáte

Príklad

Tento príklad skonvertuje časovú pečiatku na zadaný formát:

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

A vráti tento výsledok: "2018-03-15T12:00:00"

getFutureTime

Vráťte aktuálnu časovú pečiatku plus zadané časové jednotky.

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

Parameter	Required	Typ	Description
< Interval>	Yes	Celé číslo	Počet zadaných časových jednotiek, ktoré sa majú pridať
< časová jednotka>	Yes	Povrázok	Jednotka času, ktorá sa má použiť s intervalom: "Sekunda", "Minúta", "Hodina", "Deň", "Týždeň", "Mesiac", "Rok"
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< aktualizovaná časová pečiatka>	Povrázok	Aktuálna časová pečiatka plus zadaný počet časových jednotiek

Príklad 1

Predpokladajme, že aktuálna časová pečiatka je "2018-03-01T00:00:00.0000000Z". Tento príklad pridáva päť dní k tejto časovej pečiatke:

getFutureTime(5, 'Day')

A vráti tento výsledok: "2018-03-06T00:00:00.0000000Z"

Príklad 2

Predpokladajme, že aktuálna časová pečiatka je "2018-03-01T00:00:00.0000000Z". V tomto príklade sa pripočíta päť dní a výsledok sa skonvertuje do formátu D:

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

A vráti tento výsledok: "Tuesday, March 6, 2018"

getPastTime

Vráťte aktuálnu časovú pečiatku mínus zadané časové jednotky.

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

Parameter	Required	Typ	Description
< Interval>	Yes	Celé číslo	Počet zadaných časových jednotiek, ktoré sa majú odčítať
< časová jednotka>	Yes	Povrázok	Jednotka času, ktorá sa má použiť s intervalom: "Sekunda", "Minúta", "Hodina", "Deň", "Týždeň", "Mesiac", "Rok"
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< aktualizovaná časová pečiatka>	Povrázok	Aktuálna časová pečiatka mínus zadaný počet časových jednotiek

Príklad 1

Predpokladajme, že aktuálna časová pečiatka je "2018-02-01T00:00:00.0000000Z". V tomto príklade sa od tejto časovej pečiatky odpočíta päť dní:

getPastTime(5, 'Day')

A vráti tento výsledok: "2018-01-27T00:00:00.0000000Z"

Príklad 2

Predpokladajme, že aktuálna časová pečiatka je "2018-02-01T00:00:00.0000000Z". V tomto príklade sa odpočíta päť dní a výsledok sa skonvertuje do formátu "D":

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

A vráti tento výsledok: "Saturday, January 27, 2018"

Väčšie

Skontrolujte, či je prvá hodnota väčšia ako druhá hodnota. Vráťte hodnotu true, keď je prvá hodnota viac, alebo hodnotu false, keď je nižšia.

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

Parameter	Required	Typ	Description
< hodnota>	Yes	Celé číslo, float alebo reťazec	Prvá hodnota na kontrolu, či je väčšia ako druhá hodnota
< compareTo (porovnať)>	Yes	Celé číslo, Float alebo Reťazec	Porovnávacia hodnota

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Vráti hodnotu true, keď je prvá hodnota väčšia ako druhá hodnota. Vráti hodnotu false, keď je prvá hodnota rovnaká alebo menšia ako druhá hodnota.

Príklad

Tieto príklady kontrolujú, či je prvá hodnota väčšia ako druhá hodnota:

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

A vráťte tieto výsledky:

• Prvý príklad: true
• Druhý príklad: false

väčší alebo rovná sa

Skontrolujte, či je prvá hodnota väčšia alebo rovná druhej hodnote. Vráti hodnotu true, keď je prvá hodnota väčšia alebo rovnaká, alebo hodnotu false, keď je prvá hodnota menšia.

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

Parameter	Required	Typ	Description
< hodnota>	Yes	Celé číslo, float alebo reťazec	Prvá hodnota na kontrolu, či je väčšia alebo rovná druhej hodnote
< compareTo (porovnať)>	Yes	Celé číslo, Float alebo Reťazec	Porovnávacia hodnota

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Vráti hodnotu true, keď je prvá hodnota väčšia alebo rovnaká ako druhá hodnota. Vráťte hodnotu false, ak je prvá hodnota menšia ako druhá hodnota.

Príklad

Tieto príklady kontrolujú, či je prvá hodnota väčšia alebo rovnaká ako druhá hodnota:

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

A vráťte tieto výsledky:

• Prvý príklad: true
• Druhý príklad: false

guid

Vygenerujte globálne jedinečný identifikátor (GUID) ako reťazec, napríklad "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Môžete tiež zadať iný formát identifikátora GUID ako predvolený formát "D", čo je 32 číslic oddelených spojovníkmi.

guid('<format>')

Parameter	Required	Typ	Description
< formát>	No	Povrázok	Špecifikátor jedného formátu pre vrátený identifikátor GUID. V predvolenom nastavení je formát "D", ale môžete použiť "N", "D", "B", "P" alebo "X".

Vrátená hodnota	Typ	Description
< Hodnota GUID>	Povrázok	Náhodne vygenerovaný identifikátor GUID

Príklad

Tento príklad vygeneruje rovnaký identifikátor GUID, ale ako 32 číslic, oddelených spojovníkmi a uzavretých v zátvorkách:

guid('P')

A vráti tento výsledok: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

ak

Skontrolujte, či je výraz pravdivý alebo nepravdivý. Na základe výsledku vráťte zadanú hodnotu.

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

Parameter	Required	Typ	Description
< výraz>	Yes	booleovský	Výraz, ktorý sa má skontrolovať
< valueIfTrue>	Yes	Ľubovoľný	Hodnota, ktorá sa vráti, keď je výraz pravdivý
< valueIfFalse>	Yes	Ľubovoľný	Hodnota, ktorá sa má vrátiť, keď je výraz false

Vrátená hodnota	Typ	Description
< špecifikovaná-vrátená-hodnota>	Ľubovoľný	Zadanej hodnoty, ktorá sa vráti na základe toho, či je výraz pravdivý alebo nepravdivý

Príklad

Tento príklad vráti "yes" , pretože zadaný výraz vráti hodnotu true. V opačnom prípade sa "no"v príklade vráti :

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

indexZ

Vráťte počiatočnú pozíciu alebo hodnotu indexu pre podreťazec. Táto funkcia nerozlišuje veľké a malé písmená a indexy začínajú číslom 0.

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

Parameter	Required	Typ	Description
< Text>	Yes	Povrázok	Reťazec, ktorý má podreťazec na vyhľadanie
< vyhľadávanieText>	Yes	Povrázok	Podreťazec, ktorý treba nájsť

Vrátená hodnota	Typ	Description
< indexová hodnota>	Celé číslo	Počiatočná pozícia alebo hodnota indexu pre zadaný podreťazec. Ak sa reťazec nenájde, vráťte číslo -1.

Príklad

V tomto príklade sa nájde počiatočná hodnota indexu pre podreťazec "world" v reťazci "hello world":

indexOf('hello world', 'world')

A vráti tento výsledok: 6

Int

Vráťte celočíselnú verziu reťazca.

int('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec, ktorý sa má skonvertovať

Vrátená hodnota	Typ	Description
< celočíselný výsledok>	Celé číslo	Celočíselná verzia pre zadaný reťazec

Príklad

Tento príklad vytvorí celočíselnú verziu pre reťazec "10":

int('10')

A vráti tento výsledok: 10

JSON

Vráťte hodnotu typu JSON (JavaScript Object Notation) alebo objekt pre reťazec alebo XML.

json('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Reťazec alebo XML	Reťazec alebo XML, ktorý sa má skonvertovať

Vrátená hodnota	Typ	Description
< Výsledok JSON>	Natívny typ alebo objekt JSON	Hodnota natívneho typu JSON alebo objekt pre zadaný reťazec alebo XML. Ak má reťazec hodnotu null, funkcia vráti prázdny objekt.

Príklad 1

Tento príklad skonvertuje tento reťazec na hodnotu JSON:

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

A vráti tento výsledok: [1, 2, 3]

Príklad 2

Tento príklad skonvertuje tento reťazec na JSON:

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

A vráti tento výsledok:

{
  "fullName": "Sophia Owen"
}

Príklad 3

Tento príklad konvertuje tento XML na JSON:

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

A vráti tento výsledok:

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

priesečník

Vráťte kolekciu, ktorá obsahuje iba spoločné položky v zadaných kolekciách. Aby sa položka zobrazila vo výsledku, musí sa objaviť vo všetkých kolekciách odovzdaných tejto funkcii. Ak má jedna alebo viac položiek rovnaký názov, vo výsledku sa zobrazí posledná položka s týmto názvom.

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

Parameter	Required	Typ	Description
< Zbierka1>, <Kolekcia2>, ...	Yes	Pole alebo objekt, ale nie oboje	Kolekcie, z ktorých chcete len bežné položky

Vrátená hodnota	Typ	Description
< Bežné položky>	Pole alebo objekt, v uvedenom poradí	Kolekcia, ktorá obsahuje iba spoločné položky v rámci zadaných kolekcií

Príklad

Tento príklad nájde bežné položky v týchto poliach:

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

A vráti pole iba s týmito položkami: [1, 2]

operácia Join

Vráti reťazec, ktorý obsahuje všetky položky z poľa a každý znak je oddelený oddeľovačom.

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

Parameter	Required	Typ	Description
< zbierka>	Yes	Pole	Pole, ktoré obsahuje položky, ktoré sa majú spojiť
< Oddeľovač>	Yes	Povrázok	Oddeľovač, ktorý sa zobrazuje medzi jednotlivými znakmi vo výslednom reťazci

Vrátená hodnota	Typ	Description
< char1><Oddeľovač><char2><Oddeľovač>...	Povrázok	Výsledný reťazec vytvorený zo všetkých položiek v zadanom poli

Príklad

Tento príklad vytvorí reťazec zo všetkých položiek v tomto poli so zadaným znakom ako oddeľovačom:

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

A vráti tento výsledok: "a.b.c"

minulý

Vrátenie poslednej položky z kolekcie.

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

Parameter	Required	Typ	Description
< zbierka>	Yes	Reťazec alebo pole	Kolekcia, kde nájdete poslednú položku

Vrátená hodnota	Typ	Description
< posledná-zbierka-položka>	Reťazec alebo pole	Posledná položka v kolekcii

Príklad

Tieto príklady nájdu poslednú položku v týchto kolekciách:

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

A vráti tieto výsledky:

• Prvý príklad: "d"
• Druhý príklad: 3

lastIndexOf

Vráťte počiatočnú pozíciu alebo hodnotu indexu pre posledný výskyt podreťazca. Táto funkcia nerozlišuje veľké a malé písmená a indexy začínajú číslom 0.

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

Parameter	Required	Typ	Description
< Text>	Yes	Povrázok	Reťazec, ktorý má podreťazec na vyhľadanie
< vyhľadávanieText>	Yes	Povrázok	Podreťazec, ktorý treba nájsť

Vrátená hodnota	Typ	Description
< Koncová hodnota indexu>	Celé číslo	Počiatočná pozícia alebo hodnota indexu pre posledný výskyt zadaného podreťazca. Ak sa reťazec nenájde, vráťte číslo -1.

Príklad

V tomto príklade sa nájde počiatočná hodnota indexu pre posledný výskyt podreťazca "world" v reťazci "hello world":

lastIndexOf('hello world', 'world')

A vráti tento výsledok: 6

dĺžka

Vráťte počet položiek v kolekcii.

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

Parameter	Required	Typ	Description
< zbierka>	Yes	Reťazec alebo pole	Zbierka s položkami na počítanie

Vrátená hodnota	Typ	Description
< dĺžka alebo počet>	Celé číslo	Počet položiek v zbierke

Príklad

Tieto príklady počítajú počet položiek v týchto kolekciách:

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

A vráťte tento výsledok: 4

menej

Skontrolujte, či je prvá hodnota menšia ako druhá hodnota. Vráťte hodnotu true, keď je prvá hodnota menšia, alebo hodnotu false, keď je prvá hodnota vyššia.

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

Parameter	Required	Typ	Description
< hodnota>	Yes	Celé číslo, float alebo reťazec	Prvá hodnota na kontrolu, či je menšia ako druhá hodnota
< compareTo (porovnať)>	Yes	Celé číslo, Float alebo Reťazec	Porovnávacia položka

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Vráti hodnotu true, keď je prvá hodnota menšia ako druhá hodnota. Vráti hodnotu false, keď je prvá hodnota rovnaká alebo väčšia ako druhá hodnota.

Príklad

Tieto príklady kontrolujú, či je prvá hodnota menšia ako druhá hodnota.

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

A vráťte tieto výsledky:

• Prvý príklad: true
• Druhý príklad: false

lessOrEquals

Skontrolujte, či je prvá hodnota menšia alebo rovná druhej hodnote. Vráťte hodnotu true, keď je prvá hodnota menšia alebo rovnaká, alebo hodnotu false, keď je prvá hodnota vyššia.

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

Parameter	Required	Typ	Description
< hodnota>	Yes	Celé číslo, float alebo reťazec	Prvá hodnota na kontrolu, či je menšia alebo rovná druhej hodnote
< compareTo (porovnať)>	Yes	Celé číslo, Float alebo Reťazec	Porovnávacia položka

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Vráti hodnotu true, keď je prvá hodnota menšia alebo rovná druhej hodnote. Vráťte hodnotu false, keď je prvá hodnota väčšia ako druhá hodnota.

Príklad

Tieto príklady kontrolujú, či je prvá hodnota menšia alebo rovnaká ako druhá hodnota.

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

A vráťte tieto výsledky:

• Prvý príklad: true
• Druhý príklad: false

Max

Vráťte najvyššiu hodnotu zo zoznamu alebo poľa s číslami, ktoré sú na oboch koncoch inkluzívne.

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

Parameter	Required	Typ	Description
< číslo1>, <číslo2>, ...	Yes	Celé číslo, Float alebo oboje	Množina čísel, z ktorých chcete získať najvyššiu hodnotu
[<číslo1>, <číslo2>, ...]	Yes	Array – celé číslo, float alebo obe	Pole čísel, z ktorých chcete získať najvyššiu hodnotu

Vrátená hodnota	Typ	Description
< Maximálna hodnota>	Celé číslo alebo float	Najvyššia hodnota v zadanom poli alebo množine čísel

Príklad

Tieto príklady získajú najvyššiu hodnotu z množiny čísel a poľa:

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

A vráťte tento výsledok: 3

min

Vráťte najnižšiu hodnotu z množiny čísel alebo poľa.

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

Parameter	Required	Typ	Description
< číslo1>, <číslo2>, ...	Yes	Celé číslo, Float alebo oboje	Množina čísel, z ktorých chcete získať najnižšiu hodnotu
[<číslo1>, <číslo2>, ...]	Yes	Array – celé číslo, float alebo obe	Pole čísel, z ktorých chcete získať najnižšiu hodnotu

Vrátená hodnota	Typ	Description
< Minimálna hodnota>	Celé číslo alebo float	Najnižšia hodnota v zadanej množine čísel alebo zadanom poli

Príklad

Tieto príklady získajú najnižšiu hodnotu v množine čísel a poli:

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

A vráťte tento výsledok: 1

Mod

Vráťte zvyšok z delenia dvoch čísel. Ak chcete získať celočíselný výsledok, pozrite si div().

mod(<dividend>, <divisor>)

Parameter	Required	Typ	Description
< dividenda>	Yes	Celé číslo alebo float	Číslo, ktoré sa má vydeliť deliteľom
< deliteľ>	Yes	Celé číslo alebo float	Číslo, ktoré rozdeľuje dividendu, ale nemôže byť 0.

Vrátená hodnota	Typ	Description
< modulo-výsledok>	Celé číslo alebo float	Zvyšok z vydelenia prvého čísla druhým číslom

Príklad

Tento príklad vydelí prvé číslo druhým číslom:

mod(3, 2)

A vráťte tento výsledok: 1

mul

Vráťte produkt z násobenia dvoch čísel.

mul(<multiplicand1>, <multiplicand2>)

Parameter	Required	Typ	Description
< násobenie1>	Yes	Celé číslo alebo float	Číslo, ktoré sa má vynásobiť násobkom2
< násobenie2>	Yes	Celé číslo alebo float	Číslo, ktoré násobí násobok1

Vrátená hodnota	Typ	Description
< výsledok produktu>	Celé číslo alebo float	Súčin vynásobením prvého čísla druhým číslom

Príklad

Tieto príklady násobia prvé číslo druhým číslom:

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

A vráťte tieto výsledky:

• Prvý príklad: 2
• Druhý príklad 3

nie

Skontrolujte, či je výraz nepravdivý. Vráťte hodnotu true, ak je výraz false, alebo hodnotu false, ak je true.

not(<expression>)

Parameter	Required	Typ	Description
< výraz>	Yes	booleovský	Výraz, ktorý sa má skontrolovať

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Vráťte hodnotu true, keď je výraz false. Ak je výraz pravdivý, vráti hodnotu false.

Príklad 1

Tieto príklady kontrolujú, či sú zadané výrazy nepravdivé:

not(false)
not(true)

A vráťte tieto výsledky:

• Prvý príklad: Výraz je false, takže funkcia vráti true.
• Druhý príklad: Výraz je pravdivý, takže funkcia vráti false.

Príklad 2

Tieto príklady kontrolujú, či sú zadané výrazy nepravdivé:

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

A vráťte tieto výsledky:

• Prvý príklad: Výraz je false, takže funkcia vráti true.
• Druhý príklad: Výraz je pravdivý, takže funkcia vráti false.

or

Skontrolujte, či je aspoň jeden výraz pravdivý. Vráťte hodnotu true, ak je pravdivý aspoň jeden výraz, alebo hodnotu false, ak sú oba hodnoty false.

or(<expression1>, <expression2>)

Parameter	Required	Typ	Description
< výraz1>, <výraz2>	Yes	booleovský	Výrazy, ktoré sa majú skontrolovať

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Vráťte hodnotu true, ak je pravdivý aspoň jeden výraz. Vráťte hodnotu false, ak sú oba výrazy false.

Príklad 1

Tieto príklady kontrolujú, či je pravdivý aspoň jeden výraz:

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

A vráťte tieto výsledky:

• Prvý príklad: Aspoň jeden výraz je pravdivý, takže funkcia vráti true.
• Druhý príklad: Oba výrazy sú nepravdivé, takže funkcia vráti false.

Príklad 2

Tieto príklady kontrolujú, či je pravdivý aspoň jeden výraz:

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

A vráťte tieto výsledky:

• Prvý príklad: Aspoň jeden výraz je pravdivý, takže funkcia vráti true.
• Druhý príklad: Oba výrazy sú nepravdivé, takže funkcia vráti false.

Rand

Vráťte náhodné celé číslo zo zadaného rozsahu, ktorý je zahrnutý iba na začiatočnom konci.

rand(<minValue>, <maxValue>)

Parameter	Required	Typ	Description
< MinValue>	Yes	Celé číslo	Najnižšie celé číslo v rozsahu
< hodnota maxValue>	Yes	Celé číslo	Celé číslo, ktoré nasleduje za najvyšším celým číslom v rozsahu, ktorý môže funkcia vrátiť

Vrátená hodnota	Typ	Description
< náhodný výsledok>	Celé číslo	Náhodné celé číslo vrátené zo zadaného rozsahu

Príklad

Tento príklad získa náhodné celé číslo zo zadaného rozsahu s výnimkou maximálnej hodnoty:

rand(1, 5)

A vráti jedno z týchto čísel ako výsledok: 1, 2, 3alebo 4

rozsah

Vráti celočíselné pole, ktoré začína zadaným celým číslom.

range(<startIndex>, <count>)

Parameter	Required	Typ	Description
< ŠtartIndex>	Yes	Celé číslo	Celočíselná hodnota, ktorá začína pole ako prvá položka
< počítať>	Yes	Celé číslo	Počet celých čísel v poli

Vrátená hodnota	Typ	Description
[<výsledok rozsahu>]	Pole	Pole s celými číslami začínajúcimi od zadaného indexu

Príklad

Tento príklad vytvorí celočíselné pole, ktoré začína od zadaného indexu a má zadaný počet celých čísel:

range(1, 4)

A vráti tento výsledok: [1, 2, 3, 4]

nahradiť

Nahraďte podreťazec zadaným reťazcom a vráťte výsledný reťazec. V tejto funkcii sa rozlišujú veľké a malé písmená.

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

Parameter	Required	Typ	Description
< Text>	Yes	Povrázok	Reťazec, ktorý má nahradiť podreťazec
< starýText>	Yes	Povrázok	Podreťazec, ktorý sa má nahradiť
< newText>	Yes	Povrázok	Náhradný reťazec

Vrátená hodnota	Typ	Description
< aktualizovaný text>	Povrázok	Aktualizovaný reťazec po nahradení podreťazca Ak sa podreťazec nenájde, vráťte pôvodný reťazec.

Príklad

Tento príklad nájde "starý" podreťazec v "starom reťazci" a nahradí "starý" slovom "nový":

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

A vráti tento výsledok: "the new string"

vynechať

Odstráňte položky z prednej časti kolekcie a vráťte všetky ostatné položky .

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

Parameter	Required	Typ	Description
< zbierka>	Yes	Pole	Kolekcia, ktorej položky chcete odstrániť
< počítať>	Yes	Celé číslo	Kladné celé číslo pre počet položiek, ktoré sa majú odstrániť vpredu

Vrátená hodnota	Typ	Description
[<aktualizovaná zbierka>]	Pole	Aktualizovaná kolekcia po odstránení zadaných položiek

Príklad

V tomto príklade sa odstráni jedna položka, číslo 0, z prednej časti zadaného poľa:

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

A vráti toto pole so zostávajúcimi položkami: [1,2,3]

rozdeliť

Vráti pole, ktoré obsahuje podreťazce oddelené čiarkami na základe zadaného oddeľovacieho znaku v pôvodnom reťazci.

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

Parameter	Required	Typ	Description
< Text>	Yes	Povrázok	Reťazec, ktorý sa má rozdeliť na podreťazce na základe zadaného oddeľovača v pôvodnom reťazci
< Oddeľovač>	Yes	Povrázok	Znak v pôvodnom reťazci, ktorý sa má použiť ako oddeľovač

Vrátená hodnota	Typ	Description
[<podreťazec1>;<podreťazec2>,...]	Pole	Pole, ktoré obsahuje podreťazce z pôvodného reťazca oddelené čiarkami

Príklad

Tento príklad vytvorí pole s podreťazcami zo zadaného reťazca na základe zadaného znaku ako oddeľovača:

split('a_b_c', '_')

A vráti toto pole ako výsledok: ["a","b","c"]

začiatok dňa

Vráťte začiatok dňa pre časovú pečiatku.

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< aktualizovaná časová pečiatka>	Povrázok	Zadaná časová pečiatka, ale začínajúca na značke nultej hodiny pre daný deň

Príklad

V tomto príklade sa nájde začiatok dňa pre túto časovú pečiatku:

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

A vráti tento výsledok: "2018-03-15T00:00:00.0000000Z"

začiatokHodiny

Vráťte začiatok hodiny pre časovú pečiatku.

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< aktualizovaná časová pečiatka>	Povrázok	Zadaná časová pečiatka, ale začínajúca na značke nultej minúty pre hodinu

Príklad

V tomto príklade sa nájde začiatok hodiny pre túto časovú pečiatku:

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

A vráti tento výsledok: "2018-03-15T13:00:00.0000000Z"

začiatok mesiaca

Vráťte začiatok mesiaca pre časovú pečiatku.

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< aktualizovaná časová pečiatka>	Povrázok	Špecifikovaná časová pečiatka, ale začínajúca sa prvým dňom mesiaca na značke nultej hodiny

Príklad

Tento príklad vráti začiatok mesiaca pre túto časovú pečiatku:

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

A vráti tento výsledok: "2018-03-01T00:00:00.0000000Z"

začína s

Skontrolujte, či reťazec začína konkrétnym podreťazcom. Vráti hodnotu true, keď sa nájde podreťazec, alebo vráti hodnotu false, ak sa nenájde. V tejto funkcii sa nerozlišujú veľké a malé písmená.

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

Parameter	Required	Typ	Description
< Text>	Yes	Povrázok	Reťazec, ktorý sa má skontrolovať
< vyhľadávanieText>	Yes	Povrázok	Počiatočný reťazec, ktorý treba nájsť

Vrátená hodnota	Typ	Description
pravda alebo nepravda	booleovský	Vráti hodnotu true, keď sa nájde počiatočný podreťazec. Ak sa nenájde, vráti nepravdivé.

Príklad 1

Tento príklad kontroluje, či reťazec "hello world" začína podreťazcom "hello":

startsWith('hello world', 'hello')

A vráti tento výsledok: true

Príklad 2

Tento príklad kontroluje, či reťazec "hello world" začína podreťazcom "greetings":

startsWith('hello world', 'greetings')

A vráti tento výsledok: false

reťazec

Vráťte verziu reťazca pre hodnotu.

string(<value>)

Parameter	Required	Typ	Description
< hodnota>	Yes	Ľubovoľný	Hodnota, ktorá sa má previesť

Vrátená hodnota	Typ	Description
< reťazec-hodnota>	Povrázok	Verzia reťazca pre zadanú hodnotu

Príklad 1

Tento príklad vytvorí verziu reťazca pre toto číslo:

string(10)

A vráti tento výsledok: "10"

Príklad 2

V tomto príklade sa vytvorí reťazec pre zadaný objekt JSON a použije sa znak spätnej lomky (\) ako znak úniku pre dvojité úvodzovky (").

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

A vráti tento výsledok: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

Vráťte výsledok odčítaním druhého čísla od prvého čísla.

sub(<minuend>, <subtrahend>)

Parameter	Required	Typ	Description
< menšenec>	Yes	Celé číslo alebo float	Číslo, od ktorého sa má odčítať subtrahend
< menšiteľ>	Yes	Celé číslo alebo float	Číslo, ktoré sa má odpočítať od minuendu

Vrátená hodnota	Typ	Description
< výsledok>	Celé číslo alebo float	Výsledok odčítania druhého čísla od prvého čísla

Príklad

V tomto príklade sa odpočíta druhé číslo od prvého čísla:

sub(10.3, .3)

A vráti tento výsledok: 10

Podreťazec

Vracajú znaky z reťazca, počnúc zadanou pozíciou alebo indexom. Hodnoty indexu začínajú číslom 0.

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

Parameter	Required	Typ	Description
< Text>	Yes	Povrázok	Reťazec, ktorého znaky chcete
< ŠtartIndex>	Yes	Celé číslo	Kladné číslo rovné alebo väčšie ako 0, ktoré chcete použiť ako počiatočnú pozíciu alebo hodnotu indexu
< dĺžka>	Yes	Celé číslo	kladný počet znakov, ktoré chcete mať v podreťazci

Vrátená hodnota	Typ	Description
< výsledok podreťazca>	Povrázok	Podreťazec so zadaným počtom znakov, začínajúci na zadanej pozícii indexu v zdrojovom reťazci

Príklad

Tento príklad vytvorí päťznakový podreťazec zo zadaného reťazca, počnúc hodnotou indexu 6:

substring('hello world', 6, 5)

A vráti tento výsledok: "world"

odčítaťZČasu

Odčítajte od časovej pečiatky počet časových jednotiek. Pozri tiež getPastTime.

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

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec, ktorý obsahuje časovú pečiatku
< Interval>	Yes	Celé číslo	Počet zadaných časových jednotiek, ktoré sa majú odčítať
< časová jednotka>	Yes	Povrázok	Jednotka času, ktorá sa má použiť s intervalom: "Sekunda", "Minúta", "Hodina", "Deň", "Týždeň", "Mesiac", "Rok"
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< aktualizovaná časová pečiatka>	Povrázok	Časová pečiatka mínus zadaný počet časových jednotiek

Príklad 1

Tento príklad odpočíta jeden deň od tejto časovej pečiatky:

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

A vráti tento výsledok: "2018-01-01T00:00:00:0000000Z"

Príklad 2

Tento príklad odpočíta jeden deň od tejto časovej pečiatky:

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

A vráti tento výsledok pomocou voliteľného formátu "D": "Monday, January, 1, 2018"

vziať

Vrátenie položiek z prednej časti kolekcie.

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

Parameter	Required	Typ	Description
< zbierka>	Yes	Reťazec alebo pole	Kolekcia, ktorej položky chcete
< počítať>	Yes	Celé číslo	Kladné celé číslo pre počet položiek, ktoré chcete spredu

Vrátená hodnota	Typ	Description
< podmnožina> alebo [<podmnožina>]	Reťazec alebo pole	Reťazec alebo pole so zadaným počtom položiek prevzatých z prednej strany pôvodnej kolekcie

Príklad

Tieto príklady získajú zadaný počet položiek z prednej strany týchto kolekcií:

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

A vráťte tieto výsledky:

• Prvý príklad: "abc"
• Druhý príklad: [0, 1, 2]

Kliešte

Vráťte ticks hodnotu vlastnosti pre zadanú časovú pečiatku Kliešť je 100-nanosekundový interval.

ticks('<timestamp>')

Parameter	Required	Typ	Description
< Časových pečiatok>	Yes	Povrázok	Reťazec časovej pečiatky

Vrátená hodnota	Typ	Description
< Číslo kliešťov>	Celé číslo	Počet tikov, ktoré uplynuli od 12:00:00 polnoci 1. januára 0001 v gregoriánskom kalendári od zadávanej časovej pečiatky

naNižšie

Vráťte reťazec vo formáte malých písmen. Ak znak v reťazci nemá verziu s malými písmenami, tento znak zostane vo vrátenom reťazci nezmenený.

toLower('<text>')

Parameter	Required	Typ	Description
< Text>	Yes	Povrázok	Reťazec, ktorý sa má vrátiť vo formáte malých písmen

Vrátená hodnota	Typ	Description
< Text s malými písmenami>	Povrázok	Pôvodný reťazec vo formáte malých písmen

Príklad

Tento príklad konvertuje tento reťazec na malé písmená:

toLower('Hello World')

A vráti tento výsledok: "hello world"

doHorný

Vráťte reťazec vo formáte veľkých písmen. Ak znak v reťazci nemá verziu veľkými písmenami, tento znak zostane vo vrátenom reťazci nezmenený.

toUpper('<text>')

Parameter	Required	Typ	Description
< Text>	Yes	Povrázok	Reťazec, ktorý sa má vrátiť vo formáte veľkých písmen

Vrátená hodnota	Typ	Description
< Veľké písmená>	Povrázok	Pôvodný reťazec vo formáte veľkých písmen

Príklad

Tento príklad skonvertuje tento reťazec na veľké písmená:

toUpper('Hello World')

A vráti tento výsledok: "HELLO WORLD"

orezať

Odstráňte úvodné a koncové medzery z reťazca a vráťte aktualizovaný reťazec.

trim('<text>')

Parameter	Required	Typ	Description
< Text>	Yes	Povrázok	Reťazec, ktorý má úvodné a koncové medzery na odstránenie

Vrátená hodnota	Typ	Description
< aktualizovanéText>	Povrázok	Aktualizovaná verzia pôvodného reťazca bez úvodných alebo koncových medzer

Príklad

V tomto príklade sa odstránia úvodné a koncové medzery z reťazca " Hello World ":

trim(' Hello World  ')

A vráti tento výsledok: "Hello World"

spojenie

Vráťte kolekciu, ktorá obsahuje všetky položky zo zadaných kolekcií. Ak sa má položka zobraziť vo výsledku, môže sa zobraziť v ľubovoľnej kolekcii odovzdanej tejto funkcii. Ak má jedna alebo viac položiek rovnaký názov, vo výsledku sa zobrazí posledná položka s týmto názvom.

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

Parameter	Required	Typ	Description
< Zbierka1>, <Kolekcia2>, ...	Yes	Pole alebo objekt, ale nie oboje	Kolekcie, z ktorých chcete získať všetky položky

Vrátená hodnota	Typ	Description
< aktualizovanéZbierka>	Pole alebo objekt, v uvedenom poradí	Kolekcia so všetkými položkami zo zadaných kolekcií - bez duplikátov

Príklad

V tomto príklade sa získajú všetky položky z týchto kolekcií:

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

A vráti tento výsledok: [1, 2, 3, 10, 101]

uriKomponent

Vráťte verziu kódovanú v URI (Uniform Resource Identifier) pre reťazec nahradením znakov nebezpečných pre URL adresu únikovými znakmi. Túto funkciu použite namiesto encodeUriComponent(). Aj keď obe funkcie fungujú rovnako, uprednostňuje sa. uriComponent()

uriComponent('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec, ktorý sa má skonvertovať do formátu kódovaného URI

Vrátená hodnota	Typ	Description
< encoded-uri>	Povrázok	Reťazec kódovaný v URI s únikovými znakmi

Príklad

Tento príklad vytvorí verziu kódovanú URI pre tento reťazec:

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

A vráti tento výsledok: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Vráťte binárnu verziu pre komponent URI (Uniform Resource Identifier).

uriComponentToBinary('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec kódovaný v URI na konverziu

Vrátená hodnota	Typ	Description
< binárny-pre-kódovaný-identifikátor URI>	Povrázok	Binárna verzia reťazca kódovaného URI. Binárny obsah je kódovaný base64 a reprezentovaný súborom $content.

Príklad

Tento príklad vytvorí binárnu verziu pre tento reťazec s kódovaním URI:

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

A vráti tento výsledok:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Vráťte verziu reťazca pre reťazec s kódovaním identifikátora URI (Uniform Resource Identifier), čím sa účinne dekóduje reťazec kódovaný identifikátorom URI.

uriComponentToString('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec zakódovaný v URI na dekódovanie

Vrátená hodnota	Typ	Description
< decoded-uri>	Povrázok	Dekódovaná verzia reťazca kódovaného URI

Príklad

Tento príklad vytvorí dekódovanú verziu reťazca pre tento reťazec s kódovaním URI:

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

A vráti tento výsledok: "https://contoso.com"

utcNow

Vráťte aktuálnu časovú pečiatku.

utcNow('<format>')

Voliteľne môžete zadať iný formát pomocou parametra <format.>

Parameter	Required	Typ	Description
< formát>	No	Povrázok	Buď jeden špecifikátor formátu , alebo vlastný vzor formátu. Predvolený formát časovej pečiatky je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), ktorý je v súlade s normou ISO 8601 a zachováva informácie o časovom pásme.

Vrátená hodnota	Typ	Description
< aktuálna časová pečiatka>	Povrázok	Aktuálny dátum a čas

Príklad 1

Predpokladajme, že dnes je 15. apríl 2018 o 13:00:00. V tomto príklade sa zobrazí aktuálna časová pečiatka:

utcNow()

A vráti tento výsledok: "2018-04-15T13:00:00.0000000Z"

Príklad 2

Predpokladajme, že dnes je 15. apríl 2018 o 13:00:00. Tento príklad získa aktuálnu časovú pečiatku pomocou voliteľného formátu "D":

utcNow('D')

A vráti tento výsledok: "Sunday, April 15, 2018"

XML

Vráťte verziu XML pre reťazec, ktorý obsahuje objekt JSON.

xml('<value>')

Parameter	Required	Typ	Description
< hodnota>	Yes	Povrázok	Reťazec s objektom JSON na konverziu Objekt JSON musí mať iba jednu koreňovú vlastnosť, ktorá nemôže byť poľom. Použite znak spätnej lomky (\) ako znak escape pre dvojité úvodzovky (").

Vrátená hodnota	Typ	Description
< xml-verzia>	Object	Zakódovaný XML pre zadaný reťazec alebo objekt JSON

Príklad 1

Tento príklad vytvorí verziu XML pre tento reťazec, ktorý obsahuje objekt JSON:

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

A vráti tento výsledok XML:

<name>Sophia Owen</name>

Príklad 2

Predpokladajme, že máte tento objekt JSON:

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

Tento príklad vytvorí XML pre reťazec, ktorý obsahuje tento objekt JSON:

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

A vráti tento výsledok XML:

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

xpath

Skontrolujte, či sa v jazyku XML nachádzajú uzly alebo hodnoty, ktoré sa zhodujú s výrazom XPath (XML Path Language), a vráťte zodpovedajúce uzly alebo hodnoty. Výraz XPath alebo len "XPath" vám pomôže navigovať v štruktúre dokumentu XML, aby ste mohli vybrať uzly alebo vypočítať hodnoty v obsahu XML.

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

Parameter	Required	Typ	Description
< XML>	Yes	Ľubovoľný	Reťazec XML na vyhľadávanie uzlov alebo hodnôt, ktoré zodpovedajú hodnote výrazu XPath
< Xpath>	Yes	Ľubovoľný	Výraz XPath používaný na vyhľadanie zodpovedajúcich uzlov alebo hodnôt XML

Vrátená hodnota	Typ	Description
< xml-uzol>	XML	Uzol XML, keď iba jeden uzol zodpovedá zadanému výrazu XPath
< hodnota>	Ľubovoľný	Hodnota z uzla XML, keď sa so zadaným výrazom XPath zhoduje iba jedna hodnota
[<xml-uzol1>, <xml-uzol2>, ...] -alebo- [<hodnota1>, <hodnota2>, ...]	Pole	Pole s uzlami XML alebo hodnotami, ktoré zodpovedajú zadanému výrazu XPath

Príklad 1

V nadväznosti na príklad 1 sa v tomto príklade vyhľadajú uzly, ktoré sa zhodujú s uzlom, <count></count> a pridajú sa tieto hodnoty uzlov k funkcii sum() :

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

A vráti tento výsledok: 30

Príklad 2

V tomto príklade oba výrazy nájdu uzly, ktoré zodpovedajú <location></location> uzlu, v zadaných argumentoch, ktoré obsahujú XML s priestorom názvov. Výrazy používajú znak spätnej lomky (\) ako znak escape pre dvojité úvodzovky (").

• Výraz 1

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

• Vyjadrenie 2

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

Tu sú argumenty:

• Tento XML, ktorý obsahuje menný priestor dokumentu XML: xmlns="http://contoso.com"

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

• Buď výraz XPath tu:

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

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

Tu je výsledný uzol, ktorý sa zhoduje s uzlom:<location></location>

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

Príklad 3

V nadväznosti na príklad 3 tento príklad nájde hodnotu v uzle <location></location> :

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

A vráti tento výsledok: "Paris"

Poznámka

K výrazom toku údajov je možné pridávať komentáre, ale nie vo výrazoch kanála.

Súvisiaci obsah

Pokyny na všeobecné používanie parametrov nájdete v téme Parametre pre Data Factory v službe Fabric