Zdieľať cez

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

  • Článok

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

Výrazy

Hodnoty výrazu v definícii môžu byť literál alebo výrazy, ktoré sa vyhodnocujú v režime runtime. Napríklad:

"value"

or

"@pipeline().parameters.password"

Výrazy sa môžu zobrazovať kdekoľvek v hodnote reťazca a vždy majú za následok inú hodnotu reťazca. Ak je hodnota výrazom, telo výrazu sa extrahuje odstránením znaku @. Ak je potrebný reťazec literálu, ktorý sa začína reťazcom @, musí byť vytvorený pomocou @@. V nasledujúcich príkladoch je uvedené, 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 jeden znak reťazca, ktorý obsahuje znak @.
" @" Vráti sa reťazec 2 znakov, ktorý obsahuje znak @.

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

Výsledkom interpolácie reťazca je vždy reťazec. Povedzme, že som definoval myNumber ako 42 a myString ako foo:

Hodnota výrazu Result
"@pipeline().parameters.myString" Vráti sa foo ako reťazec.
"@{pipeline().parameters.myString}" Vráti sa foo ako reťazec.
"@pipeline().parameters.myNumber" Vráti sa 42 ako číslo.
"@{pipeline().parameters.myNumber}" Vráti sa 42 ako reťazec.
Odpoveď je: @{pipeline().parameters.myNumber}" Vráti reťazec Answer is: 42.
"@concat('Odpoveď je: ', string(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 postupu riadenia, ako je napríklad aktivita ForEach, môžete zadať pole, ktoré sa má iterovať pre položky vlastností, a použiť @item() ho na iteráciu v rámci jednej enumerácie 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 iterovanie 10-krát počnúc 0 končiacou na 9.

Na zaznamenanie výstupu aktivity a prijímanie rozhodnutí môžete použiť @activity(názov aktivity. Vezmime si webovú aktivitu s názvom Web1. Ak chcete umiestniť výstup prvej aktivity do tela druhej aktivity, výraz vo všeobecnosti vyzerá takto: @activity(Web1.output alebo @activity(Web1.output.data alebo niečo podobné v závislosti od toho, ako vyzerá výstup prvej aktivity.

Príklady

Príklad komplexného výrazu

V nasledujúcom príklade je zobrazený zložitý príklad, ktorý odkazuje na hlboké podob pole výstupu aktivity. Ak chcete odkazovať na parameter kanála, ktorý sa vyhodnotí ako podpolo, ako súčasť výstupu aktivity použite syntax [] namiesto operátora dot(.) (ako v prípade subfield1 a subfield2).

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

Dynamické vytváranie súborov a ich pomenovanie je bežným vzorom. Preskúmajme niekoľko príkladov dynamických pomenovaní súborov.

  • Pripojte Dátum 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 spustenia: @concat('Test_', pipeline().TriggerTime)
  • Výstup vlastného názvu súboru v postupe mapovania údajov 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_.

Editor dynamického obsahu

Keď dokončíte úpravu, editor dynamického obsahu automaticky odstráni znaky vo vašom obsahu. Napríklad nasledujúci obsah v editore obsahu je interpolácia reťazca s funkciou výrazu.

"@{toUpper('myData')}"

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

"MYDATA"

Nahradenie špeciálnych znakov

Editor dynamického obsahu po dokončení úpravy automaticky ukončí znaky, ako je dvojitá úvodzovka, opačná lomka vo vašom obsahu. To spôsobí problémy, ak chcete nahradiť posun riadka alebo kartu pomocou funkcie \n, \t v replace(). Dynamický obsah v zobrazení kódu môžete upraviť tak, aby sa vo výraze odstránili nadbytočné znaky , alebo môžete použiť postup nižšie na nahradenie špeciálnych znakov pomocou jazyka výrazov:

  1. Kódovanie URL adresy pre pôvodnú hodnotu reťazca
  2. Nahraďte reťazec kódovaný URL adresou, napríklad posun riadka (%0A), návrat na koniec riadka (%0D), vodorovný tabulátor(%09).
  3. Dekódovanie URL adries

Napríklad premenná companyName s novým znakom riadka vo svojej hodnote môže odstrániť @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) znak newline.

Contoso- Corporation

Znak jednoduchej úvodzovky

Výrazové funkcie používajú jednoduchú úvodzovku pre parametre hodnoty reťazca. Ak chcete uniknúť znaku ' vo funkciách reťazca, použite dve jednoduché úvodzovky. Napríklad výraz @concat('Baba', '''s ', 'book store') vráti výsledok pod sebou.

Baba's book store

Premenné rozsahu kanála

Na tieto systémové premenné môžete odkazovať kdekoľvek v kanáli.

Názov premennej Description
@pipeline().DataFactory Názov údajov alebo pracovného priestoru Synapse, v rámci ktorý je spustený kanál
@pipeline().Pipeline Názov kanála
@pipeline().RunId ID konkrétneho spustenia kanála
@pipeline().TriggerId ID spúšťača, ktorý vyvolá kanál
@pipeline().TriggerName Názov spúšťača, ktorý vyvolá kanál
@pipeline().TriggerTime Čas spustenia spúšťača, ktorý vyvolá kanál. V tomto čase sa spúšťač skutočne spustil na vyvolanie spustenia kanála a môže sa mierne líšiť od plánovaného času spúšťača.
@pipeline().GroupId ID skupiny, do ktorej spustenie kanála patrí.
@pipeline()?. TriggeredByPipelineName Názov kanála, ktorým sa spustí spustenie kanála. Použiteľné, keď sa spustenie kanála spustí aktivitou ExecutePipeline. Ak sa použije za iných okolností, vyhodnotiť hodnotu null . Všimnite si otáznik po @pipeline()
@pipeline()?. TriggeredByPipelineRunId ID spustenia kanála, ktorým sa spustí spustenie kanála. Použiteľné, keď sa spustenie kanála spustí aktivitou ExecutePipeline. Ak sa použije za iných okolností, vyhodnotiť hodnotu null . Všimnite si otáznik po @pipeline()

Poznámka

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

Funkcie

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.

Dátumové funkcie

Funkcia dátumu a času Úloha
addDays Pridajte do časovej pečiatky počet dní.
hodiny addHours Pridajte do časovej pečiatky niekoľko hodín.
addMinutes (pridanie minutes) Pridajte do časovej pečiatky počet minút.
addSeconds (pridaťsekundy) Pridajte počet sekúnd do časovej pečiatky.
addToTime Pridajte počet jednotiek času do časovej pečiatky. Pozrite si tiež tému getFutureTime.
convertFromUtc Konvertujte časovú pečiatku z koordinovaného svetového času (UTC) na cieľové časové pásmo.
convertTimeZone (konvertovať časové pásmo) 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 koordinovaný svetový čas (UTC).
dayOfMonth (deňVMesiac) Vracia zložku dňa v mesiaci z časovej pečiatky.
dayOfWeek Zložka dňa v týždni sa vracia z časovej pečiatky.
dayOfYear Vracia zložku dňa v roku z časovej pečiatky.
formatDateTime Vráťte časovú pečiatku ako reťazec v voliteľnom formáte.
getFutureTime Vráti aktuálnu časovú pečiatku a zadané časové jednotky. Pozri tiež addToTime.
getPastTime Vráti aktuálnu časovú pečiatku mínus zadané časové jednotky. Pozri tiež odčítavať čas odčasu.
startOfDay Vráti začiatok dňa pre časovú pečiatku.
startOfHour Vráti začiatok hodiny pre časovú pečiatku.
startOfMonth (začiatokMesiac) Vrátiť začiatok mesiaca pre časovú pečiatku.
subtractFromTime Od časovej pečiatky odčítajte počet jednotiek času. Pozrite si tiež tému getPastTime.
Kliešte ticks Vrátenie hodnoty vlastnosti pre zadanú časovú pečiatku.
utcNow Vráti aktuálnu časovú pečiatku ako reťazec.

Funkcie reťazca

Ak chcete pracovať s reťazcami, môžete použiť tieto funkcie reťazcov a tiež niektoré funkcie kolekcie. Funkcie reťazcov fungujú iba s reťazcami.

Funkcia reťazca Úloha
concat (funkcia concat) Skombinujte dva alebo viacero reťazcov a vráťte kombinovaný reťazec.
endsWith Skontrolujte, či reťazec končí zadaným podreťazecom.
Identifikátor guid Vygenerujte globálne jedinečný identifikátor (GUID) ako reťazec.
indexOf Vráti počiatočnú pozíciu podreťazca.
lastIndexOf Vráti 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áťte pole, ktoré obsahuje podreťazce oddelené čiarkami od väčšieho reťazca na základe zadaného znaku oddeľovača v pôvodnom reťazci.
startsWith Skontrolujte, či reťazec začína konkrétnym podreťazecom.
Podreťazec Vráti znaky z reťazca počnúc zadanou pozíciou.
toLower (Sledovať) Vráťte reťazec vo formáte malým písmenom.
toUpper (večera) Vráti reťazec vo formáte s veľkými písmenami.
Trim Odstráňte úvodný aj koncový prázdny znak z reťazca a vráťte aktualizovaný reťazec.

Funkcie kolekcie

Ak chcete pracovať s kolekciami, všeobecne poľami, reťazcami a niekedy slovníkmi, môžete použiť tieto funkcie kolekcie.

Funkcia Collection Úloha
Obsahuje Skontrolujte, či kolekcia obsahuje konkrétnu položku.
Prázdne Skontrolujte, či je kolekcia prázdna.
Prvý Vráťte prvú položku z kolekcie.
Križovatke Vráti kolekciu, ktorá obsahuje iba bežné položky v zadaných kolekciách.
Pripojiť Vráťte reťazec obsahujúci všetky položky z poľa oddeleného zadaným znakom.
Posledný Vráti poslednú položku z kolekcie.
Dĺžka Vráti 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.
take (vezmite) Vrátiť položky z prednej časti kolekcie.
Únie Vráťte kolekciu, ktorá obsahuje všetky položky zo zadaných kolekcií.

Logické funkcie

Tieto funkcie sú užitočné v rámci podmienok, možno ich použiť na vyhodnotenie akéhokoľvek typu logiky.

Funkcia logického porovnávania Úloha
A Skontrolujte, či sú všetky výrazy pravdivé.
Rovná Skontrolujte, či sú obe hodnoty rovnocenné.
Väčšie Skontrolujte, či je prvá hodnota väčšia ako druhá hodnota.
greaterOrEquals 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 (menšieOrRovná sa) 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ý.

Funkcie konverzie

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

  • povrázok
  • celé číslo
  • Plavák
  • boolovská hodnota
  • Polia
  • Slovníky
Funkcia konverzie Úloha
Pole Vráti pole z jedného zadaného vstupu. Viacero vstupov nájdete v téme createArray.
base64 Vráťte verziu s kódovaním base64 pre reťazec.
base64ToBinary Vráti binárnu verziu reťazca s kódovaním base64.
base64ToString Vrátenie verzie reťazca pre reťazec s kódovaním base64.
Binárne Vrátenie binárnej verzie pre vstupnú hodnotu.
Bool Vrátiť booleovskú verziu vstupnej hodnoty.
Splynúť Vráťte prvú hodnotu bez hodnoty null z jedného alebo viacerých parametrov.
createArray (vytvoriť Zmätok) Vráti pole z viacerých vstupov.
dataUri Vrátenie identifikátora URI údajov pre vstupnú hodnotu.
dataUriToBinary Vráti binárnu verziu identifikátora URI údajov.
dataUriToString Vrátiť verziu reťazca pre identifikátor URI údajov.
decodeBase64 Vrátenie verzie reťazca pre reťazec s kódovaním base64.
decodeDataUri Vráti binárnu verziu identifikátora URI údajov.
decodeUriComponent Vrátiť reťazec, ktorý nahradí koncové znaky dekódovanými verziami.
encodeUriComponent Vráťte reťazec, ktorý nahradí nebezpečné znaky URL adresy koncovými znakmi.
Plavák Vrátenie čísla s pohyblivou desatinnou čiarkou pre vstupnú hodnotu.
Int Vráti celočíselnú verziu reťazca.
reťazec Vrátenie verzie reťazca pre vstupnú hodnotu.
uriComponent Vrátiť verziu zakódovanú identifikátorom URI pre vstupnú hodnotu nahradením nebezpečných znakov URL adries koncovými znakmi.
uriComponentToBinary Vráti binárnu verziu reťazca kódovaného identifikátorom URI.
uriComponentToString Vrátenie verzie reťazca pre reťazec kódovaný identifikátorom URI.
Xml Vrátenie verzie XML pre reťazec.
Xpath Skontrolujte xml uzly alebo hodnoty, ktoré zodpovedajú výrazu XPath (XML Path Language), a vrátia zodpovedajúce uzly alebo hodnoty.

Matematické funkcie

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

Matematické funkcie Úloha
Pridať Vráti výsledok sčítaním dvoch čísel.
Div Vráti výsledok delenia dvoch čísel.
Max Vráti najvyššiu hodnotu z množiny čísel alebo poľa.
Min Vrátenie najnižšej hodnoty z množiny čísel alebo poľa.
Mod Vráti zvyšok po delení dvoch čísel.
Mul Vráti produkt z vynásobenia dvoch čísel.
Rand Vráti náhodné celé číslo zo zadaného rozsahu.
Rozsah Vráti celočíselné pole, ktoré sa začína zo zadaného celého čísla.
Sub Vráti výsledok od odpočítania druhého čísla od prvého čísla.

Referenčné informácie k funkcii

Táto časť obsahuje zoznam všetkých dostupných funkcií v abecednom poradí.

Pridať

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

add(<summand_1>, <summand_2>)
Parameter Požadovaný Zadať Description
<>summand_1, <summand_2> Áno Celé číslo, číslo s pohyblivou pohyblivou čiarku alebo zmiešané Čísla, ktoré sa majú pridať
Vrátená hodnota Zadať Description
<result-sum (súčet výsledkov)> Celé číslo alebo pohyblivá pohyblivá čiarka Výsledok sčítaním zadaných čísel

Príklad

Tento príklad sčíta zadané čísla:

add(1, 1.5)

A vráti tento výsledok: 2.5

addDays

Pridajte do časovej pečiatky počet dní.

addDays('<timestamp>', <days>, '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<Dní> Áno Integer Kladný alebo záporný počet dní, ktoré sa majú pridať
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<aktualizovaná časová pečiatka> String Časová pečiatka plus zadaný počet dní

Príklad č. 1

Tento príklad pridá do zadanej časovej pečiatky 10 dní:

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

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

Príklad č. 2

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

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

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

hodiny addHours

Pridajte do časovej pečiatky niekoľko hodín.

addHours('<timestamp>', <hours>, '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<Hodín> Áno Integer Kladný alebo záporný počet hodín, ktoré sa majú pridať
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<aktualizovaná časová pečiatka> String Časová pečiatka plus zadaný počet hodín

Príklad č. 1

Tento príklad k zadanej časovej pečiatke pripočíta 10 hodín:

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

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

Príklad č. 2

Tento príklad odpočíta päť hodín od zadanej časovej pečiatky:

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

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

addMinutes (pridanie minutes)

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

addMinutes('<timestamp>', <minutes>, '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<Minút> Áno Integer Kladný alebo záporný počet minút, ktorý sa má pridať
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<aktualizovaná časová pečiatka> String Časová pečiatka plus zadaný počet minút

Príklad č. 1

Tento príklad pridá do zadanej časovej pečiatky 10 minút:

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 (pridaťsekundy)

Pridajte počet sekúnd do časovej pečiatky.

addSeconds('<timestamp>', <seconds>, '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<Sekúnd> Áno Integer Kladný alebo záporný počet sekúnd na pridanie
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<aktualizovaná časová pečiatka> String Časová pečiatka so zadaným počtom sekúnd

Príklad č. 1

Tento príklad pridá do zadanej časovej pečiatky 10 sekúnd:

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 odčí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 počet jednotiek času do časovej pečiatky. Pozrite si tiež článok getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<Interval> Áno Integer Počet zadaných časových jednotiek, ktoré sa majú pridať
<timeUnit (časová jednotka)> Áno String Jednotka času, ktorá sa má použiť s intervalom: "Sekunda", "Minúta", "Hodina", "Deň", "Týždeň", "Mesiac", "Rok"
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<aktualizovaná časová pečiatka> String Časová pečiatka plus zadaný počet časových jednotiek

Príklad č. 1

Tento príklad pridá jeden deň do zadanej časovej pečiatky:

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ň do zadanej časovej pečiatky:

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

A vráti výsledok s použitím voliteľného formátu D: "Tuesday, January 2, 2018"

a

Skontrolujte, či sú obidva výrazy pravdivé. Vráti hodnotu true, keď sú obidva výrazy pravdivé, alebo vráti hodnotu false, ak má aspoň jeden výraz hodnotu false.

and(<expression1>, <expression2>)
Parameter Požadovaný Zadať Description
<expression1>, <expression2> Áno Boolean Výrazy, ktoré sa majú skontrolovať
Vrátená hodnota Zadať Description
true alebo false Boolean Vráti hodnotu true, keď majú obidva výrazy hodnotu true. Ak aspoň jeden výraz je false, vráti sa hodnota false.

Príklad č. 1

Tieto príklady skontrolujú, či zadané booleovské hodnoty majú hodnotu true:

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

A vráti tieto výsledky:

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

Príklad č. 2

Tieto príklady kontrolujú, či zadané výrazy majú hodnotu true:

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 majú hodnotu true, takže vráti hodnotu true.
  • Druhý príklad: Jeden výraz je nepravdivý, takže vráti hodnotu false.
  • Tretí príklad: Oba výrazy sú false, takže vráti hodnotu false.

Pole

Vráti pole z jedného zadaného vstupu. Viacero vstupov nájdete v téme createArray().

array('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec na vytvorenie poľa
Vrátená hodnota Zadať Description
[<hodnota>] Pole Pole, ktoré obsahuje jeden zadaný vstup

Príklad

V tomto príklade sa vytvorí pole z reťazca "hello":

array('hello')

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

base64

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

base64('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Vstupný reťazec
Vrátená hodnota Zadať Description
<reťazec base64> String Verzia s kódovaním base64 pre vstupný reťazec

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áti binárnu verziu reťazca s kódovaním base64.

base64ToBinary('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec s kódovaním base64 na konverziu
Vrátená hodnota Zadať Description
<binary-for-base64-string> String Binárna verzia reťazca s kódovaním base64

Príklad

Tento príklad konvertuje reťazec base64-encoded "aGVsbG8=" 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 a efektívne dekódujte reťazec base64. Túto funkciu použite namiesto dekódovaniaBase64(). Napriek tomu, že obe funkcie fungujú rovnakým spôsobom, base64ToString() uprednostňuje sa funkcia.

base64ToString('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec s kódovaním base64 na dekódovanie
Vrátená hodnota Zadať Description
<decoded-base64-string> String Verzia reťazca pre reťazec s kódovaním base64

Príklad

Tento príklad konvertuje reťazec base64-encoded "aGVsbG8=" iba na reťazec:

base64ToString('aGVsbG8=')

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

Binárne

Vráti binárnu verziu reťazca.

binary('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec, ktorý sa má previesť
Vrátená hodnota Zadať Description
<binary-for-input-value> String Binárna verzia zadaného reťazca

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átiť booleovskú verziu hodnoty.

bool(<value>)
Parameter Požadovaný Zadať Description
<Hodnota> Áno Ľubovoľný Hodnota na konverziu
Vrátená hodnota Zadať Description
true alebo false Boolean Booleovská verzia zadanej hodnoty

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

Splynúť

Vráťte prvú hodnotu bez hodnoty null 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 Požadovaný Zadať Description
<>object_1,< object_2>... Áno Ľubovoľné typy, možno kombinovať Jedna alebo viac položiek na kontrolu hodnoty null
Vrátená hodnota Zadať Description
<first-non-null-item> Ľubovoľný Prvá položka alebo hodnota, ktorá nemá hodnotu null. Ak majú všetky parametre hodnotu 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, keď 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 viacero reťazcov a vráťte kombinovaný reťazec.

concat('<text1>', '<text2>', ...)
Parameter Požadovaný Zadať Description
<text1>, <text2>, ... Áno String Aspoň dva reťazce, ktoré sa majú skombinovať
Vrátená hodnota Zadať Description
<text1text2...> String Reťazec vytvorený z kombinovaných vstupných reťazcov

Príklad

V tomto príklade sa skombinujú 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, keď sa nenájde. Táto funkcia rozlišuje malé a veľké písmená.

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

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

  • Reťazec, ktorý sa má vyhľadať podreťazec
  • Pole na vyhľadanie hodnoty
  • Slovník na vyhľadanie kľúča
Parameter Požadovaný Zadať Description
<Kolekcia> Áno Reťazec, Pole alebo Slovník Kolekcia na kontrolu
<Hodnota> Áno String, Array, alebo Dictionary, resp. Dictionary Položka, ktorá sa má vyhľadať
Vrátená hodnota Zadať Description
true alebo false Boolean Vrátenie hodnoty true pri nájdení položky. Ak sa nenájde, vráti sa hodnota false.

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 "vesmír" a vráti hodnotu false:

contains('hello world', 'universe')

convertFromUtc

Konvertujte časovú pečiatku z koordinovaného svetového času (UTC) na cieľové časové pásmo.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<destinationTimeZone> Áno String Názov cieľového časového pásma. Informácie o názvoch časových pásem nájdete v téme Hodnoty časového pásma spoločnosti Microsoft, ale z názvu časového pásma možno budete musieť odstrániť všetky interpunkcie.
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<konvertovaná časová pečiatka> String Časová pečiatka skonvertovaná na cieľové časové pásmo

Príklad č. 1

Tento príklad konvertuje č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 konvertuje č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 (konvertovať časové pásmo)

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

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<sourceTimeZone> Áno String Názov časového pásma zdroja. Informácie o názvoch časových pásem nájdete v téme Hodnoty časového pásma spoločnosti Microsoft, ale z názvu časového pásma možno budete musieť odstrániť všetky interpunkcie.
<destinationTimeZone> Áno String Názov cieľového časového pásma. Informácie o názvoch časových pásem nájdete v téme Hodnoty časového pásma spoločnosti Microsoft, ale z názvu časového pásma možno budete musieť odstrániť všetky interpunkcie.
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<konvertovaná časová pečiatka> String Časová pečiatka skonvertovaná na cieľové časové pásmo

Príklad č. 1

Tento príklad konvertuje 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

Tento príklad konvertuje časové pásmo 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 koordinovaný svetový čas (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<sourceTimeZone> Áno String Názov časového pásma zdroja. Informácie o názvoch časových pásem nájdete v téme Hodnoty časového pásma spoločnosti Microsoft, ale z názvu časového pásma možno budete musieť odstrániť všetky interpunkcie.
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<konvertovaná časová pečiatka> String Č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 (vytvoriť Zmätok)

Vráti pole z viacerých vstupov. Informácie o jednotlivých vstupných poliach nájdete v téme pole().

createArray('<object1>', '<object2>', ...)
Parameter Požadovaný Zadať Description
<object1>, <object2>, ... Áno Ľubovoľné, ale nie zmiešané Na vytvorenie poľa aspoň dve položky.
Vrátená hodnota Zadať 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áti identifikátor URI (data uniform resource identifier) pre reťazec.

dataUri('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec, ktorý sa má previesť
Vrátená hodnota Zadať Description
<data-uri> String Identifikátor URI údajov pre vstupný reťazec

Príklad

V tomto príklade sa 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 identifikátora URI .data uniform resource identifier (URI). Použite túto funkciu namiesto dekódovaniaDataUri(). Napriek tomu, že obe funkcie fungujú rovnakým spôsobom, dataUriBinary() uprednostňuje sa funkcia.

dataUriToBinary('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Identifikátor URI údajov na konverziu
Vrátená hodnota Zadať Description
<binary-for-data-uri> String Binárna verzia identifikátora URI údajov

Príklad

V tomto príklade sa pre tento identifikátor URI údajov vytvorí binárna verzia:

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

A vráti tento výsledok:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Vrátiť verziu reťazca pre identifikátor URI (uniform resource identifier, URI).

dataUriToString('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Identifikátor URI údajov na konverziu
Vrátená hodnota Zadať Description
<string-for-data-uri> String 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 (deňVMesiac)

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

dayOfMonth('<timestamp>')
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
Vrátená hodnota Zadať Description
<deň v mesiaci> Integer Deň v mesiaci zo 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átiť deň v týždni z časovej pečiatky.

dayOfWeek('<timestamp>')
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
Vrátená hodnota Zadať Description
<deň v týždni> Integer Deň v týždni zo zadanej časovej pečiatky, kde nedeľa je 0, pondelok je 1 a tak ďalej

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

dayOfYear

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

dayOfYear('<timestamp>')
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
Vrátená hodnota Zadať Description
<deň v roku> Integer Deň v roku zo zadanej časovej pečiatky

Príklad

Tento príklad vráti počet dní 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 a efektívne dekódujte reťazec base64. Zvážte použitie funkcie base64ToString() namiesto decodeBase64(). Napriek tomu, že obe funkcie fungujú rovnakým spôsobom, base64ToString() uprednostňuje sa funkcia.

decodeBase64('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec s kódovaním base64 na dekódovanie
Vrátená hodnota Zadať Description
<decoded-base64-string> String 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 identifikátora URI .data uniform resource identifier (URI). Zvážte použitie parametra dataUriToBinary(), nie decodeDataUri(). Napriek tomu, že obe funkcie fungujú rovnakým spôsobom, dataUriToBinary() uprednostňuje sa funkcia.

decodeDataUri('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec URI údajov na dekódovanie
Vrátená hodnota Zadať Description
<binary-for-data-uri> String Binárna verzia reťazca identifikátora URI údajov

Príklad

V tomto príklade sa vráti binárna verzia tohto identifikátora URI s údajmi:

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í koncové znaky dekódovanými verziami.

decodeUriComponent('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec s únikovými znakmi na dekódovanie
Vrátená hodnota Zadať Description
<decoded-uri> String Aktualizovaný reťazec s dekódovanými escape znakmi

Príklad

Tento príklad nahradí koncové znaky 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áti celočíselný výsledok delenia dvoch čísel. Ak chcete získať zvyšok výsledku, pozrite si mod().

div(<dividend>, <divisor>)
Parameter Požadovaný Zadať Description
<Dividendy> Áno Celé číslo alebo pohyblivá pohyblivá čiarka Číslo, ktoré sa má deliť deliteľom
<Deliteľ> Áno Celé číslo alebo pohyblivá pohyblivá čiarka Číslo, ktoré delí dividendu, ale nemôže byť 0
Vrátená hodnota Zadať Description
<quotient-result> Integer Výsledok celého čísla vydelený prvým číslom druhým číslom

Príklad

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

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

A vráťte tento výsledok: 2

encodeUriComponent

Vráťte verziu reťazca s kódovaným identifikátorom URI, ktorý je zakódovaný, nahradením nebezpečných znakov URL adries escape znakmi. Namiesto funkcie zvážte použitie funkcie uriComponent().encodeUriComponent() Napriek tomu, že obe funkcie fungujú rovnakým spôsobom, uriComponent() uprednostňuje sa funkcia.

encodeUriComponent('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec, ktorý sa má previesť na formát kódovaný identifikátorom URI
Vrátená hodnota Zadať Description
<encoded-uri> String Reťazec kódovaný URI s koncovými znakmi

Príklad

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

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

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

Prázdne

Skontrolujte, či je kolekcia prázdna. Keď je kolekcia prázdna, vráti sa hodnota true, ak kolekcia nie je prázdna, vráti sa hodnota false.

empty('<collection>')
empty([<collection>])
Parameter Požadovaný Zadať Description
<Kolekcia> Áno Reťazec, Pole alebo Objekt Kolekcia na kontrolu
Vrátená hodnota Zadať Description
true alebo false Boolean Keď je kolekcia prázdna, vráti sa hodnota true. Ak nie je prázdna, vráťte hodnotu false.

Príklad

Tieto príklady skontrolujú, č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 truehodnotu .
  • Druhý príklad: Odovzdá reťazec "abc", takže funkcia vráti falsehodnotu .

endsWith

Skontrolujte, či reťazec končí konkrétnym podreťazecom. Vrátenie hodnoty true, keď sa podreťazce nájde, alebo vrátenie hodnoty false, keď sa nenájde. Táto funkcia nerozlišuje malé a veľké písmená.

endsWith('<text>', '<searchText>')
Parameter Požadovaný Zadať Description
<text> Áno String Reťazec, ktorý sa má skontrolovať
<searchText> Áno String Koncový podreťazc, ktorý sa má vyhľadať
Vrátená hodnota Zadať Description
true alebo false Boolean Keď sa nájde koncový podreťazc, vráti sa hodnota true. Ak sa nenájde, vráti sa hodnota false.

Príklad č. 1

Tento príklad skontroluje, č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 skontroluje, či reťazec "hello world" končí reťazcom "universe":

endsWith('hello world', 'universe')

A vráti tento výsledok: false

rovná sa

Skontrolujte, či sú obe hodnoty, výrazy alebo objekty ekvivalentné. Vráti hodnotu true, keď sú obe rovnocenné, alebo vráti hodnotu false, ak nie sú ekvivalentné.

equals('<object1>', '<object2>')
Parameter Požadovaný Zadať Description
<object1>, <object2> Áno Rôzne Hodnoty, výrazy alebo objekty, ktoré sa majú porovnať
Vrátená hodnota Zadať Description
true alebo false Boolean Keď sú oba rovnocenné, vráti sa hodnota true. Ak hodnota nie je ekvivalentná, vráti hodnotu false.

Príklad

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

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

A vráti tieto výsledky:

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

1\.

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

first('<collection>')
first([<collection>])
Parameter Požadovaný Zadať Description
<Kolekcia> Áno Reťazec alebo Pole Kolekcia, kde nájdete prvú položku
Vrátená hodnota Zadať Description
<first-collection-item> Ľubovoľný Prvá položka v kolekcii

Príklad

Prvé položky v týchto kolekciách nájdete v týchto príkladoch:

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

A vráťte tieto výsledky:

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

Plavák

Konverzia verzie reťazca pre číslo s pohyblivou rádovou čiarkou na skutočné číslo s pohyblivou desatinnou čiarkou.

float('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec s platným číslom s pohyblivou rádovou čiarkou na konverziu
Vrátená hodnota Zadať Description
<Pohyblivá desatinná hodnota> Float Číslo s pohyblivou desatinnou čiarkou pre zadaný reťazec

Príklad

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

float('10.333')

A vráti tento výsledok: 10.333

formatDateTime

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

formatDateTime('<timestamp>', '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<reformovaná časová pečiatka> String Aktualizovaná časová pečiatka v zadanom formáte

Príklad

Tento príklad konvertuje č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áti aktuálnu časovú pečiatku a zadané časové jednotky.

getFutureTime(<interval>, <timeUnit>, <format>?)
Parameter Požadovaný Zadať Description
<Interval> Áno Integer Počet zadaných časových jednotiek, ktoré sa majú pridať
<timeUnit (časová jednotka)> Áno String Jednotka času, ktorá sa má použiť s intervalom: "Sekunda", "Minúta", "Hodina", "Deň", "Týždeň", "Mesiac", "Rok"
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<aktualizovaná časová pečiatka> String 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.000000Z". Tento príklad pridá do tejto časovej pečiatky päť dní:

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.000000Z". Tento príklad pridá päť dní a skonvertuje výsledok na formát D:

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

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

getPastTime

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

getPastTime(<interval>, <timeUnit>, <format>?)
Parameter Požadovaný Zadať Description
<Interval> Áno Integer Počet zadaných časových jednotiek, ktoré sa majú odčítať
<timeUnit (časová jednotka)> Áno String Jednotka času, ktorá sa má použiť s intervalom: "Sekunda", "Minúta", "Hodina", "Deň", "Týždeň", "Mesiac", "Rok"
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<aktualizovaná časová pečiatka> String 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.000000Z". Tento príklad od tejto časovej pečiatky odčí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.000000Z". Tento príklad odčíta päť dní a skonvertuje výsledok na formát "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. Keď je prvá hodnota väčšia, vráti sa hodnota True alebo vráti hodnotu false, keď je menšia.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno Celé číslo, číslo s pohyblivou pohyblivou čiarku alebo reťazec. Prvá hodnota, ktorá skontroluje, či je väčšia ako druhá hodnota
<compareTo (porovnať)> Áno Celé číslo, číslo s pohyblivou pohyblivou čiarku alebo reťazec, resp. reťazec. Porovnávacia hodnota
Vrátená hodnota Zadať Description
true alebo false Boolean Vráti hodnotu True, keď je prvá hodnota väčšia ako druhá hodnota. Vráti hodnotu false, keď sa prvá hodnota rovná alebo menšia ako druhá hodnota.

Príklad

Tieto príklady skontrolujú, č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

greaterOrEquals

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

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno Celé číslo, číslo s pohyblivou pohyblivou čiarku alebo reťazec. Prvá hodnota, ktorá skontroluje, či je väčšia alebo rovná druhej hodnote
<compareTo (porovnať)> Áno Celé číslo, číslo s pohyblivou pohyblivou čiarku alebo reťazec, resp. reťazec. Porovnávacia hodnota
Vrátená hodnota Zadať Description
true alebo false Boolean Vráti hodnotu TRUE, keď je prvá hodnota väčšia alebo rovná druhej hodnote. Ak je prvá hodnota menšia ako druhá hodnota, vráti hodnotu False.

Príklad

Tieto príklady skontrolujú, č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

Identifikátor guid

Generovanie globálne jedinečného identifikátora (GUID) ako reťazca, napríklad "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

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

guid('<format>')
Parameter Požadovaný Zadať Opis
<Formát> Nie String Špecifikácia 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 Zadať Description
<Hodnota GUID> String Náhodne generovaný identifikátor GUID

Príklad

V tomto príklade sa 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 Požadovaný Zadať Description
<Výraz> Áno Boolean Výraz, ktorý sa má skontrolovať
<valueIfTrue> Áno Ľubovoľný Hodnota, ktorá sa má vrátiť, keď je výraz pravdivý
<valueIfFalse> Áno Ľubovoľný Hodnota, ktorá sa má vrátiť, keď je výraz false
Vrátená hodnota Zadať Description
<specified-return-value> Ľubovoľný Zadaná hodnota, ktorá vráti hodnotu na základe toho, či je výraz true alebo false

Príklad

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

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

indexOf

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

indexOf('<text>', '<searchText>')
Parameter Požadovaný Zadať Description
<text> Áno String Reťazec, ktorý má podreťazec, ktorý sa má vyhľadať
<searchText> Áno String Podreťazok, ktorý sa má vyhľadať
Vrátená hodnota Zadať Description
<index-value> Integer Počiatočná pozícia alebo hodnota indexu pre zadaný podreťazc.
Ak sa reťazec nenájde, vráťte číslo –1.

Príklad

Tento príklad nájde počiatočnú hodnotu indexu pre podreťazec "world" v reťazci "hello world":

indexOf('hello world', 'world')

A vráti tento výsledok: 6

Int

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

int('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec, ktorý sa má previesť
Vrátená hodnota Zadať Description
<integer-result> Integer Celočíselná verzia zadaného reťazca

Príklad

V tomto príklade sa vytvorí celočíselná verzia reťazca 10:

int('10')

A vráti tento výsledok: 10

json

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

json('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno Reťazec alebo XML Reťazec alebo XML, ktoré sa majú konvertovať
Vrátená hodnota Zadať Description
<Výsledok JSON> Natívny typ JSON alebo objekt 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 konvertuje 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 konvertuje tento reťazec na formát JSON:

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

A vráti tento výsledok:

{
  "fullName": "Sophia Owen"
}

Príklad č. 3

Tento príklad konvertuje tento XML na formát 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"
      } ]
   }
}

Križovatke

Vráti kolekciu, ktorá obsahuje iba bežné položky v zadaných kolekciách. Ak sa má zobraziť vo výsledku, položka sa musí zobraziť 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 Požadovaný Zadať Description
<collection1>, <collection2>, ... Áno Pole alebo Objekt, ale nie obe Kolekcie, z ktorých chcete mať len bežné položky
Vrátená hodnota Zadať Description
<common-items> Pole alebo Objekt, resp. Kolekcia, ktorá obsahuje iba bežné položky v zadaných kolekciách

Príklad

V tomto príklade nájdete bežné položky v rámci týchto polí:

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

Vráti pole len s týmito položkami:[1, 2]

spojiť

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

join([<collection>], '<delimiter>')
Parameter Požadovaný Zadať Description
<Kolekcia> Áno Pole Pole s položkami, ktoré sa majú pripojiť
<Oddeľovač> Áno String Oddeľovač, ktorý sa zobrazuje medzi jednotlivými znakmi vo výslednom reťazci
Vrátená hodnota Zadať Description
<oddeľovač><char1><char2...><> String 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č:

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

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

posledné

Vráti poslednú položku z kolekcie.

last('<collection>')
last([<collection>])
Parameter Požadovaný Zadať Description
<Kolekcia> Áno Reťazec alebo Pole Kolekcia, v ktorej sa má vyhľadať posledná položka
Vrátená hodnota Zadať Description
<last-collection-item> Reťazec alebo Pole, resp. Posledná položka v kolekcii

Príklad

Poslednú položku v týchto kolekciách nájdete v týchto príkladoch:

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

A vráti tieto výsledky:

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

lastIndexOf

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

lastIndexOf('<text>', '<searchText>')
Parameter Požadovaný Zadať Description
<text> Áno String Reťazec, ktorý má podreťazec, ktorý sa má vyhľadať
<searchText> Áno String Podreťazok, ktorý sa má vyhľadať
Vrátená hodnota Zadať Description
<koncová hodnota-index-value> Integer 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

Tento príklad nájde počiatočnú hodnotu 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áti počet položiek v kolekcii.

length('<collection>')
length([<collection>])
Parameter Požadovaný Zadať Description
<Kolekcia> Áno Reťazec alebo Pole Kolekcia s položkami, ktoré sa majú spočítať
Vrátená hodnota Zadať Description
<length-or-count (dĺžka alebo počet)> Integer Počet položiek v kolekcii

Príklad

V týchto príkladoch sa počíta 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. Keď je prvá hodnota menšia, vráti sa hodnota True alebo vráti hodnotu false, keď je prvá hodnota väčšia.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno Celé číslo, číslo s pohyblivou pohyblivou čiarku alebo reťazec. Prvá hodnota na kontrolu toho, či je menšia ako druhá hodnota
<compareTo (porovnať)> Áno Celé číslo, číslo s pohyblivou pohyblivou čiarku alebo reťazec, resp. reťazec. Porovnávacia položka
Vrátená hodnota Zadať Description
true alebo false Boolean Vráti hodnotu True, keď je prvá hodnota menšia ako druhá hodnota. Vráti hodnotu false, keď sa prvá hodnota rovná alebo väčšia ako druhá hodnota.

Príklad

Tieto príklady skontrolujú, č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 (menšieOrRovná sa)

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

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno Celé číslo, číslo s pohyblivou pohyblivou čiarku alebo reťazec. Prvá hodnota, ktorá skontroluje, či je menšia alebo rovná druhej hodnote
<compareTo (porovnať)> Áno Celé číslo, číslo s pohyblivou pohyblivou čiarku alebo reťazec, resp. reťazec. Porovnávacia položka
Vrátená hodnota Zadať Description
true alebo false Boolean Vráti hodnotu TRUE, keď je prvá hodnota menšia alebo rovná druhej hodnote. Ak je prvá hodnota väčšia ako druhá hodnota, vráti hodnotu False.

Príklad

Tieto príklady skontrolujú, č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áti najvyššiu hodnotu zo zoznamu alebo poľa s číslami, ktoré sú inkluzívne na oboch koncoch.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parameter Požadovaný Zadať Description
<number1>, <number2>, ... Áno Celé číslo, číslo s pohyblivou pohyblivou čiarku alebo oboje Množina čísel, z ktorých chcete vytvoriť najvyššiu hodnotu
[<číslo1>, <číslo 2>, ...] Áno Pole – celé číslo, číslo s pohyblivou pohyblivou čiarku alebo oboje Pole čísel, z ktorých chcete mať najvyššiu hodnotu
Vrátená hodnota Zadať Description
<maximálna hodnota> Celé číslo alebo pohyblivá pohyblivá čiarka Najvyššia hodnota v zadanom poli alebo množina čísel

Príklad

Tieto príklady načítať 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átenie najnižšej hodnoty z množiny čísel alebo poľa.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parameter Požadovaný Zadať Description
<number1>, <number2>, ... Áno Celé číslo, číslo s pohyblivou pohyblivou čiarku alebo oboje Množina čísel, z ktorých sa má vypočítať najnižšia hodnota
[<číslo1>, <číslo 2>, ...] Áno Pole – celé číslo, číslo s pohyblivou pohyblivou čiarku alebo oboje Pole čísel, z ktorého chcete vytvoriť najnižšiu hodnotu
Vrátená hodnota Zadať Description
<min-value> Celé číslo alebo pohyblivá pohyblivá čiarka Najnižšia hodnota v zadanej množine čísel alebo zadanom poli

Príklad

V týchto príkladoch sa načíta najnižšia hodnota v množine čísel a v poli:

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

A vráťte tento výsledok: 1

Mod

Vráti zvyšok po delení dvoch čísel. Ak chcete získať výsledok celého čísla, pozrite si článok div().

mod(<dividend>, <divisor>)
Parameter Požadovaný Zadať Description
<Dividendy> Áno Celé číslo alebo pohyblivá pohyblivá čiarka Číslo, ktoré sa má deliť deliteľom
<Deliteľ> Áno Celé číslo alebo pohyblivá pohyblivá čiarka Číslo, ktoré delí dividendu, ale nemôže byť 0.
Vrátená hodnota Zadať Description
<modulo-result> Celé číslo alebo pohyblivá pohyblivá čiarka Zvyšok od delenia 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áti produkt z vynásobenia dvoch čísel.

mul(<multiplicand1>, <multiplicand2>)
Parameter Požadovaný Zadať Description
<násobkom znaku1> Áno Celé číslo alebo pohyblivá pohyblivá čiarka Číslo, ktoré sa má vynásobiť násobením a2
<násobkom2> Áno Celé číslo alebo pohyblivá pohyblivá čiarka Číslo, ktoré násobí násobok a1
Vrátená hodnota Zadať Description
<product-result (produkt – výsledok)> Celé číslo alebo pohyblivá pohyblivá čiarka Súčin vynásobenia 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ý. Keď je výraz false, vráťte hodnotu true alebo vráťte hodnotu false, keď je hodnota True.

not(<expression>)
Parameter Požadovaný Zadať Description
<Výraz> Áno Boolean Výraz, ktorý sa má skontrolovať
Vrátená hodnota Zadať Description
true alebo false Boolean Vráti hodnotu true, keď je výraz false. Vráťte hodnotu false, keď má výraz hodnotu true.

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 truehodnotu .
  • Druhý príklad: Výraz je true, takže funkcia vráti falsehodnotu .

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 truehodnotu .
  • Druhý príklad: Výraz je true, takže funkcia vráti falsehodnotu .

or

Skontrolujte, či je aspoň jeden výraz pravdivý. Vráťte hodnotu true, keď má aspoň jeden výraz hodnotu true, alebo vráťte hodnotu false, keď sú obidva výrazy false.

or(<expression1>, <expression2>)
Parameter Požadovaný Zadať Description
<expression1>, <expression2> Áno Boolean Výrazy, ktoré sa majú skontrolovať
Vrátená hodnota Zadať Description
true alebo false Boolean Vráti hodnotu true, keď aspoň jeden výraz je true. Ak sú obidva výrazy false, vráti sa hodnota false.

Príklad č. 1

Tieto príklady skontrolujú, č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 true, takže funkcia vráti hodnotu true.
  • Druhý príklad: Oba výrazy sú false, takže funkcia vráti falsehodnotu .

Príklad č. 2

Tieto príklady skontrolujú, č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 true, takže funkcia vráti hodnotu true.
  • Druhý príklad: Oba výrazy sú false, takže funkcia vráti falsehodnotu .

Rand

Vráti náhodné celé číslo zo zadaného rozsahu, ktoré je inkluzívne iba na počiatočnom konci.

rand(<minValue>, <maxValue>)
Parameter Požadovaný Zadať Description
<hodnota minValue> Áno Integer Najnižšie celé číslo v rozsahu
<hodnota maxValue> Áno Integer Celé číslo, ktoré nasleduje za najvyšším celým číslom v rozsahu, ktorý môže funkcia vrátiť.
Vrátená hodnota Zadať Description
<náhodný výsledok> Integer 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 okrem maximálnej hodnoty:

rand(1, 5)

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

Rozsah

Vráti celočíselné pole, ktoré sa začína zo zadaného celého čísla.

range(<startIndex>, <count>)
Parameter Požadovaný Zadať Description
<startIndex> Áno Integer Celočíselná hodnota, ktorá začína pole ako prvá položka
<Počítať> Áno Integer Počet celých čísel v poli
Vrátená hodnota Zadať Description
[<výsledok rozsahu>] Pole Pole s celými číslami začínajúcimi zo zadaného indexu

Príklad

Tento príklad vytvorí celé pole, ktoré začína zo 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. Táto funkcia rozlišuje malé a veľké písmená.

replace('<text>', '<oldText>', '<newText>')
Parameter Požadovaný Zadať Description
<text> Áno String Reťazec, ktorý má podreťazec, ktorý sa má nahradiť
<oldText> Áno String Podreťazok, ktorý sa má nahradiť
<newText> Áno String Náhradný reťazec
Vrátená hodnota Zadať Description
<aktualizovaný text> String Aktualizovaný reťazec po nahradení podreťazca
Ak sa podreťazec nenájde, vráťte pôvodný reťazec.

Príklad

V tomto príklade nájde "starý" podreťazec v starom reťazci a nahradí "starý" reťazcom "nový":

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

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

preskočiť

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

skip([<collection>], <count>)
Parameter Požadovaný Zadať Description
<Kolekcia> Áno Pole Kolekcia, ktorej položky chcete odstrániť
<Počítať> Áno Integer Kladné celé číslo pre počet položiek, ktoré sa majú odstrániť na prednom mieste
Vrátená hodnota Zadať Description
[<aktualizovaná kolekcia>] Pole Aktualizovaná kolekcia po odstránení zadaných položiek

Príklad

Tento príklad odstráni jednu položku, čí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áťte pole, ktoré obsahuje podreťazce oddelené čiarkami, na základe zadaného znaku oddeľovača v pôvodnom reťazci.

split('<text>', '<delimiter>')
Parameter Požadovaný Zadať Description
<text> Áno String Reťazec, ktorý sa má rozdeliť do podreťazcov na základe stanoveného oddeľovača v pôvodnom reťazci
<Oddeľovač> Áno String Znak v pôvodnom reťazci, ktorý sa má použiť ako oddeľovač
Vrátená hodnota Zadať Description
[<podreťazce1>,< podreťazce2>,...] Pole Pole, ktoré obsahuje podreťazce z pôvodného reťazca oddelené čiarkami

Príklad

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

split('a_b_c', '_')

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

startOfDay

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

startOfDay('<timestamp>', '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<aktualizovaná časová pečiatka> String Zadaná časová pečiatka, ale začínajúc od nuly hodiny pre deň

Príklad

Tento príklad 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"

startOfHour

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

startOfHour('<timestamp>', '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<aktualizovaná časová pečiatka> String Zadaná časová pečiatka, ktorá však začína znamienkom nuly 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"

startOfMonth (začiatokMesiac)

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

startOfMonth('<timestamp>', '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<aktualizovaná časová pečiatka> String Zadaná časová pečiatka, ale začínajúc prvým dňom v mesiaci s označením nulovej 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"

startsWith

Skontrolujte, či reťazec začína konkrétnym podreťazecom. Vrátenie hodnoty true, keď sa podreťazce nájde, alebo vrátenie hodnoty false, keď sa nenájde. Táto funkcia nerozlišuje malé a veľké písmená.

startsWith('<text>', '<searchText>')
Parameter Požadovaný Zadať Description
<text> Áno String Reťazec, ktorý sa má skontrolovať
<searchText> Áno String Počiatočný reťazec, ktorý sa má vyhľadať
Vrátená hodnota Zadať Description
true alebo false Boolean Keď sa nájde počiatočný podreťazc, vráti sa hodnota true. Ak sa nenájde, vráti sa hodnota false.

Príklad č. 1

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

startsWith('hello world', 'hello')

A vráti tento výsledok: true

Príklad č. 2

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

startsWith('hello world', 'greetings')

A vráti tento výsledok: false

povrázok

Vrátenie verzie reťazca pre hodnotu.

string(<value>)
Parameter Požadovaný Zadať Description
<Hodnota> Áno Ľubovoľný Hodnota na konverziu
Vrátená hodnota Zadať Description
<string-value> String 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

Tento príklad vytvorí reťazec pre zadaný objekt JSON a použije znak opačnej lomky (\) ako koncový znak dvojitej úvodzovky (").

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

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

sub

Vráti výsledok od odpočítania druhého čísla od prvého čísla.

sub(<minuend>, <subtrahend>)
Parameter Požadovaný Zadať Description
<minuend> Áno Celé číslo alebo pohyblivá pohyblivá čiarka Číslo, od ktorého sa má odčítať odčítanie
<Menšitel> Áno Celé číslo alebo pohyblivá pohyblivá čiarka Číslo, ktoré sa má odpočítať od minuendu
Vrátená hodnota Zadať Description
<Výsledok> Celé číslo alebo pohyblivá pohyblivá čiarka Výsledok od odpočítania druhého čísla od prvého čísla

Príklad

Tento príklad odčíta druhé číslo od prvého čísla:

sub(10.3, .3)

A vráti tento výsledok: 10

Podreťazec

Vráti znaky z reťazca, počnúc zo zadanej pozície alebo indexu. Hodnoty indexu začínajú číslom 0.

substring('<text>', <startIndex>, <length>)
Parameter Požadovaný Zadať Description
<text> Áno String Reťazec, ktorého znaky sa majú zobraziť
<startIndex> Áno Integer Kladné číslo rovné alebo väčšie ako 0, ktoré chcete použiť ako počiatočnú pozíciu alebo hodnotu indexu
<Dĺžka> Áno Integer Kladný počet znakov, ktoré chcete mať v podreťazci
Vrátená hodnota Zadať Description
<výsledok podreťazca> String Podreťazec so zadaným počtom znakov, počnúc zadanou indexovanou pozíciou 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"

subtractFromTime

Od časovej pečiatky odčítajte počet jednotiek času. Pozrite si tiež tému getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec, ktorý obsahuje časovú pečiatku
<Interval> Áno Integer Počet zadaných časových jednotiek, ktoré sa majú odčítať
<timeUnit (časová jednotka)> Áno String Jednotka času, ktorá sa má použiť s intervalom: "Sekunda", "Minúta", "Hodina", "Deň", "Týždeň", "Mesiac", "Rok"
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<aktualizovaná časová pečiatka> String Časová pečiatka mínus zadaný počet časových jednotiek

Príklad č. 1

Tento príklad odčí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 odčíta jeden deň od tejto časovej pečiatky:

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

Tento výsledok vráti s použitím voliteľného formátu D: "Monday, January, 1, 2018"

prijať

Vrátiť položky z prednej časti kolekcie.

take('<collection>', <count>)
take([<collection>], <count>)
Parameter Požadovaný Zadať Description
<Kolekcia> Áno Reťazec alebo Pole Kolekcia, ktorej položky chcete
<Počítať> Áno Integer Kladné celé číslo pre počet položiek, ktoré chcete spredu
Vrátená hodnota Zadať Description
<podmnožinu alebo [<podmnožinu>]> Reťazec alebo Pole, resp. Reťazec alebo pole so zadaným počtom položiek prevzatých z prednej časti pôvodnej kolekcie

Príklad

Tieto príklady získajú zadaný počet položiek spred 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

ticks Vrátenie hodnoty vlastnosti pre zadanú časovú pečiatku. Interval intervalu je 100-nanosekundový.

ticks('<timestamp>')
Parameter Požadovaný Zadať Description
<Časových pečiatok> Áno String Reťazec časovej pečiatky
Vrátená hodnota Zadať Description
<ticks-number> Integer Počet impulzov, ktoré uplynuli od 12:00:00 polnoci, 1. januára 0001 v gregoriánskom kalendári od vstupnej časovej pečiatky

toLower (Sledovať)

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

toLower('<text>')
Parameter Požadovaný Zadať Description
<text> Áno String Reťazec, ktorý sa má vrátiť vo formáte s malými písmenami
Vrátená hodnota Zadať Description
<text s malými písmenami> String Pôvodný reťazec vo formáte malými písmenami

Príklad

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

toLower('Hello World')

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

toUpper (večera)

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

toUpper('<text>')
Parameter Požadovaný Zadať Description
<text> Áno String Reťazec, ktorý sa má vrátiť vo formáte s veľkými písmenami
Vrátená hodnota Zadať Description
<text s veľkými písmenami> String Pôvodný reťazec vo formáte s veľkými písmenami

Príklad

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

toUpper('Hello World')

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

Trim

Odstráňte úvodný aj koncový prázdny znak z reťazca a vráťte aktualizovaný reťazec.

trim('<text>')
Parameter Požadovaný Zadať Description
<text> Áno String Reťazec, ktorý má úvodný a koncový prázdny znak na odstránenie
Vrátená hodnota Zadať Description
<updatedText> String Aktualizovaná verzia pôvodného reťazca bez úvodných alebo koncových prázdnych znakov

Príklad

Tento príklad odstráni úvodný a koncový prázdny znak z reťazca " Hello World ":

trim(' Hello World  ')

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

Únie

Vráťte kolekciu, ktorá obsahuje všetky položky zo zadaných kolekcií. Vo výsledku sa môže zobraziť položka 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 Požadovaný Zadať Description
<collection1>, <collection2>, ... Áno Pole alebo Objekt, ale nie obe Kolekcie, z ktorých chcete mať všetky položky
Vrátená hodnota Zadať Description
<updatedCollection> Pole alebo Objekt, resp. Kolekcia so všetkými položkami zo zadaných kolekcií – žiadne duplikáty

Príklad

V tomto príklade sa nastoľujú 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]

uriComponent

Vráťte verziu reťazca s kódovaným identifikátorom URI, ktorý je zakódovaný, nahradením nebezpečných znakov URL adries escape znakmi. Použite túto funkciu namiesto kódovaniaUriComponent(). Napriek tomu, že obe funkcie fungujú rovnakým spôsobom, uriComponent() uprednostňuje sa funkcia.

uriComponent('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec, ktorý sa má previesť na formát kódovaný identifikátorom URI
Vrátená hodnota Zadať Description
<encoded-uri> String Reťazec kódovaný URI s koncovými znakmi

Príklad

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

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

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

uriComponentToBinary

Vrátenie binárnej verzie súčasti identifikátora URI (uniform resource identifier).

uriComponentToBinary('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec kódovaný URI na konverziu
Vrátená hodnota Zadať Description
<binary-for-encoded-uri> String Binárna verzia reťazca kódovaného identifikátorom URI. Binárny obsah je kódovaný a vyjadrený kódovaním $content.

Príklad

Tento príklad vytvorí binárnu verziu tohto reťazca 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 reťazcom URI (uniform resource identifier, URI) a efektívne dekódujte reťazec kódovaný identifikátorom URI.

uriComponentToString('<value>')
Parameter Požadovaný Zadať Description
<Hodnota> Áno String Reťazec kódovaný URI na dekódovanie
Vrátená hodnota Zadať Description
<decoded-uri> String Dekódovaná verzia reťazca kódovaného identifikátorom URI

Príklad

Tento príklad vytvorí verziu dekódovaného reťazca pre tento reťazec kódovaný URI:

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

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

utcNow

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

utcNow('<format>')

Voliteľne môžete určiť iný formát pomocou parametra formátu<>.

Parameter Požadovaný Zadať Opis
<Formát> Nie String Buď špecifikátor jedného formátu, alebo vzor vlastného formátu. Predvolený formát časovej pečiatky je o (yyyy-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 Zadať Description
<aktuálna časová pečiatka> String Aktuálny dátum a čas

Príklad č. 1

Predpokladajme, že dnes je 15. apríl 2018 o 13:00:00. Aktuálny príklad načíta aktuálnu časovú pečiatku:

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 Požadovaný Zadať Description
<Hodnota> Áno String Reťazec s objektom JSON na konverziu
Objekt JSON musí mať iba jednu koreňovú vlastnosť, ktorá nemôže byť poľom.
Znak opačnej lomky (\) použite ako koncový znak dvojitej úvodzovky (").
Vrátená hodnota Zadať Description
<xml-version> Object Kó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 xml uzly alebo hodnoty, ktoré zodpovedajú výrazu XPath (XML Path Language), a vrátia zodpovedajúce uzly alebo hodnoty. Výraz XPath alebo len "XPath" vám pomôže prechádzať po štruktúre dokumentov XML, aby ste mohli vybrať uzly alebo vypočítať hodnoty v obsahu XML.

xpath('<xml>', '<xpath>')
Parameter Požadovaný Zadať Description
<Xml> Áno Ľubovoľný Reťazec XML na vyhľadávanie uzlov alebo hodnôt, ktoré zodpovedajú hodnote výrazu XPath
<Xpath> Áno Ľubovoľný Výraz XPath, ktorý sa používa na vyhľadanie zodpovedajúcich uzlov alebo hodnôt XML
Vrátená hodnota Zadať Description
<xml-node> XML Uzol XML, keď len jeden uzol zodpovedá zadanému výrazu XPath.
<Hodnota> Ľubovoľný Hodnota z uzla XML, keď sa iba jedna hodnota zhoduje so zadaným výrazom XPath.
[<xml-node1>, <xml-node2>, ...]
-or-
[<value1>, <value2>, ...]		 Pole Pole s uzlami XML alebo hodnotami, ktoré zodpovedajú zadanému výrazu XPath

Príklad č. 1

V nadväznosti na príklad 1 tento príklad nájde uzly, ktoré zodpovedajú <count></count> uzle, a pridá tieto hodnoty uzla s funkciou 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 vyhľadajú uzly, ktoré sa zhodujú s uzlom <location></location> , v zadaných argumentoch, ktoré zahŕňajú XML s priestorom názvov. Výrazy používajú znak opačnej lomky (\) ako koncový znak dvojitej úvodzovky (").

  • Výraz 1

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

  • Expression 2

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

Tu sú argumenty:

  • Tento XML súbor obsahuje priestor názvov dokumentu XML: xmlns="http://contoso.com"

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

  • Výraz XPath je tu:

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

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

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

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

Príklad č. 3

V nasledujúcom príklade 3 tento príklad nájde hodnotu v <location></location> uzli:

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

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

Poznámka

Je možné pridávať komentáre k výrazom toku údajov, nie však vo výrazoch kanála.

Súvisiaci obsah

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