Microsoft Fabricin Data Factoryn lausekkeet ja funktiot

Artikkeli
12/18/2024

Tässä artikkelissa on tietoja Microsoft Fabricin Data Factoryn tukemista lausekkeista ja funktioista.

Lausekkeet

Määrityksen lausekearvot voivat olla literaali tai lausekkeet, jotka lasketaan suorituksen aikana. Esimerkkejä:

"value"

"@pipeline().parameters.password"

Lausekkeet voivat esiintyä missä tahansa merkkijonoarvon kohdassa, ja ne aiheuttavat aina toisen merkkijonoarvon. Jos arvo on lauseke, lausekkeen leipäteksti poimitaan poistamalla at-sign (@). Jos literaalimerkkijono on pakollinen ja alkaa merkkijonolla @, se on poistettava käyttämällä @@-merkkiä. Seuraavissa esimerkeissä näytetään, miten lausekkeita arvioidaan.

Lausekkeen arvo	Result
"parametrit"	Merkit "parametrit" palautetaan.
"parameters[1]"	Merkit "parameters[1]" palautetaan.
"@@"	Yksi merkkimerkkijono, joka sisältää merkin @, palautetaan.
" @"	Palautetaan 2 merkkimerkkijono, jonka sisällä on merkki @.

Lausekkeet voivat myös näkyä merkkijonojen sisällä käyttäen ominaisuutta nimeltä merkkijonon interpolointi , jossa lausekkeet rivitetään :ssa @{ ... }. Esimerkki: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Merkkijonon interpoloinnin avulla tulos on aina merkkijono. Oletetaan, että olen määrittänyt tunnukseksi myNumber 42 ja myString muodossa foo:

Lausekkeen arvo	Result
"@pipeline().parameters.myString"	Palauttaa `foo` merkkijonona.
"@{pipeline().parameters.myString}"	Palauttaa `foo` merkkijonona.
"@pipeline().parameters.myNumber"	Palauttaa `42` lukuna.
"@{pipeline().parameters.myNumber}"	Palauttaa `42` merkkijonona.
"Vastaus on: @{pipeline().parameters.myNumber}"	Palauttaa merkkijonon `Answer is: 42`.
"@concat('Answer on: ', string(pipeline().parameters.myNumber))"	Palauttaa merkkijonon `Answer is: 42`
"Vastaus on: @@{pipeline().parameters.myNumber}"	Palauttaa merkkijonon `Answer is: @{pipeline().parameters.myNumber}`.

ForEach-aktiviteetin kaltaisissa ohjausobjektin työnkulun toiminnoissa voit antaa -matriisin ominaisuuskohteiden iteroimista varten ja iteroida @item() foreach-aktiviteetin yksittäisen luetteloinnin. Jos kohteet ovat esimerkiksi matriisi: [1, 2, 3], @item() palauttaa ensimmäisen iteraation 1, toisen iteraation 2 ja kolmannen iteraation 3. Like-lausekkeen avulla @range(0,10) voit myös iteroida kymmenen kertaa alkaen luvusta 0, joka päättyy arvoon 9.

Voit käyttää aktiviteetin tulostetta ja tehdä päätöksiä toiminnon nimen avulla @activity(. Harkitse web-aktiviteettia nimeltä Web1. Kun ensimmäisen aktiviteetin tulos sijoitetaan toisen aktiviteetin leipätekstiin, lauseke näyttää yleensä seuraavalta: @activity('Web1').output tai @activity('Web1').output.data tai jotain vastaavaa sen mukaan, miltä ensimmäisen toiminnon tulos näyttää.

Esimerkit

Esimerkki monimutkaisesta lausekkeesta

Alla olevassa esimerkissä näytetään monimutkainen esimerkki, joka viittaa toiminnan tulosten syvään alikenttään. Voit viitata putkiparametriin, joka antaa tulokseksi alikentän, käyttämällä toiminnon tulosteen osana []-syntaksia dot(.)-operaattorin sijaan (kuten alikenttien1 ja alikenttien 2 tapauksessa).

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

Tiedostojen luominen dynaamisesti ja niiden nimeäminen on yleinen malli. Tutustutaan muutamiin dynaamisten tiedostojen nimeämisesimerkkiin.

Liitä päivämäärä tiedostonimeen: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
Liitä päivämäärä ja aika asiakkaan aikavyöhykkeellä: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
Liitä käynnistinaika: @concat('Test_', pipeline().TriggerTime)
Tulosta mukautettu tiedostonimi Yhdistämismääritys-Tietovuo, kun tuloste on yksittäinen tiedosto, jossa on päivämäärä:'Test_' + toString(currentDate()) + '.csv'

Yllä olevassa tapauksessa luodaan neljä dynaamista tiedostonimeä alkaen Test_.

Dynaaminen sisältöeditori

Dynaaminen sisältöeditori ohittaa sisällön merkit automaattisesti, kun olet lopettanut muokkauksen. Esimerkiksi seuraava sisältö sisältöeditorissa on merkkijonon interpolointi lausekefunktiolla.

"@{toUpper('myData')}"

Dynaaminen sisältöeditori muuntaa sisällön yläpuolelle lausekkeen "@{toUpper('myData')}". Tämän lausekkeen tulos on alla oleva muotoiltu merkkijono.

"MYDATA"

Erikoismerkkien korvaaminen

Dynaaminen sisältöeditori ohittaa automaattisesti lainausmerkit, kuten lainausmerkit, kenoviivan sisällössä, kun muokkaus on valmis. Tästä aiheutuu ongelmia, jos haluat korvata rivinsyötön tai välilehden käyttämällä \n, \t in replace()-funktiota. Voit muokata dynaamista sisältöä koodinäkymässä ja poistaa ylimääräisen \ lausekkeesta, tai voit korvata erikoismerkit lausekekielellä alla annettujen ohjeiden mukaisesti:

URL-koodaus alkuperäisen merkkijonoarvon mukaan
Korvaa URL-koodattu merkkijono, esimerkiksi rivin syöte (%0A), rivinvaihto (%0D), vaakasuuntainen tab(%09).
URL-koodauksen koodaus

Esimerkiksi muuttuja companyName , jonka arvossa on newline-merkki, lauseke @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) voi poistaa uuden rivin merkin.

Contoso- Corporation

Ohjausmerkki heittomerkki

Lausekefunktiot käyttävät heittomerkkijonon arvoparametreja. Käytä kahta lainausmerkkiä merkkien pakenemiseen merkkijonofunktioissa ' . Esimerkiksi lauseke @concat('Baba', '''s ', 'book store') palauttaa tuloksen alla.

Baba's book store

Putken vaikutusalueen muuttujat

Näihin järjestelmämuuttujiin voidaan viitata missä tahansa putken kohdassa.

Muuttujan nimi	Kuvaus
@pipeline().DataFactory	Sen tiedon tai Synapse-työtilan nimi, jossa putki suoritetaan
@pipeline().Pipeline	Putken nimi
@pipeline().RunId	Tietyn jakson suorituksen tunnus
@pipeline().TriggerId	Putken käynnistämen käynnistimen tunnus
@pipeline().TriggerName	Putken käynnistämen käynnistimen nimi
@pipeline().TriggerTime	Putken käynnistämen käynnistimen suorituksen aika. Tämä on aika, jolloin käynnistin todella laukaistiin putken suorituksen kutsumiseksi, ja se saattaa poiketa hieman käynnistimen ajoitetusta ajasta.
@pipeline().GroupId	Sen ryhmän tunnus, johon jakson suoritus kuuluu.
@pipeline()?. TriggeredByPipelineName	Sen putken nimen, joka käynnistää putken suorituksen. Käytettävissä, kun ExecutePipeline-toiminto käynnistää putken suorituksen. Jos niitä käytetään muissa tilanteissa, laske arvoksi Null . Huomaa kysymysmerkki sen jälkeen @pipeline()
@pipeline()?. TriggeredByPipelineRunId	Suorita sen putken tunnus, joka käynnistää putken suorituksen. Käytettävissä, kun ExecutePipeline-toiminto käynnistää putken suorituksen. Jos niitä käytetään muissa tilanteissa, laske arvoksi Null . Huomaa kysymysmerkki sen jälkeen @pipeline()

Muistiinpano

Käynnistimeen liittyvät päivämäärä- ja aikajärjestelmämuuttujat (sekä putkissa että käynnistinlaajuissa) palauttavat UTC-päivämäärät ISO 8601 -muodossa, 2017-06-01T22:20:00.4061448Zesimerkiksi .

Funktiot

Voit kutsua funktioita lausekkeiden sisällä. Seuraavissa osissa on tietoja funktioista, joita voidaan käyttää lausekkeessa.

Päivämääräfunktiot

Päivämäärä- tai aikafunktio	Tehtävä
addDays	Lisää aikaleimaan päivien määrä.
lisää tunnit	Lisää aikaleimaan tuntimäärä.
addMinutes	Lisää aikaleimaan minuuttien määrä.
addSeconds	Lisää aikaleimaan sekuntien määrä.
addToTime	Lisää aikayksiköiden määrä aikaleimaan. Katso myös getFutureTime.
convertFromUtc	Muunna aikaleima UTC-aikavyöhykkeestä kohdeaikavyöhykkeeksi.
convertTimeZone	Muunna aikaleima lähdeaikavyöhykkeestä kohdeaikavyöhykkeeksi.
convertToUtc	Aikaleiman muuntaminen lähdeaikavyöhykkeestä UTC-ajaksi (Universal Time Coordinated).
dayOfMonth	Palauta kuukauden päivän osa aikaleimasta.
dayOfWeek	Palauta viikonpäiväosa aikaleimasta.
dayOfYear	Palauta vuoden päiväosa aikaleimasta.
formatDateTime	Palauta aikaleima merkkijonona valinnaisessa muodossa.
getFutureTime	Palauta nykyinen aikaleima ja määritetyt aikayksiköt. Katso myös addToTime.
getPastTime	Palauta nykyinen aikaleima vähennettynä määritetyillä aikayksiköillä. Katso myös subtractFromTime.
startOfDay	Palauta aikaleima päivän alkuun.
startOfHour	Palauta tunnin alku aikaleimalle.
startOfMonth	Palauta aikaleima kuukauden alkuun.
subtractFromTime	Vähentää aikayksiköiden määrän aikaleimasta. Katso myös getPastTime.
Punkit	Palauta määritetyn `ticks` aikaleiman ominaisuuden arvo.
utcNow	Palauta nykyinen aikaleima merkkijonona.

Merkkijonofunktiot

Voit käsitellä merkkijonoja käyttämällä näitä merkkijonofunktioita ja myös kokoelmafunktioita. Merkkijonofunktiot toimivat vain merkkijonoissa.

Merkkijonofunktio	Tehtävä
concat	Yhdistä vähintään kaksi merkkijonoa ja palauta yhdistetty merkkijono.
endsWith	Tarkista, päättyykö merkkijono määritettyyn alimerkkijonoon.
Guid	Luo guiD-tunnus merkkijonona.
indexOf	Palauta alimerkkijonon aloituskohta.
lastIndexOf	Palauta alimerkkijonon viimeisen esiintymän aloituskohta.
replace	Korvaa alimerkkijono määritetyllä merkkijonolla ja palauta päivitetty merkkijono.
split	Palauta matriisi, joka sisältää pilkuilla eroteltuja alimerkkijonoja, suuremmasta merkkijonosta alkuperäisen merkkijonon määritetyn erottimen perusteella.
startsWith	Tarkista, alkaako merkkijono tietyllä alimerkkijonolla.
Alimerkkijono	Palauta merkit merkkijonosta aloittaen määritetystä sijainnista.
ToLower	Palauta merkkijono pienin kirjaimin.
ToUpper	Palauta merkkijono isoilla kirjaimilla.
Leikata	Poista alussa ja lopussa olevat välilyönnit merkkijonosta ja palauta päivitetty merkkijono.

Kokoelmafunktiot

Voit käyttää kokoelmia, yleensä matriiseja, merkkijonoja ja joskus sanastoja, käyttämällä näitä kokoelmafunktioita.

Collection-funktio	Tehtävä
Sisältää	Tarkista, onko kokoelmalla tietty kohde.
tyhjä	Tarkista, onko kokoelma tyhjä.
Ensimmäinen	Palauta kokoelman ensimmäinen kohde.
Risteys	Palauta kokoelma, jossa on vain määritettyjen kokoelmien yhteiset kohteet.
Liittyä	Palauta merkkijono, jossa on kaikki kohteet matriisissa määritetyllä meerillä eroteltuna.
Viime	Palauta viimeinen kohde kokoelmasta.
Pituus	Palauta merkkijonon tai matriisin kohteiden määrä.
Ohittaa	Poista kohteita kokoelman edustasta ja palauta kaikki muut kohteet.
Ottaa	Palauta kohteet kokoelman edestä.
Unionin	Palauta kokoelma, joka sisältää kaikki määritetyn kokoelman kohteet.

Loogiset toiminnot

Nämä funktiot ovat hyödyllisiä olosuhteiden sisällä, ja niiden avulla voidaan arvioida mitä tahansa logiikkaa.

Looginen vertailufunktio	Tehtävä
and	Tarkista, onko kaikki lausekkeet tosia.
Vastaa	Tarkista, ovatko molemmat arvot toisiaan vastaavia.
suurempi	Tarkista, onko ensimmäinen arvo suurempi kuin toinen arvo.
greaterOrEquals	Tarkista, onko ensimmäinen arvo suurempi tai yhtä suuri kuin toinen arvo.
Jos	Tarkista, onko lauseke tosi vai epätosi. Palauta määritetty arvo tuloksen perusteella.
vähemmän	Tarkista, onko ensimmäinen arvo pienempi kuin toinen arvo.
lessOrEquals	Tarkista, onko ensimmäinen arvo pienempi tai yhtä suuri kuin toinen arvo.
Ei	Tarkista, onko lauseke epätosi.
tai	Tarkista, onko vähintään yksi lauseke tosi.

Muuntofunktiot

Näiden funktioiden avulla muunnetaan kunkin kielen alkuperäistyypin välillä:

merkkijono
integer
liukuluku
boolean
Matriiseja
Sanakirjat

Muuntamisfunktio	Tehtävä
Array	Palauta matriisi yksittäisestä määritetystä syötteestä. Katso useita syötteitä kohdasta createArray.
perus64	Palauta merkkijonolle base64-koodattu versio.
base64ToBinary	Palauta base64-koodatun merkkijonon binaariversio.
base64ToString	Palauta base64-koodatun merkkijonon merkkijonoversio.
Binary	Palauta syötearvon binaariversio.
Bool	Palauta syötearvon totuusarvoversio.
coalesce	Palauta ensimmäinen muu kuin tyhjäarvo yhdestä tai useammasta parametrista.
createArray	Palauta matriisi useista syötettä.
dataUri	Palauta syötearvon tietojen URI-osoite.
dataUriToBinary	Palauta datan URI-ohjaimen binaariversio.
dataUriToString	Palauta datan URI-ohjaimen merkkijonoversio.
decodeBase64	Palauta base64-koodatun merkkijonon merkkijonoversio.
decodeDataUri	Palauta datan URI-ohjaimen binaariversio.
decodeUriComponent	Palauta merkkijono, joka korvaa escape-merkit koodatuilla versioilla.
encodeUriComponent	Palauta merkkijono, joka korvaa URL-osoitteet suojaattomat merkit escape-merkeillä.
Float	Palauta liukuluku syötearvolle.
Int	Palauta merkkijonon kokonaislukuversio.
Merkkijono	Palauta syötearvon merkkijonoversio.
URIComponent	Palauta syötearvon URI-koodattu versio korvaamalla URL-suojaamattomia merkkejä escape-merkeillä.
uriComponentToBinary	Palauta URI-koodatun merkkijonon binaariversio.
URIComponentToString	Palauta URI-koodatun merkkijonon merkkijonoversio.
Xml	Palauta merkkijonon XML-versio.
Xpath	Tarkista XML:stä solmut tai arvot, jotka vastaavat XPath (XML Path Language) -lauseketta, ja palauta vastaavat solmut tai arvot.

Matemaattiset funktiot

Näitä funktioita voidaan käyttää jommassakummassa lukutyypissä: kokonaisluvuissa ja liukuluvuissa.

Matemaattinen funktio	Tehtävä
Lisää	Palauta tulos kahden numeron lisäämisen jälkeen.
Div	Palauta tulos kahden numeron jakamisesta.
Max	Palauta suurin arvo lukujen tai matriisin joukosta.
Min	Palauta pienin arvo lukujen tai matriisin joukosta.
Mod	Palauta jakojääne kahden numeron jakamisesta.
Mul	Palauta tuote kahden numeron kertomisesta.
Randi	Palauta satunnainen kokonaisluku määritetyltä alueelta.
range	Palauta kokonaislukumatriisi, joka alkaa määritetystä kokonaisluvusta.
Osa	Palauta tulos toisen luvun vähentämästä ensimmäisestä luvusta.

Funktioviittaus

Tässä osiossa luetellaan kaikki käytettävissä olevat funktiot aakkosjärjestyksessä.

Lisää

Palauta tulos kahden numeron lisäämisen jälkeen.

add(<summand_1>, <summand_2>)

Parametri	Pakollinen	Type	Kuvaus
<>summand_1, <summand_2>	Kyllä	Kokonaisluku, liukuluku tai yhdistelmä	Lisättävät luvut

Palautusarvo	Tyyppi	Kuvaus
<result-sum>	Kokonaisluku tai liukuluku	Määritettyjen lukujen lisäämisen tulos

Esimerkki

Tämä esimerkki lisää määritetyt luvut:

add(1, 1.5)

Palauttaa tämän tuloksen: 2.5

addDays

Lisää aikaleimaan päivien määrä.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<Päivää>	Kyllä	Integer	Lisättävä positiivinen tai negatiivinen päivien määrä
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<updated-timestamp>	Merkkijono	Aikaleima ja määritetty päivien määrä

Esimerkki 1

Tämä esimerkki lisää määritettyyn aikaleimaan 10 päivää:

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

Palauttaa tämän tuloksen: "2018-03-25T00:00:0000000Z"

Esimerkki 2

Tässä esimerkissä vähennetään viisi päivää määritetystä aikaleimasta:

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

Palauttaa tämän tuloksen: "2018-03-10T00:00:0000000Z"

lisää tunnit

Lisää aikaleimaan tuntimäärä.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<Tuntia>	Kyllä	Integer	Lisättävä positiivinen tai negatiivinen tuntien määrä
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<updated-timestamp>	Merkkijono	Aikaleima ja määritetty tuntien määrä

Esimerkki 1

Tämä esimerkki lisää määritettyyn aikaleimaan 10 tuntia:

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

Palauttaa tämän tuloksen: "2018-03-15T10:00:0000000Z"

Esimerkki 2

Tässä esimerkissä vähennetään viisi tuntia määritetystä aikaleimasta:

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

Palauttaa tämän tuloksen: "2018-03-15T10:00:0000000Z"

addMinutes

Lisää aikaleimaan minuuttien määrä.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<Minuuttia>	Kyllä	Integer	Lisättävä positiivinen tai negatiivinen minuuttimäärä
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<updated-timestamp>	Merkkijono	Aikaleima ja määritetty minuuttimäärä

Esimerkki 1

Tämä esimerkki lisää määritettyyn aikaleimaan 10 minuuttia:

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

Palauttaa tämän tuloksen: "2018-03-15T00:20:00.0000000Z"

Esimerkki 2

Tämä esimerkki vähentää viisi minuuttia määritetystä aikaleimasta:

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

Palauttaa tämän tuloksen: "2018-03-15T00:15:00.0000000Z"

addSeconds

Lisää aikaleimaan sekuntien määrä.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<Sekuntia>	Kyllä	Integer	Lisättävä positiivinen tai negatiivinen sekuntien määrä
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<updated-timestamp>	Merkkijono	Aikaleima lisättynä määritetyllä sekuntien määrällä

Esimerkki 1

Tämä esimerkki lisää määritettyyn aikaleimaan 10 sekuntia:

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

Palauttaa tämän tuloksen: "2018-03-15T00:00:10.0000000Z"

Esimerkki 2

Tässä esimerkissä vähennetään viisi sekuntia määritettyyn aikaleimaan:

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

Palauttaa tämän tuloksen: "2018-03-15T00:00:25.0000000Z"

addToTime

Lisää aikayksiköiden määrä aikaleimaan. Katso myös getFutureTime().

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<Aikaväli>	Kyllä	Integer	Lisättavien aikayksiköiden määrä
<timeUnit>	Kyllä	Merkkijono	Aikayksikkö, jota käytetään aikavälin kanssa: "Sekunti", "Minuutti", "Tunti", "Päivä", "Viikko", "Kuukausi", "Vuosi"
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<updated-timestamp>	Merkkijono	Aikaleima lisättynä määritetyllä aikayksiköiden määrällä

Esimerkki 1

Tämä esimerkki lisää määritettyyn aikaleimaan yhden päivän:

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

Palauttaa tämän tuloksen: "2018-01-02T00:00:00.0000000Z"

Esimerkki 2

Tämä esimerkki lisää määritettyyn aikaleimaan yhden päivän:

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

Ja palauttaa tuloksen käyttämällä valinnaista D-muotoa: "Tuesday, January 2, 2018"

ja

Tarkista, onko kummankin lausekkeen arvo tosi. Palauta arvo true, kun molemmat lausekkeet ovat tosia, tai palauta epätosi, kun vähintään yksi lauseke on epätosi.

and(<expression1>, <expression2>)

Parametri	Pakollinen	Type	Kuvaus
<expression1>, <expression2>	Kyllä	Boolean	Tarkistettavat lausekkeet

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Palauta arvo true, kun molemmat lausekkeet ovat tosia. Palauta epätosi, kun vähintään yksi lauseke on epätosi.

Esimerkki 1

Seuraavissa esimerkeissä tarkistetaan, ovatko määritetyt totuusarvot tosia:

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

Palauttaa nämä tulokset:

Ensimmäinen esimerkki: Molemmat lausekkeet ovat tosia, joten palauttaa arvon true.
Toinen esimerkki: Yksi lauseke on epätosi, joten palauttaa arvon false.
Kolmas esimerkki: Kummankin lausekkeen arvo on epätosi, joten se palauttaa arvon false.

Esimerkki 2

Seuraavissa esimerkeissä tarkistetaan, ovatko määritetyt lausekkeet molemmat tosia:

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

Palauttaa nämä tulokset:

Ensimmäinen esimerkki: Molemmat lausekkeet ovat tosia, joten palauttaa arvon true.
Toinen esimerkki: Yksi lauseke on epätosi, joten palauttaa arvon false.
Kolmas esimerkki: Kummankin lausekkeen arvo on epätosi, joten se palauttaa arvon false.

matriisi

Palauta matriisi yksittäisestä määritetystä syötteestä. Katso useita syötteitä kohdasta createArray().

array('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Merkkijono matriisin luomista varten

Palautusarvo	Tyyppi	Kuvaus
[<value>]	Matriisi	Matriisi, joka sisältää yksittäisen määritetyn syötteen

Esimerkki

Tämä esimerkki luo matriisin "hei"-merkkijonosta:

array('hello')

Palauttaa tämän tuloksen: ["hello"]

perus64

Palauta merkkijonolle base64-koodattu versio.

base64('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Syötemerkkijono

Palautusarvo	Tyyppi	Kuvaus
<base64-string>	Merkkijono	Syötemerkkijonon base64-koodattu versio

Esimerkki

Tässä esimerkissä "hei"-merkkijono muunnetaan base64-koodatuksi merkkijonoksi:

base64('hello')

Palauttaa tämän tuloksen: "aGVsbG8="

base64ToBinary

Palauta base64-koodatun merkkijonon binaariversio.

base64ToBinary('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Muunnettava base64-koodattu merkkijono

Palautusarvo	Tyyppi	Kuvaus
<binary-for-base64-string>	Merkkijono	Base64-koodatun merkkijonon binaariversio

Esimerkki

Tässä esimerkissä muunnetaan "aGVsbG8=" base64-koodattu merkkijono binaarimerkkijonoksi:

base64ToBinary('aGVsbG8=')

Palauttaa tämän tuloksen:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Palauta base64-koodatun merkkijonon merkkijonoversio, käytännössä poistaen base64-merkkijonon koodauksen. Käytä tätä funktiota decodeBase64()-funktion sijaan. Vaikka molemmat funktiot toimivat samalla tavalla, base64ToString() on suositeltavaa.

base64ToString('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Koodattava base64-koodattu merkkijono

Palautusarvo	Tyyppi	Kuvaus
<decoded-base64-string>	Merkkijono	Base64-koodatun merkkijonon versio

Esimerkki

Tässä esimerkissä muunnetaan "aGVsbG8=" base64-koodattu merkkijono vain merkkijonoksi:

base64ToString('aGVsbG8=')

Palauttaa tämän tuloksen: "hello"

Binary

Palauta merkkijonon binaariversio.

binary('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Muunnettava merkkijono

Palautusarvo	Tyyppi	Kuvaus
<binary-for-input-value>	Merkkijono	Määritetyn merkkijonon binaariversio

Esimerkki

Tässä esimerkissä "hello"-merkkijono muunnetaan binaarimerkkijonoksi:

binary('hello')

Palauttaa tämän tuloksen:

"0110100001100101011011000110110001101111"

bool

Palauta totuusarvon versio.

bool(<value>)

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Any	Muunnettava arvo

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Määritetyn arvon totuusarvon versio

Esimerkki

Näissä esimerkeissä määritetyt arvot muunnetaan totuusarvoiksi:

bool(1)
bool(0)

Palauttaa nämä tulokset:

Ensimmäinen esimerkki: true
Toinen esimerkki: false

coalesce

Palauta ensimmäinen muu kuin tyhjäarvo yhdestä tai useammasta parametrista. Tyhjät merkkijonot, tyhjät matriisit ja tyhjät objektit eivät ole tyhjäarvoja.

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

Parametri	Pakollinen	Type	Kuvaus
<>object_1, <object_2>, ...	Kyllä	Kaikki, voidaan sekoittaa tyyppejä	Yksi tai useampi kohde nolla-arvon tarkistamiseen

Palautusarvo	Tyyppi	Kuvaus
<first-non-null-item>	Any	Ensimmäinen kohde tai arvo, joka ei ole tyhjäarvo. Jos kaikki parametrit ovat tyhjäarvoisia, tämä funktio palauttaa tyhjäarvon.

Esimerkki

Nämä esimerkit palauttavat ensimmäisen muun kuin tyhjäarvon määritetyistä arvoista tai tyhjäarvon, kun kaikki arvot ovat tyhjäarvoja:

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

Palauttaa nämä tulokset:

Ensimmäinen esimerkki: true
Toinen esimerkki: "hello"
Kolmas esimerkki: null

concat

Yhdistä vähintään kaksi merkkijonoa ja palauta yhdistetty merkkijono.

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

Parametri	Pakollinen	Type	Kuvaus
<text1>, <text2>, ...	Kyllä	Merkkijono	Yhdistettävä vähintään kaksi merkkijonoa

Palautusarvo	Tyyppi	Kuvaus
<text1text2...>	Merkkijono	Yhdistetyistä syötemerkkijonosta luotu merkkijono

Esimerkki

Tässä esimerkissä yhdistyvät merkkijonot "Hello" ja "World":

concat('Hello', 'World')

Palauttaa tämän tuloksen: "HelloWorld"

sisältää

Tarkista, onko kokoelmalla tietty kohde. Palauta true, kun kohde löytyy, tai palauta epätosi, kun sitä ei löydy. Tässä funktiossa kirjainkoko on merkitsevä.

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

Tarkemmin sanottuna tämä funktio toimii seuraavissa kokoelmatyypeissä:

Merkkijono, jolla etsitään alimerkkijono
Matriisi arvon löytämiseksi
Sanasto avaimen löytämiseksi

Parametri	Pakollinen	Type	Kuvaus
<Collection>	Kyllä	Merkkijono, matriisi tai sanasto	Tarkistettava kokoelma
<arvo>	Kyllä	Merkkijono, matriisi tai sanasto	Etsittävä kohde

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Palauta true, kun kohde löydetään. Palauta epätosi, kun sitä ei löydy.

Esimerkki 1

Tässä esimerkissä merkkijono "hei maailma" tarkistaa alimerkkijonon "world" ja palauttaa arvon true:

contains('hello world', 'world')

Esimerkki 2

Tässä esimerkissä tarkistetaan merkkijono "hello world" alimerkkijonon "universe" osalta ja palautetaan epätosi:

contains('hello world', 'universe')

convertFromUtc

Muunna aikaleima UTC-aikavyöhykkeestä kohdeaikavyöhykkeeksi.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<destinationTimeZone>	Kyllä	Merkkijono	Kohdeaikavyöhykkeen nimi. Aikavyöhykenimien osalta katso Microsoftin aikavyöhykearvot, mutta sinun on ehkä poistettava aikavyöhykkeen nimestä mahdolliset välimerkit.
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<muunnettu aikaleima>	Merkkijono	Kohdeaikavyöhykkeeksi muunnettu aikaleima

Esimerkki 1

Tämä esimerkki muuntaa aikaleiman määritetyksi aikavyöhykkeeksi:

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

Palauttaa tämän tuloksen: "2018-01-01T00:00:00Z"

Esimerkki 2

Tässä esimerkissä aikaleima muunnetaan määritetyksi aikavyöhykkeeksi ja muodoksi:

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

Palauttaa tämän tuloksen: "Monday, January 1, 2018"

convertTimeZone

Muunna aikaleima lähdeaikavyöhykkeestä kohdeaikavyöhykkeeksi.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<sourceTimeZone>	Kyllä	Merkkijono	Lähteen aikavyöhykkeen nimi. Aikavyöhykenimien osalta katso Microsoftin aikavyöhykearvot, mutta sinun on ehkä poistettava aikavyöhykkeen nimestä mahdolliset välimerkit.
<destinationTimeZone>	Kyllä	Merkkijono	Kohdeaikavyöhykkeen nimi. Aikavyöhykenimien osalta katso Microsoftin aikavyöhykearvot, mutta sinun on ehkä poistettava aikavyöhykkeen nimestä mahdolliset välimerkit.
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<muunnettu aikaleima>	Merkkijono	Kohdeaikavyöhykkeeksi muunnettu aikaleima

Esimerkki 1

Tässä esimerkissä lähdeaikavyöhyke muunnetaan kohdeaikavyöhykkeeksi:

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

Palauttaa tämän tuloksen: "2018-01-01T00:00:00.0000000"

Esimerkki 2

Tässä esimerkissä aikavyöhyke muunnetaan määritetyksi aikavyöhykkeeksi ja muodoksi:

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

Palauttaa tämän tuloksen: "Monday, January 1, 2018"

convertToUtc

Aikaleiman muuntaminen lähdeaikavyöhykkeestä UTC-ajaksi (Universal Time Coordinated).

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<sourceTimeZone>	Kyllä	Merkkijono	Lähteen aikavyöhykkeen nimi. Aikavyöhykenimien osalta katso Microsoftin aikavyöhykearvot, mutta sinun on ehkä poistettava aikavyöhykkeen nimestä mahdolliset välimerkit.
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<muunnettu aikaleima>	Merkkijono	UTC-ajaksi muunnettu aikaleima

Esimerkki 1

Tämä esimerkki muuntaa aikaleiman UTC-ajaksi:

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

Palauttaa tämän tuloksen: "2018-01-01T08:00:00.0000000Z"

Esimerkki 2

Tämä esimerkki muuntaa aikaleiman UTC-ajaksi:

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

Palauttaa tämän tuloksen: "Monday, January 1, 2018"

createArray

Palauta matriisi useista syötettä. Katso yhden syötteen matriisit kohdasta array().

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

Parametri	Pakollinen	Type	Kuvaus
<object1>, <object2>, ...	Kyllä	Kaikki, mutta eivät yhdistelmät	Vähintään kaksi kohdetta matriisin luomiseksi

Palautusarvo	Tyyppi	Kuvaus
[<object1>, <object2>, ...]	Matriisi	Kaikista syötekohteista luotu matriisi

Esimerkki

Tämä esimerkki luo matriisin näistä syötteiden avulla:

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

Palauttaa tämän tuloksen: ["h", "e", "l", "l", "o"]

dataUri

Palauta merkkijonolle tietojen yhtenäinen resurssitunnus (URI).

dataUri('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Muunnettava merkkijono

Palautusarvo	Tyyppi	Kuvaus
<data-URI>	Merkkijono	Syötemerkkijonon tietojen URI

Esimerkki

Tämä esimerkki luo tietojen URI-uri-osoitteen "hei"-merkkijonolle:

dataUri('hello')

Palauttaa tämän tuloksen: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Palauta data uniform resource identifier (URI) -binaariversio. Käytä tätä funktiota decodeDataUri()-funktion sijaan. Vaikka molemmat funktiot toimivat samalla tavalla, dataUriBinary() on suositeltavaa.

dataUriToBinary('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Muunnettava tietojen URI

Palautusarvo	Tyyppi	Kuvaus
<binary-for-data-URI>	Merkkijono	Tietojen URI-uri-ohjaimen binaariversio

Esimerkki

Tämä esimerkki luo binaariversion tälle tietojen URI-uri:lle:

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

Palauttaa tämän tuloksen:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Palauta merkkijonoversio data uniform resource identifier (URI) -tunnuksen mukaan.

dataUriToString('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Muunnettava tietojen URI

Palautusarvo	Tyyppi	Kuvaus
<string-for-data-URI>	Merkkijono	Datan URI-uri-ohjaimen merkkijonoversio

Esimerkki

Tämä esimerkki luo merkkijonon tälle tietojen URI-uri-tunnille:

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

Palauttaa tämän tuloksen: "hello"

dayOfMonth

Palauta kuukauden päivä aikaleimasta.

dayOfMonth('<timestamp>')

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman

Palautusarvo	Tyyppi	Kuvaus
<kuukauden päivä>	Integer	Kuukauden päivä määritetystä aikaleimasta

Esimerkki

Tämä esimerkki palauttaa kuukauden päivän numeron tästä aikaleimasta:

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

Palauttaa tämän tuloksen: 15

dayOfWeek

Palauta viikonpäivä aikaleimasta.

dayOfWeek('<timestamp>')

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman

Palautusarvo	Tyyppi	Kuvaus
<viikonpäivä>	Integer	Viikonpäivä määritetystä aikaleimasta, jossa sunnuntai on 0, maanantai on 1 ja niin edelleen

Esimerkki

Tämä esimerkki palauttaa viikonpäivän numeron tästä aikaleimasta:

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

Palauttaa tämän tuloksen: 3

dayOfYear

Palauta vuoden päivä aikaleimasta.

dayOfYear('<timestamp>')

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman

Palautusarvo	Tyyppi	Kuvaus
<vuoden päivä>	Integer	Vuoden päivä määritetystä aikaleimasta

Esimerkki

Tässä esimerkissä palautetaan vuoden päivän numero tästä aikaleimasta:

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

Palauttaa tämän tuloksen: 74

decodeBase64

Palauta base64-koodatun merkkijonon merkkijonoversio, käytännössä poistaen base64-merkkijonon koodauksen. Harkitse Base64ToString()-kohteen käyttämistä :n asemestadecodeBase64(). Vaikka molemmat funktiot toimivat samalla tavalla, base64ToString() on suositeltavaa.

decodeBase64('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Koodattava base64-koodattu merkkijono

Palautusarvo	Tyyppi	Kuvaus
<decoded-base64-string>	Merkkijono	Base64-koodatun merkkijonon versio

Esimerkki

Tämä esimerkki luo merkkijonon base64-koodatulle merkkijonolle:

decodeBase64('aGVsbG8=')

Palauttaa tämän tuloksen: "hello"

decodeDataUri

Palauta data uniform resource identifier (URI) -binaariversio. Harkitse dataUriToBinary()-kohteen käyttämistä :n asemestadecodeDataUri(). Vaikka molemmat funktiot toimivat samalla tavalla, dataUriToBinary() on suositeltavaa.

decodeDataUri('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Koodattava tietojen URI-merkkijono

Palautusarvo	Tyyppi	Kuvaus
<binary-for-data-URI>	Merkkijono	Tietojen URI-merkkijonon binaariversio

Esimerkki

Tässä esimerkissä palautetaan näiden tietojen URI-uri-parametrin binaariversio:

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

Palauttaa tämän tuloksen:

decodeUriComponent

Palauta merkkijono, joka korvaa escape-merkit koodatuilla versioilla.

decodeUriComponent('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Merkkijono, jonka koodaus poistetaan ohjausmerkkien avulla

Palautusarvo	Tyyppi	Kuvaus
<decoded-URI>	Merkkijono	Päivitetty merkkijono, jossa on koodattuja ohjausmerkkejä

Esimerkki

Tässä esimerkissä korvataan tämän merkkijonon escape-merkit koodatuilla versioilla:

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

Palauttaa tämän tuloksen: "https://contoso.com"

Div

Palauta kokonaislukutulos kahden numeron jakamisesta. Jos haluat saada jäljellä olevan tuloksen, katso mod().

div(<dividend>, <divisor>)

Parametri	Pakollinen	Type	Kuvaus
<Osinko>	Kyllä	Kokonaisluku tai liukuluku	Jakajalla jaettava luku
<Jakaja>	Kyllä	Kokonaisluku tai liukuluku	Luku, joka jakaa osingon, mutta ei voi olla 0

Palautusarvo	Tyyppi	Kuvaus
<quotient-result>	Integer	Kokonaislukutulos ensimmäisen luvun jakamisesta toisella luvulla

Esimerkki

Molemmat esimerkit jakavat ensimmäisen luvun toisella luvulla:

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

Palauta myös tämä tulos: 2

encodeUriComponent

Palauta merkkijonolle URI-koodattu uniform resource identifier -versio korvaamalla URL-osoitteettomat merkit escape-merkeillä. Harkitse URIComponent()-toiminnon käyttämistä :n asemestaencodeUriComponent(). Vaikka molemmat funktiot toimivat samalla tavalla, uriComponent() on suositeltavaa.

encodeUriComponent('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	URI-koodattuun muotoon muunnettava merkkijono

Palautusarvo	Tyyppi	Kuvaus
<encoded-URI>	Merkkijono	URI-koodattu merkkijono, jossa on ohjausmerkkejä

Esimerkki

Tämä esimerkki luo URI-koodatun version tälle merkkijonolle:

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

Palauttaa tämän tuloksen: "http%3A%2F%2Fcontoso.com"

tyhjä

Tarkista, onko kokoelma tyhjä. Palauta arvoksi true, kun kokoelma on tyhjä, tai palauta epätosi, kun se ei ole tyhjä.

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

Parametri	Pakollinen	Type	Kuvaus
<Collection>	Kyllä	Merkkijono, matriisi tai objekti	Tarkistettava kokoelma

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Palauta arvo true, kun kokoelma on tyhjä. Palauta epätosi, kun se ei ole tyhjä.

Esimerkki

Seuraavissa esimerkeissä tarkistetaan, ovatko määritetyt kokoelmat tyhjiä:

empty('')
empty('abc')

Palauttaa nämä tulokset:

Ensimmäinen esimerkki: välittää tyhjän merkkijonon, joten funktio palauttaa arvon true.
Toinen esimerkki: Välittää merkkijonon "abc", jotta funktio palauttaa arvon false.

endsWith

Tarkista, päättyykö merkkijono tiettyyn alimerkkijonoon. Palauta arvoksi true, kun alimerkkijoki löydetään, tai palauta epätosi, kun sitä ei löydy. Tässä funktiossa ei kirjainkoko ole merkitsevä.

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

Parametri	Pakollinen	Type	Kuvaus
<Teksti>	Kyllä	Merkkijono	Tarkistettava merkkijono
<searchText>	Kyllä	Merkkijono	Etsittävä loppu-alimerkkijolo

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Palauta arvo true, kun loppu-alimerkkijoni on löytynyt. Palauta epätosi, kun sitä ei löydy.

Esimerkki 1

Tässä esimerkissä tarkistetaan, päättyykö "hello world" -merkkijono "world"-merkkijonoon:

endsWith('hello world', 'world')

Palauttaa tämän tuloksen: true

Esimerkki 2

Tässä esimerkissä tarkistetaan, päättyykö "hello world" -merkkijono "universe"-merkkijonoon:

endsWith('hello world', 'universe')

Palauttaa tämän tuloksen: false

on yhtä suuri kuin

Tarkista, ovatko molemmat arvot, lausekkeet tai objektit toisiaan vastaavia. Palauta arvo true, kun molemmat vastaavat toisiaan, tai palauta epätosi, kun ne eivät ole toisiaan vastaavia.

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

Parametri	Pakollinen	Type	Kuvaus
<object1>, <object2>	Kyllä	Useita	Vertailtavat arvot, lausekkeet tai objektit

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Palauta true, kun molemmat vastaavat toisiaan. Palauta epätosi, kun se ei ole vastaava.

Esimerkki

Näissä esimerkeissä tarkistetaan, ovatko määritetyt syötteet toisiaan vastaavia.

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

Palauttaa nämä tulokset:

Ensimmäinen esimerkki: Molemmat arvot ovat toisiaan vastaavia, joten funktio palauttaa arvon true.
Toinen esimerkki: Molemmat arvot eivät ole toisiaan vastaavia, joten funktio palauttaa arvon false.

Ensimmäinen

Palauta ensimmäinen kohde merkkijonosta tai matriisissa.

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

Parametri	Pakollinen	Type	Kuvaus
<Collection>	Kyllä	Merkkijono tai matriisi	Kokoelma, josta löydät ensimmäisen kohteen

Palautusarvo	Tyyppi	Kuvaus
<first-collection-item>	Any	Kokoelman ensimmäinen kohde

Esimerkki

Seuraavissa esimerkeissä löydät näiden kokoelmien ensimmäisen kohteen:

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

Palauta myös nämä tulokset:

Ensimmäinen esimerkki: "h"
Toinen esimerkki: 0

liukuluku

Muunna merkkijonoversio liukuluvuksi todelliseksi liukupisteluvuksi.

float('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Merkkijono, jolla on kelvollinen liukuluku muunnettavaksi

Palautusarvo	Tyyppi	Kuvaus
<liukuluku-arvo>	Float	Määritetyn merkkijonon liukuluku

Esimerkki

Tämä esimerkki luo merkkijonoversion tälle liukuluvulle:

float('10.333')

Palauttaa tämän tuloksen: 10.333

formatDateTime

Palauta aikaleima määritetyssä muodossa.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<reformatted-timestamp>	Merkkijono	Päivitetty aikaleima määritetyssä muodossa

Esimerkki

Tämä esimerkki muuntaa aikaleiman määritettyyn muotoon:

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

Palauttaa tämän tuloksen: "2018-03-15T12:00:00"

getFutureTime

Palauta nykyinen aikaleima ja määritetyt aikayksiköt.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaväli>	Kyllä	Integer	Lisättavien aikayksiköiden määrä
<timeUnit>	Kyllä	Merkkijono	Aikayksikkö, jota käytetään aikavälin kanssa: "Sekunti", "Minuutti", "Tunti", "Päivä", "Viikko", "Kuukausi", "Vuosi"
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<updated-timestamp>	Merkkijono	Nykyinen aikaleima lisättynä määritetyllä aikayksiköiden määrällä

Esimerkki 1

Oletetaan, että nykyinen aikaleima on "2018-03-01T00:00:00.0000000Z". Tämä esimerkki lisää tähän aikaleimaan viisi päivää:

getFutureTime(5, 'Day')

Palauttaa tämän tuloksen: "2018-03-06T00:00:00.0000000Z"

Esimerkki 2

Oletetaan, että nykyinen aikaleima on "2018-03-01T00:00:00.0000000Z". Tämä esimerkki lisää viisi päivää ja muuntaa tuloksen D-muotoon:

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

Palauttaa tämän tuloksen: "Tuesday, March 6, 2018"

getPastTime

Palauta nykyinen aikaleima vähennettynä määritetyillä aikayksiköillä.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaväli>	Kyllä	Integer	vähennettävien määritettyjen aikayksiköiden määrä
<timeUnit>	Kyllä	Merkkijono	Aikayksikkö, jota käytetään aikavälin kanssa: "Sekunti", "Minuutti", "Tunti", "Päivä", "Viikko", "Kuukausi", "Vuosi"
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<updated-timestamp>	Merkkijono	Nykyinen aikaleima vähennettynä määritetyllä aikayksiköiden määrällä

Esimerkki 1

Oletetaan, että nykyinen aikaleima on "2018-02-01T00:00:00.0000000Z". Tässä esimerkissä vähennetään viisi päivää aikaleimasta:

getPastTime(5, 'Day')

Palauttaa tämän tuloksen: "2018-01-27T00:00:00.0000000Z"

Esimerkki 2

Oletetaan, että nykyinen aikaleima on "2018-02-01T00:00:00.0000000Z". Tässä esimerkissä vähennetään viisi päivää ja muunnetaan tulos D-muotoon:

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

Palauttaa tämän tuloksen: "Saturday, January 27, 2018"

suurempi

Tarkista, onko ensimmäinen arvo suurempi kuin toinen arvo. Palauta arvo true, kun ensimmäinen arvo on suurempi, tai palauta epätosi, kun arvo on pienempi.

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

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Kokonaisluku, liukuluku tai merkkijono	Ensimmäinen arvo, joka tarkistaa, onko suurempi kuin toinen arvo
<compareTo>	Kyllä	Kokonaisluku, liukuluku tai merkkijono	Vertailuarvo

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Palauta arvo true, kun ensimmäinen arvo on suurempi kuin toinen arvo. Palauta epätosi, kun ensimmäinen arvo on yhtä suuri tai pienempi kuin toinen arvo.

Esimerkki

Seuraavissa esimerkeissä tarkistetaan, onko ensimmäinen arvo suurempi kuin toinen arvo:

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

Palauta myös nämä tulokset:

Ensimmäinen esimerkki: true
Toinen esimerkki: false

greaterOrEquals

Tarkista, onko ensimmäinen arvo suurempi tai yhtä suuri kuin toinen arvo. Palauta true, kun ensimmäinen arvo on suurempi tai yhtä suuri, tai palauta epätosi, kun ensimmäinen arvo on pienempi.

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

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Kokonaisluku, liukuluku tai merkkijono	Ensimmäinen arvo, joka tarkistaa, onko suurempi tai yhtä suuri kuin toinen arvo
<compareTo>	Kyllä	Kokonaisluku, liukuluku tai merkkijono	Vertailuarvo

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Palauta arvo true, kun ensimmäinen arvo on suurempi tai yhtä suuri kuin toinen arvo. Palauta epätosi, kun ensimmäinen arvo on pienempi kuin toinen arvo.

Esimerkki

Seuraavissa esimerkeissä tarkistetaan, onko ensimmäinen arvo suurempi tai yhtä suuri kuin toinen arvo:

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

Palauta myös nämä tulokset:

Ensimmäinen esimerkki: true
Toinen esimerkki: false

Guid

Luo globaalisti yksilöivä tunnus (GUID) merkkijonona, esimerkiksi "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Voit myös määrittää GUID-tunnuksen muun muodon kuin oletusmuodon "D", joka on 32 numeroa eroteltuna yhdysmerkeillä.

guid('<format>')

Parametri	Pakollinen	Type	Kuvaus
<Muodossa>	Ei	Merkkijono	Yksittäinen muotomäärite palautetulle GUID-tunnuksen määritykselle. Muoto on oletusarvoisesti "D", mutta voit käyttää "N", "D", "B", "P" tai "X".

Palautusarvo	Tyyppi	Kuvaus
<GUID-value>	Merkkijono	Satunnaisesti muodostettu GUID-tunnus

Esimerkki

Tämä esimerkki luo saman GUID-tunnuksen, mutta 32 numeroa, jotka on eroteltu yhdysmerkeillä ja sisällytetty sulkeisiin:

guid('P')

Palauttaa tämän tuloksen: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

Tarkista, onko lauseke tosi vai epätosi. Palauta määritetty arvo tuloksen perusteella.

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

Parametri	Pakollinen	Type	Kuvaus
<Ilmaisun>	Kyllä	Boolean	Tarkistettava lauseke
<valueIfTrue>	Kyllä	Any	Arvo, joka palautetaan, kun lauseke on tosi
<valueIfFalse>	Kyllä	Any	Arvo, joka palautetaan, kun lauseke on epätosi

Palautusarvo	Tyyppi	Kuvaus
<specified-return-value>	Any	Määritetty arvo, joka palauttaa sen perusteella, onko lauseke tosi vai epätosi

Esimerkki

Tämä esimerkki palauttaa arvon "yes" , koska määritetty lauseke antaa tulokseksi true. Muussa tapauksessa esimerkki palauttaa arvon "no":

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

indexOf

Palauta alimerkkijonon aloitussijainnin tai indeksiarvon. Tässä funktiossa ei kirjainkoko ole merkitsevä, ja indeksit alkavat luvusta 0.

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

Parametri	Pakollinen	Type	Kuvaus
<Teksti>	Kyllä	Merkkijono	Merkkijono, jonka alimerkkijonon haluat etsiä
<searchText>	Kyllä	Merkkijono	Etsittävä alimerkkijoki

Palautusarvo	Tyyppi	Kuvaus
<index-value>	Integer	Määritetyn alimerkkijonon aloitussijainnin tai indeksiarvon. Jos merkkijonoa ei löydy, palauta luku -1.

Esimerkki

Tässä esimerkissä "world"-alimerkkijonon alkuindeksiarvo löytyy "hei maailma" -merkkijonosta:

indexOf('hello world', 'world')

Palauttaa tämän tuloksen: 6

kokonaisluku

Palauta merkkijonon kokonaislukuversio.

int('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Muunnettava merkkijono

Palautusarvo	Tyyppi	Kuvaus
<integer-result>	Integer	Määritetyn merkkijonon kokonaislukuversio

Esimerkki

Tämä esimerkki luo kokonaislukuversion merkkijonolle "10":

int('10')

Palauttaa tämän tuloksen: 10

json

Palauta JavaScript Object Notation (JSON) -tyyppiarvo tai -objekti merkkijonolle tai XML:lle.

json('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono tai XML	Muunnettava merkkijono tai XML

Palautusarvo	Tyyppi	Kuvaus
<JSON-result>	JSON:n alkuperäinen tyyppi tai objekti	JSON:n alkuperäinen tyyppiarvo tai objekti määritetylle merkkijonolle tai XML:lle. Jos merkkijono on tyhjäarvo, funktio palauttaa tyhjän objektin.

Esimerkki 1

Tässä esimerkissä tämä merkkijono muunnetaan JSON-arvoksi:

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

Palauttaa tämän tuloksen: [1, 2, 3]

Esimerkki 2

Tässä esimerkissä tämä merkkijono muunnetaan JSON-muotoon:

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

Palauttaa tämän tuloksen:

{
  "fullName": "Sophia Owen"
}

Esimerkki 3

Tässä esimerkissä tämä XML muunnetaan JSON-muotoon:

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

Palauttaa tämän tuloksen:

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

Risteys

Palauta kokoelma, jossa on vain määritettyjen kokoelmien yhteiset kohteet. Jotta kohde näkyy tuloksessa, sen täytyy näkyä kaikissa tähän funktioon välitetyissä kokoelmissa. Jos yhdellä tai useammalla tietokohteella on sama nimi, tuloksessa näkyy viimeinen kohde, jolla on sama nimi.

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

Parametri	Pakollinen	Type	Kuvaus
<collection1>, <collection2>, ...	Kyllä	Matriisi tai objekti, mutta ei molempia	Kokoelmat, joista haluat vain yhteiset kohteet

Palautusarvo	Tyyppi	Kuvaus
<common-items>	Matriisi tai objekti (vastaavassa järjestyksessä)	Kokoelma, jossa on vain määritettyjen kokoelmien yleisiä kohteita

Esimerkki

Tässä esimerkissä löytyvät yleiset kohteet seuraavista matriiseista:

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

Ja palauttaa matriisin, jossa on vain nämä kohteet: [1, 2]

join

Palauta merkkijono, jossa on kaikki matriisin kohteet ja jossa jokainen merkki on erotettu erottimella.

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

Parametri	Pakollinen	Type	Kuvaus
<Collection>	Kyllä	Matriisi	Matriisi, johon kohteet liitetään
<Erotin>	Kyllä	Merkkijono	Erotin, joka näkyy jokaisen tuloksena saatavan merkkijonon merkin välissä

Palautusarvo	Tyyppi	Kuvaus
<char1-erottimen><><char2-erotin...><>	Merkkijono	Tuloksena saatava merkkijono, joka on luotu kaikista määritetyn matriisin kohteista

Esimerkki

Tämä esimerkki luo merkkijonon kaikista tämän matriisin kohteista. Erottimena on määritetty merkki:

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

Palauttaa tämän tuloksen: "a.b.c"

Viimeinen

Palauta viimeinen kohde kokoelmasta.

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

Parametri	Pakollinen	Type	Kuvaus
<Collection>	Kyllä	Merkkijono tai matriisi	Kokoelma, josta löydät viimeisen kohteen

Palautusarvo	Tyyppi	Kuvaus
<last-collection-item>	Merkkijono tai matriisi	Kokoelman viimeinen kohde

Esimerkki

Näissä esimerkeissä etsitään näiden kokoelmien viimeinen kohde:

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

Palauttaa nämä tulokset:

Ensimmäinen esimerkki: "d"
Toinen esimerkki: 3

lastIndexOf

Palauta aloitussijainnit tai indeksiarvo alimerkkijonon viimeiselle esiintymälle. Tässä funktiossa ei kirjainkoko ole merkitsevä, ja indeksit alkavat luvusta 0.

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

Parametri	Pakollinen	Type	Kuvaus
<Teksti>	Kyllä	Merkkijono	Merkkijono, jonka alimerkkijonon haluat etsiä
<searchText>	Kyllä	Merkkijono	Etsittävä alimerkkijoki

Palautusarvo	Tyyppi	Kuvaus
<ending-index-value>	Integer	Määritetyn alimerkkijonon viimeisen esiintymän aloitussijainnin tai indeksiarvon. Jos merkkijonoa ei löydy, palauta luku -1.

Esimerkki

Tässä esimerkissä etsii aloitusindeksiarvon "world"-alimerkkijonon viimeiselle esiintymälle "hei maailma" -merkkijonossa:

lastIndexOf('hello world', 'world')

Palauttaa tämän tuloksen: 6

length

Palauta kokoelman kohteiden määrä.

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

Parametri	Pakollinen	Type	Kuvaus
<Collection>	Kyllä	Merkkijono tai matriisi	Kokoelma, jossa on laskettavia kohteita

Palautusarvo	Tyyppi	Kuvaus
<length-or-count>	Integer	Kokoelman kohteiden määrä

Esimerkki

Näissä esimerkeissä lasketaan näiden kokoelmien kohteiden määrä:

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

Palauta myös tämä tulos: 4

pienempi

Tarkista, onko ensimmäinen arvo pienempi kuin toinen arvo. Palauta arvo true, kun ensimmäinen arvo on pienempi, tai palauta epätosi, kun ensimmäinen arvo on suurempi.

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

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Kokonaisluku, liukuluku tai merkkijono	Ensimmäinen arvo, joka tarkistaa, onko pienempi kuin toinen arvo
<compareTo>	Kyllä	Kokonaisluku, liukuluku tai merkkijono	Vertailukohde

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Palauta arvo true, kun ensimmäinen arvo on pienempi kuin toinen arvo. Palauta epätosi, kun ensimmäinen arvo on yhtä suuri tai suurempi kuin toinen arvo.

Esimerkki

Näissä esimerkeissä tarkistetaan, onko ensimmäinen arvo pienempi kuin toinen arvo.

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

Palauta myös nämä tulokset:

Ensimmäinen esimerkki: true
Toinen esimerkki: false

lessOrEquals

Tarkista, onko ensimmäinen arvo pienempi tai yhtä suuri kuin toinen arvo. Palauta true, kun ensimmäinen arvo on pienempi tai yhtä suuri, tai palauta epätosi, kun ensimmäinen arvo on suurempi.

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

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Kokonaisluku, liukuluku tai merkkijono	Ensimmäinen arvo, joka tarkistaa, onko pienempi vai yhtä suuri kuin toinen arvo
<compareTo>	Kyllä	Kokonaisluku, liukuluku tai merkkijono	Vertailukohde

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Palauta arvo true, kun ensimmäinen arvo on pienempi tai yhtä suuri kuin toinen arvo. Palauta epätosi, kun ensimmäinen arvo on suurempi kuin toinen arvo.

Esimerkki

Näissä esimerkeissä tarkistetaan, onko ensimmäinen arvo pienempi tai yhtä suuri kuin toinen arvo.

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

Palauta myös nämä tulokset:

Ensimmäinen esimerkki: true
Toinen esimerkki: false

Max

Palauta suurin arvo luettelosta tai matriisissa numeroilla, jotka on sisältyvissä molemmissa päissä.

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

Parametri	Pakollinen	Type	Kuvaus
<number1>, <number2>, ...	Kyllä	Kokonaisluku, liukuluku tai molemmat	Lukujoukko, josta haluat suurimman arvon
[<number1>, <number2>, ...]	Kyllä	Matriisi – kokonaisluku, liukuluku tai molemmat	Lukumatriisi, josta haluat suurimman arvon

Palautusarvo	Tyyppi	Kuvaus
<max-value>	Kokonaisluku tai liukuluku	Määritetyn matriisin tai lukujoukon suurin arvo

Esimerkki

Nämä esimerkit saavat suurimman arvon lukujen ja matriisin joukosta:

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

Palauta myös tämä tulos: 3

min

Palauta pienin arvo lukujen tai matriisin joukosta.

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

Parametri	Pakollinen	Type	Kuvaus
<number1>, <number2>, ...	Kyllä	Kokonaisluku, liukuluku tai molemmat	Lukujen joukko, josta haluat pienimmän arvon
[<number1>, <number2>, ...]	Kyllä	Matriisi – kokonaisluku, liukuluku tai molemmat	Lukumatriisi, josta haluat pienimmän arvon

Palautusarvo	Tyyppi	Kuvaus
<min-value>	Kokonaisluku tai liukuluku	Määritetyn lukujoukon tai määritetyn matriisin pienin arvo

Esimerkki

Näistä esimerkeistä saat lukujen ja matriisin pienimmän arvon:

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

Palauta myös tämä tulos: 1

mod

Palauta jakojääne kahden numeron jakamisesta. Jos haluat saada kokonaislukutuloksen, katso div().

mod(<dividend>, <divisor>)

Parametri	Pakollinen	Type	Kuvaus
<Osinko>	Kyllä	Kokonaisluku tai liukuluku	Jakajalla jaettava luku
<Jakaja>	Kyllä	Kokonaisluku tai liukuluku	Luku, joka jakaa osingon, mutta ei voi olla 0.

Palautusarvo	Tyyppi	Kuvaus
<modulo-result>	Kokonaisluku tai liukuluku	Jakojäänistys ensimmäisen luvun jakamisesta toisella luvulla

Esimerkki

Tämä esimerkki jakaa ensimmäisen luvun toisella luvulla:

mod(3, 2)

Palauta myös tämä tulos: 1

Mul

Palauta tuote kahden numeron kertomisesta.

mul(<multiplicand1>, <multiplicand2>)

Parametri	Pakollinen	Type	Kuvaus
<multiplicand1>	Kyllä	Kokonaisluku tai liukuluku	Luku, joka kertomalla multiplicand2:lla
<kertolasku2>	Kyllä	Kokonaisluku tai liukuluku	Luku, joka monikertaistaaand1 :n

Palautusarvo	Tyyppi	Kuvaus
<product-result>	Kokonaisluku tai liukuluku	Tuote ensimmäisen luvun kertomisesta toisella luvulla

Esimerkki

Nämä esimerkit numeroi ensimmäisen numeron toisen luvun mukaan:

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

Palauta myös nämä tulokset:

Ensimmäinen esimerkki: 2
Toinen esimerkki 3

not

Tarkista, onko lauseke epätosi. Palauta arvo true, kun lauseke on epätosi, tai palauta epätosi, kun arvo on tosi.

not(<expression>)

Parametri	Pakollinen	Type	Kuvaus
<Ilmaisun>	Kyllä	Boolean	Tarkistettava lauseke

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Palauta arvo true, kun lauseke on epätosi. Palauta epätosi, kun lauseke on tosi.

Esimerkki 1

Seuraavissa esimerkeissä tarkistetaan, ovatko määritetyt lausekkeet epätosi:

not(false)
not(true)

Palauta myös nämä tulokset:

Ensimmäinen esimerkki: Lauseke on epätosi, joten funktio palauttaa arvon true.
Toinen esimerkki: lauseke on tosi, joten funktio palauttaa arvon false.

Esimerkki 2

Seuraavissa esimerkeissä tarkistetaan, ovatko määritetyt lausekkeet epätosi:

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

Palauta myös nämä tulokset:

Ensimmäinen esimerkki: Lauseke on epätosi, joten funktio palauttaa arvon true.
Toinen esimerkki: lauseke on tosi, joten funktio palauttaa arvon false.

or

Tarkista, onko vähintään yksi lauseke tosi. Palauta arvo true, kun vähintään yksi lauseke on tosi, tai palauta epätosi, kun molemmat ovat epätosi.

or(<expression1>, <expression2>)

Parametri	Pakollinen	Type	Kuvaus
<expression1>, <expression2>	Kyllä	Boolean	Tarkistettavat lausekkeet

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Palauta arvo true, kun vähintään yksi lauseke on tosi. Palauta epätosi, kun molemmat lausekkeet ovat epätosi.

Esimerkki 1

Seuraavissa esimerkeissä tarkistetaan, onko vähintään yksi lauseke tosi:

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

Palauta myös nämä tulokset:

Ensimmäinen esimerkki: Vähintään yksi lauseke on tosi, joten funktio palauttaa arvon true.
Toinen esimerkki: Kummankin lausekkeen arvo on epätosi, joten funktio palauttaa arvon false.

Esimerkki 2

Seuraavissa esimerkeissä tarkistetaan, onko vähintään yksi lauseke tosi:

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

Palauta myös nämä tulokset:

Ensimmäinen esimerkki: Vähintään yksi lauseke on tosi, joten funktio palauttaa arvon true.
Toinen esimerkki: Kummankin lausekkeen arvo on epätosi, joten funktio palauttaa arvon false.

Randi

Palauta satunnainen kokonaisluku määritetystä alueelta, joka on sisällyttävä vain alkupäästä.

rand(<minValue>, <maxValue>)

Parametri	Pakollinen	Type	Kuvaus
<minValue>	Kyllä	Integer	alueen pienin kokonaisluku
<maxValue>	Kyllä	Integer	Kokonaisluku, joka seuraa suurinta kokonaislukua sillä alueella, jonka funktio voi palauttaa.

Palautusarvo	Tyyppi	Kuvaus
<satunnaistulos>	Integer	Määritetyltä alueelta palautettu satunnainen kokonaisluku

Esimerkki

Tämä esimerkki hakee satunnaisen kokonaisluvun määritetyltä alueelta lukuun ottamatta enimmäisarvoa:

rand(1, 5)

Ja palauttaa tulokseksi jonkin näistä luvuista: 1, 2, 3tai 4

range

Palauta kokonaislukumatriisi, joka alkaa määritetystä kokonaisluvusta.

range(<startIndex>, <count>)

Parametri	Pakollinen	Type	Kuvaus
<startIndex>	Kyllä	Integer	Kokonaislukuarvo, joka aloittaa matriisin ensimmäisenä kohteena
<Laskea>	Kyllä	Integer	Kokonaislukujen määrä matriisissa

Palautusarvo	Tyyppi	Kuvaus
[<range-result>]	Matriisi	Kokonaislukuja sisältävä matriisi, joka alkaa määritetystä indeksistä

Esimerkki

Tämä esimerkki luo kokonaislukumatriisin, joka alkaa määritetystä indeksistä ja sisältää määritetyn määrän kokonaislukuja:

range(1, 4)

Palauttaa tämän tuloksen: [1, 2, 3, 4]

replace

Korvaa alimerkkijono määritetyllä merkkijonolla ja palauta tulosmerkkijono. Tässä funktiossa kirjainkoko on merkitsevä.

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

Parametri	Pakollinen	Type	Kuvaus
<Teksti>	Kyllä	Merkkijono	Merkkijono, jonka korvaava alimerkkijono on
<vanha teksti>	Kyllä	Merkkijono	Korvattava alimerkkijoki
<uusi teksti>	Kyllä	Merkkijono	Korvaava merkkijono

Palautusarvo	Tyyppi	Kuvaus
<päivitetty teksti>	Merkkijono	Päivitetty merkkijono alimerkkijonon korvaamisen jälkeen Jos alimerkkijonoa ei löydy, palauta alkuperäinen merkkijono.

Esimerkki

Tässä esimerkissä "vanha" alimerkkijono löytyy "vanhasta merkkijonosta" ja korvaa "vanha" tekstillä "uusi":

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

Palauttaa tämän tuloksen: "the new string"

skip

Poista kohteita kokoelman edustasta ja palauta kaikki muut kohteet.

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

Parametri	Pakollinen	Type	Kuvaus
<Collection>	Kyllä	Matriisi	Kokoelma, jonka kohteet haluat poistaa
<Laskea>	Kyllä	Integer	Positiivinen kokonaisluku edestä poistettavien kohteiden määrälle

Palautusarvo	Tyyppi	Kuvaus
[<updated-collection>]	Matriisi	Päivitetty kokoelma määritettyjen kohteiden poistamisen jälkeen

Esimerkki

Tämä esimerkki poistaa määritetyn matriisin edustasta yhden kohteen, luvun 0:

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

Palauttaa tämän matriisin, joka sisältää jäljellä olevat kohteet: [1,2,3]

split

Palauta alimerkkijonoja sisältävä matriisi pilkuilla eroteltuna alkuperäisen merkkijonon määritetyn erottimen perusteella.

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

Parametri	Pakollinen	Type	Kuvaus
<Teksti>	Kyllä	Merkkijono	Merkkijono, joka erotellaan alimerkkijonoksiin alkuperäisen merkkijonon määritetyn erottimen perusteella
<Erotin>	Kyllä	Merkkijono	Alkuperäisen merkkijonon merkki, jota käytetään erottimena

Palautusarvo	Tyyppi	Kuvaus
[<substring1,substring2><>,...]	Matriisi	Matriisi, joka sisältää alkuperäisen merkkijonon alimerkkijonoja pilkuilla eroteltuna

Esimerkki

Tämä esimerkki luo alimerkkijonoja sisältävän matriisin määritetystä merkkijonosta erottimena määritetyn merkin perusteella:

split('a_b_c', '_')

Palauttaa tämän matriisin tuloksena: ["a","b","c"]

startOfDay

Palauta aikaleima päivän alkuun.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<updated-timestamp>	Merkkijono	Määritetty aikaleima, joka alkaa päivän nollatuntimerkistä

Esimerkki

Tässä esimerkissä todetaan tämän aikaleiman päivän alku:

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

Palauttaa tämän tuloksen: "2018-03-15T00:00:00.0000000Z"

startOfHour

Palauta tunnin alku aikaleimalle.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<updated-timestamp>	Merkkijono	Määritetty aikaleima, joka alkaa tunnin nollaminuuttisen merkistä

Esimerkki

Tässä esimerkissä todetaan tunnin alku tälle aikaleimalle:

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

Palauttaa tämän tuloksen: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Palauta aikaleima kuukauden alkuun.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<updated-timestamp>	Merkkijono	Määritetty aikaleima, joka alkaa kuukauden ensimmäisestä päivästä nollatuntimerkinnällä

Esimerkki

Tämä esimerkki palauttaa tämän aikaleiman kuukauden alun:

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

Palauttaa tämän tuloksen: "2018-03-01T00:00:00.0000000Z"

startsWith

Tarkista, alkaako merkkijono tietyllä alimerkkijonolla. Palauta arvoksi true, kun alimerkkijoki löydetään, tai palauta epätosi, kun sitä ei löydy. Tässä funktiossa ei kirjainkoko ole merkitsevä.

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

Parametri	Pakollinen	Type	Kuvaus
<Teksti>	Kyllä	Merkkijono	Tarkistettava merkkijono
<searchText>	Kyllä	Merkkijono	Etsittävä aloitusmerkkijono

Palautusarvo	Tyyppi	Kuvaus
tosi tai epätosi	Boolean	Palauta arvoksi true, kun aloittava alimerkkijoni on löytynyt. Palauta epätosi, kun sitä ei löydy.

Esimerkki 1

Tässä esimerkissä tarkistetaan, alkaako "hei maailma" -merkkijono "hei"-alimerkkijonolla:

startsWith('hello world', 'hello')

Palauttaa tämän tuloksen: true

Esimerkki 2

Tässä esimerkissä tarkistetaan, alkaako "hei maailma" -merkkijono "greetings"-alimerkkijonolla:

startsWith('hello world', 'greetings')

Palauttaa tämän tuloksen: false

merkkijono

Palauta merkkijonoversio arvolle.

string(<value>)

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Any	Muunnettava arvo

Palautusarvo	Tyyppi	Kuvaus
<string-value>	Merkkijono	Määritetyn arvon merkkijonoversio

Esimerkki 1

Tämä esimerkki luo merkkijonoversion tälle luvulle:

string(10)

Palauttaa tämän tuloksen: "10"

Esimerkki 2

Tämä esimerkki luo merkkijonon määritetylle JSON-objektille ja käyttää kenoviivaa (\) lainausmerkin (") tilana.

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

Palauttaa tämän tuloksen: "{ \\"name\\": \\"Sophie Owen\\" }"

alikohde

Palauta tulos toisen luvun vähentämästä ensimmäisestä luvusta.

sub(<minuend>, <subtrahend>)

Parametri	Pakollinen	Type	Kuvaus
<minuend>	Kyllä	Kokonaisluku tai liukuluku	Luku, josta vähennys vähennetään
<vähennysvähennys>	Kyllä	Kokonaisluku tai liukuluku	Minuendista vähennettävä luku

Palautusarvo	Tyyppi	Description
<Tulos>	Kokonaisluku tai liukuluku	Tulos toisen luvun vähentämästä ensimmäisestä luvusta

Esimerkki

Tässä esimerkissä vähennetään toinen luku ensimmäisestä luvusta:

sub(10.3, .3)

Palauttaa tämän tuloksen: 10

Alimerkkijono

Palauta merkit merkkijonosta aloittaen määritetystä sijainnista tai indeksistä. Indeksiarvot alkavat luvusta 0.

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

Parametri	Pakollinen	Type	Kuvaus
<Teksti>	Kyllä	Merkkijono	Merkkijono, jonka merkkejä haluat
<startIndex>	Kyllä	Integer	Positiivinen luku, joka on vähintään 0 ja jota haluat käyttää aloitussijaintina tai indeksiarvona
<Pituus>	Kyllä	Integer	Positiivinen määrä merkkejä, jotka haluat alimerkkijonon.

Palautusarvo	Tyyppi	Kuvaus
<substring-result>	Merkkijono	Määritettyä merkkiä sisältävä alimerkkijono, joka alkaa määritetystä indeksisijainnista lähdemerkkijonossa

Esimerkki

Tämä esimerkki luo viisimerkkisen alimerkkijonon määritetystä merkkijonosta alkaen indeksiarvosta 6:

substring('hello world', 6, 5)

Palauttaa tämän tuloksen: "world"

subtractFromTime

Vähentää aikayksiköiden määrän aikaleimasta. Katso myös getPastTime.

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

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Merkkijono, joka sisältää aikaleiman
<Aikaväli>	Kyllä	Integer	vähennettävien määritettyjen aikayksiköiden määrä
<timeUnit>	Kyllä	Merkkijono	Aikayksikkö, jota käytetään aikavälin kanssa: "Sekunti", "Minuutti", "Tunti", "Päivä", "Viikko", "Kuukausi", "Vuosi"
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<updated-timestamp>	Merkkijono	Aikaleima vähennettynä määritetyllä aikayksiköiden määrällä

Esimerkki 1

Tässä esimerkissä vähennetään yksi päivä tästä aikaleimasta:

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

Palauttaa tämän tuloksen: "2018-01-01T00:00:00:0000000Z"

Esimerkki 2

Tässä esimerkissä vähennetään yksi päivä tästä aikaleimasta:

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

Ja palauttaa tämän tuloksen käyttämällä valinnaista D-muotoa: "Monday, January, 1, 2018"

take

Palauta kohteet kokoelman edestä.

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

Parametri	Pakollinen	Type	Kuvaus
<Collection>	Kyllä	Merkkijono tai matriisi	Kokoelma, jonka kohteita haluat
<Laskea>	Kyllä	Integer	Positiivinen kokonaisluku edustasta haluamiesi kohteiden määrälle

Palautusarvo	Tyyppi	Kuvaus
<alijoukko> tai [<alijoukko>]	Merkkijono tai matriisi	Merkkijono tai matriisi, jolla on määritetty määrä alkuperäisen kokoelman edustasta otettuja kohteita

Esimerkki

Nämä esimerkit saavat määritetyn määrän kohteita näiden kokoelmien edestä:

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

Palauta myös nämä tulokset:

Ensimmäinen esimerkki: "abc"
Toinen esimerkki: [0, 1, 2]

Punkit

Palauta määritetyn ticks aikaleiman ominaisuuden arvo. Jakoviittaus on 100 nanosekunnin päivitysväli.

ticks('<timestamp>')

Parametri	Pakollinen	Type	Kuvaus
<Aikaleima>	Kyllä	Merkkijono	Aikaleiman merkkijono

Palautusarvo	Tyyppi	Kuvaus
<jakoviivoja>	Integer	Klo 12.00:00 keskiyöstä, 1. tammikuuta 0001 jälkeen kuluneiden jaksojen määrä gregoriaaninen kalenterissa aikaleiman jälkeen

ToLower

Palauta merkkijono pienin kirjaimin. Jos merkkijonon meerillä ei ole pieniä kirjaimia sisältävää versiota, tämä merkki säilyy muuttumattomana palautetun merkkijonon kohdalla.

toLower('<text>')

Parametri	Pakollinen	Type	Kuvaus
<Teksti>	Kyllä	Merkkijono	Pienillä kirjaimilla palautettava merkkijono

Palautusarvo	Tyyppi	Kuvaus
<pienillä kirjaimilla kirjoitettu teksti>	Merkkijono	Alkuperäinen merkkijono pienin kirjaimin

Esimerkki

Tässä esimerkissä merkkijono muunnetaan pieniksi kirjaimiksi:

toLower('Hello World')

Palauttaa tämän tuloksen: "hello world"

ToUpper

Palauta merkkijono isoilla kirjaimilla. Jos merkkijonon meerillä ei ole isoa versiota, kyseinen merkki säilyy muuttumattomana palautetun merkkijonon kohdalla.

toUpper('<text>')

Parametri	Pakollinen	Type	Kuvaus
<Teksti>	Kyllä	Merkkijono	Isolla kirjaimella palautettava merkkijono

Palautusarvo	Tyyppi	Kuvaus
<isoilla kirjaimilla kirjoitettu teksti>	Merkkijono	Alkuperäinen merkkijono isoilla kirjaimilla

Esimerkki

Tässä esimerkissä merkkijono muunnetaan isoksi kirjaimeksi:

toUpper('Hello World')

Palauttaa tämän tuloksen: "HELLO WORLD"

Leikata

Poista alussa ja lopussa olevat välilyönnit merkkijonosta ja palauta päivitetty merkkijono.

trim('<text>')

Parametri	Pakollinen	Type	Kuvaus
<Teksti>	Kyllä	Merkkijono	Merkkijono, jonka alussa ja lopussa olevat välilyönnit on poistettava

Palautusarvo	Tyyppi	Kuvaus
<updatedText>	Merkkijono	Alkuperäisen merkkijonon päivitetty versio ilman alussa tai lopussa olevaa välilyöntiä

Esimerkki

Tämä esimerkki poistaa alussa ja lopussa olevat välilyönnit merkkijonosta " Hei maailma ":

trim(' Hello World  ')

Palauttaa tämän tuloksen: "Hello World"

Unionin

Palauta kokoelma, joka sisältää kaikki määritetyn kokoelman kohteet. Jos haluat nähdä tuloksen, kohde voi näkyä missä tahansa tähän funktioon välitetyssä kokoelmassa. Jos yhdellä tai useammalla tietokohteella on sama nimi, tuloksessa näkyy viimeinen kohde, jolla on sama nimi.

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

Parametri	Pakollinen	Type	Kuvaus
<collection1>, <collection2>, ...	Kyllä	Matriisi tai objekti, mutta ei molempia	Kokoelmat, joista haluat kaikki kohteet

Palautusarvo	Tyyppi	Kuvaus
<updatedCollection>	Matriisi tai objekti (vastaavassa järjestyksessä)	Kokoelma, joka sisältää kaikki määritetyn kokoelman kohteet – ei kaksoiskappaleita

Esimerkki

Tämä esimerkki hakee kaikki kohteet näistä kokoelmista:

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

Palauttaa tämän tuloksen: [1, 2, 3, 10, 101]

URIComponent

Palauta merkkijonolle URI-koodattu uniform resource identifier -versio korvaamalla URL-osoitteettomat merkit escape-merkeillä. Käytä tätä funktiota encodeUriComponent()-funktion sijaan. Vaikka molemmat funktiot toimivat samalla tavalla, uriComponent() on suositeltavaa.

uriComponent('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	URI-koodattuun muotoon muunnettava merkkijono

Palautusarvo	Tyyppi	Kuvaus
<encoded-URI>	Merkkijono	URI-koodattu merkkijono, jossa on ohjausmerkkejä

Esimerkki

Tämä esimerkki luo URI-koodatun version tälle merkkijonolle:

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

Palauttaa tämän tuloksen: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Palauta URI-komponentin binaariversio.

uriComponentToBinary('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Muunnettava URI-koodattu merkkijono

Palautusarvo	Tyyppi	Kuvaus
<binary-for-encoded-URI>	Merkkijono	URI-koodatun merkkijonon binaariversio. Binaarisisältö on base64-koodattu ja sitä edustaa `$content`.

Esimerkki

Tämä esimerkki luo binaariversion tälle URI-koodatulle merkkijonolle:

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

Palauttaa tämän tuloksen:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

URIComponentToString

Palauta URI-koodatun merkkijonon (Uniform Resource Identifier) merkkijonoversio, käytännössä URI-koodatun merkkijonon koodaus.

uriComponentToString('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	URI-koodattu merkkijono, jonka koodaus puretaan

Palautusarvo	Tyyppi	Kuvaus
<decoded-URI>	Merkkijono	URI-koodatun merkkijonon poistettu versio

Esimerkki

Tämä esimerkki luo URI-koodatun merkkijonon koodatun version:

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

Palauttaa tämän tuloksen: "https://contoso.com"

utcNow

Palauta nykyinen aikaleima.

utcNow('<format>')

Vaihtoehtoisesti voit määrittää muotoparametrilla <> eri muodon.

Parametri	Pakollinen	Type	Kuvaus
<Muodossa>	Ei	Merkkijono	Joko yksittäinen muotomäärite tai mukautettu muotoilumalli. Aikaleiman oletusmuoto on "o" (vv-KK-ppTHH:mm:ss.fffffK), joka noudattaa ISO 8601 -standardia ja säilyttää aikavyöhyketiedot.

Palautusarvo	Tyyppi	Kuvaus
<current-timestamp>	Merkkijono	Nykyinen päivämäärä ja aika

Esimerkki 1

Oletetaan, että tänään on 15. huhtikuuta 2018 klo 13.00.00. Tästä esimerkistä saadaan nykyinen aikaleima:

utcNow()

Palauttaa tämän tuloksen: "2018-04-15T13:00:00.0000000Z"

Esimerkki 2

Oletetaan, että tänään on 15. huhtikuuta 2018 klo 13.00.00. Tämä esimerkki hakee nykyisen aikaleiman käyttämällä valinnaista D-muotoa:

utcNow('D')

Palauttaa tämän tuloksen: "Sunday, April 15, 2018"

xml

Palauta JSON-objektin sisältävän merkkijonon XML-versio.

xml('<value>')

Parametri	Pakollinen	Type	Kuvaus
<arvo>	Kyllä	Merkkijono	Muunnettava merkkijono JSON-objektilla JSON-objektilla on oltava vain yksi pääominaisuus, joka ei voi olla matriisi. Käytä kenoviivaa (\) escape-merkkinä lainausmerkille (").

Palautusarvo	Tyyppi	Kuvaus
<xml-versio>	Object	Määritetyn merkkijonon tai JSON-objektin koodattu XML

Esimerkki 1

Tämä esimerkki luo tämän merkkijonon XML-version, joka sisältää JSON-objektin:

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

Palauttaa tämän tuloksen XML:n:

<name>Sophia Owen</name>

Esimerkki 2

Oletetaan, että sinulla on tämä JSON-objekti:

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

Tämä esimerkki luo XML:n merkkijonolle, joka sisältää tämän JSON-objektin:

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

Palauttaa tämän tuloksen XML:n:

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

Xpath

Tarkista XML:stä solmut tai arvot, jotka vastaavat XPath (XML Path Language) -lauseketta, ja palauta vastaavat solmut tai arvot. XPath-lauseke tai vain "XPath" auttaa navigoimaan XML-asiakirjan rakenteessa siten, että voit valita solmuja tai käsittelyarvoja XML-sisällössä.

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

Parametri	Pakollinen	Type	Kuvaus
<Xml>	Kyllä	Any	XML-merkkijono, jolla haetaan XPath-lausekkeen arvoa vastaavia solmuja tai arvoja
<Xpath>	Kyllä	Any	XPath-lauseke, jota käytetään etsimään vastaavat XML-solmut tai -arvot

Palautusarvo	Tyyppi	Kuvaus
<xml-node>	XML	XML-solmu, kun vain yksi solmu vastaa määritettyä XPath-lauseketta
<arvo>	Any	ARVO XML-solmusta, kun vain yksittäinen arvo vastaa määritettyä XPath-lauseketta
[<xml-node1>, <xml-node2>, ...] -or- [<arvo1>, <arvo2>, ...]	Matriisi	Matriisi, jossa on XML-solmuja tai arvoja, jotka vastaavat määritettyä XPath-lauseketta

Esimerkki 1

Esimerkissä 1 tässä esimerkissä löydetään solmuja vastaavat <count></count> solmut ja lisätään solmuarvot funktioon sum() :

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

Palauttaa tämän tuloksen: 30

Esimerkki 2

Tässä esimerkissä molemmat lausekkeet löytävät solmuja, jotka vastaavat <location></location> solmua, määritetyissä argumenteissa, jotka sisältävät XML:n ja nimitilan. Lausekkeet käyttävät kenoviivaa (\) lainausmerkin (") tilanvaihtomerkkinä.

Lauseke 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\"]')

Tässä ovat argumentit:

Tämä XML- tiedosto, joka sisältää XML-tiedoston nimitilan: xmlns="http://contoso.com"

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

Jompikumpi XPath-lauseke täältä:
- /*[name()=\"file\"]/*[name()=\"location\"]
- /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

Tässä on tulossolmu, joka vastaa solmua <location></location> :

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

Esimerkki 3

Seuraavassa esimerkissä 3 tämä esimerkki löytää arvon solmusta <location></location> :

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

Palauttaa tämän tuloksen: "Paris"

Muistiinpano

Voit lisätä kommentteja tietovuon lausekkeisiin, mutta ei putkilausekkeisiin.

Ohjeet parametrien yleiseen käyttöön ovat artikkelissa Data Factory in Fabric -tehtaan parametrit

Jaa

Microsoft Fabricin Data Factoryn lausekkeet ja funktiot

Lausekkeet

Esimerkit

Esimerkki monimutkaisesta lausekkeesta

Dynaaminen sisältöeditori

Erikoismerkkien korvaaminen

Ohjausmerkki heittomerkki

Putken vaikutusalueen muuttujat

Funktiot

Päivämääräfunktiot

Merkkijonofunktiot

Kokoelmafunktiot

Loogiset toiminnot

Muuntofunktiot

Matemaattiset funktiot

Funktioviittaus

Lisää

addDays

lisää tunnit

addMinutes

addSeconds

addToTime

ja

matriisi

perus64

base64ToBinary

base64ToString

Binary

bool

coalesce

concat

sisältää

convertFromUtc

convertTimeZone

convertToUtc

createArray

dataUri

dataUriToBinary

dataUriToString

dayOfMonth

dayOfWeek

dayOfYear

decodeBase64

decodeDataUri

decodeUriComponent

Div

encodeUriComponent

tyhjä

endsWith

on yhtä suuri kuin

Ensimmäinen

liukuluku

formatDateTime

getFutureTime

getPastTime

suurempi

greaterOrEquals

Guid

if

indexOf

kokonaisluku

json

Risteys

join

Viimeinen

lastIndexOf

length

pienempi

lessOrEquals

Max

min

mod

Mul

not

or

Randi

range

replace

skip