Uttrykk og funksjoner for Data Factory i Microsoft Fabric

  • Artikkel

Denne artikkelen inneholder detaljer om uttrykk og funksjoner som støttes av Data Factory i Microsoft Fabric.

Uttrykk

Uttrykksverdier i definisjonen kan være litterale eller uttrykk som evalueres ved kjøretid. Eksempel:

"value"

or

"@pipeline().parameters.password"

Uttrykk kan vises hvor som helst i en strengverdi og alltid resultere i en annen strengverdi. Hvis en verdi er et uttrykk, trekkes brødteksten i uttrykket ut ved å fjerne vedtegnet (@). Hvis en litteral streng er nødvendig som starter med @, må den slippes ut ved hjelp av @@. Eksemplene nedenfor viser hvordan uttrykk evalueres.

Uttrykksverdi Resultat
"parametere" Tegnene parametere returneres.
"parametere[1]" Tegnene 'parametere[1]' returneres.
"@@" En 1 tegnstreng som inneholder @, returneres.
" @" En 2 tegnstreng som inneholder @ returneres.

Uttrykk kan også vises i strenger ved hjelp av en funksjon som kalles streng interpolering der uttrykk er pakket inn @{ ... }. Eksempel: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Ved hjelp av streng interpolering er resultatet alltid en streng. La oss si at jeg har definert myNumber som 42 og myString som foo:

Uttrykksverdi Resultat
"@pipeline().parametere.myString" Returnerer foo som en streng.
"@{pipeline().parametere.myString}" Returnerer foo som en streng.
"@pipeline().parametere.myNumber" Returnerer 42 som et tall.
"@{pipeline().parametere.myNumber}" Returnerer 42 som en streng.
"Svaret er: @{pipeline().parameters.myNumber}" Returnerer strengen Answer is: 42.
"@concat('Svar er: ', string(pipeline().parameters.myNumber))" Returnerer strengen Answer is: 42
"Svaret er: @@{pipeline().parameters.myNumber}" Returnerer strengen Answer is: @{pipeline().parameters.myNumber}.

I kontrollflytaktiviteter som ForEach-aktivitet kan du angi en matrise som skal itereres over for egenskapselementene og brukes @item() til å gjentakelse over én enkelt opplisting i ForEach-aktivitet. Hvis for eksempel elementer er en matrise: [1, 2, 3], @item() returnerer 1 i den første gjentakelsen, 2 i den andre gjentakelsen og 3 i den tredje gjentakelsen. Du kan også bruke @range(0,10) som uttrykk til å gjentakelse 10 ganger fra og med 0 som slutter med 9.

Du kan bruke @activity(aktivitetsnavn) til å registrere utdata for aktivitet og ta avgjørelser. Vurder en nettaktivitet kalt Web1. For å plassere utdataene for den første aktiviteten i brødteksten i den andre, ser uttrykket vanligvis ut: @activity(Web1).utdata eller @activity(Web1).output.data eller noe lignende avhengig av hvordan utdataene fra den første aktiviteten ser ut.

Eksempler

Eksempel på komplekst uttrykk

Eksemplet nedenfor viser et komplekst eksempel som refererer til et dypt delfelt med aktivitetsutdata. Hvis du vil referere til en datasamlebåndparameter som evalueres til et delfelt, bruker du [] syntaks i stedet for punkt(.)-operator (som i tilfelle underfelt1 og underfelt2), som en del av en aktivitetsutdata.

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

Det er vanlig å opprette filer dynamisk og navngi dem. La oss utforske noen dynamiske eksempler på navngiving av filer.

  • Tilføy dato til et filnavn: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
  • Tilføy DateTime i kundens tidssone: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
  • Tilføy utløsertid: @concat('Test_', pipeline().TriggerTime)
  • Sender ut et egendefinert filnavn i en Dataflyt ved utdata til én enkelt fil med dato:'Test_' + toString(currentDate()) + '.csv'

I tilfeller ovenfor opprettes fire dynamiske filnavn fra og med Test_.

Dynamisk redigeringsprogram for innhold

Det dynamiske innholdsredigeringsprogrammet slipper automatisk ut tegn i innholdet når du er ferdig med å redigere. Følgende innhold i innholdsredigeringsprogrammet er for eksempel en streng interpolering med en uttrykksfunksjon.

"@{toUpper('myData')}"

Redigeringsprogrammet for dynamisk innhold konverterer innhold over til uttrykk "@{toUpper('myData')}". Resultatet av dette uttrykket er den formaterte strengen nedenfor.

"MYDATA"

Erstatte spesialtegn

Redigeringsprogrammet for dynamisk innhold unnslipper automatisk tegn som dobbelt anførselstegn, omvendt skråstrek i innholdet når du er ferdig med redigeringen. Dette fører til problemer hvis du vil erstatte linjefeed eller fane ved hjelp av \n, \t i replace()-funksjonen. Du kan redigere det dynamiske innholdet i kodevisning for å fjerne det ekstra \ i uttrykket, eller du kan følge fremgangsmåten nedenfor for å erstatte spesialtegn ved hjelp av uttrykksspråk:

  1. URL-kode mot den opprinnelige strengverdien
  2. Erstatt url-kodet streng, for eksempel linjefeed (%0A), retur(%0D), vannrett tabulator(%09).
  3. URL-dekoding

Variabel companyName med et nytt linjebundet tegn i verdien, kan for eksempel uttrykket @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) fjerne det nye linjebundne tegnet.

Contoso- Corporation

Rømmer fra enkelt anførselstegn

Uttrykksfunksjoner bruker enkelt anførselstegn for strengverdiparametere. Bruk to enkle anførselstegn til å unnslippe et ' tegn i strengfunksjoner. Uttrykket @concat('Baba', '''s ', 'book store') kommer for eksempel tilbake under resultatet.

Baba's book store

Variabler for datasamlebånd

Disse systemvariablene kan refereres hvor som helst i datasamlebåndet.

Variabelnavn Bekrivelse
@pipeline().DataFactory Navnet på dataene eller Synapse-arbeidsområdet som datasamlebåndet kjører i
@pipeline().Pipeline Navnet på datasamlebåndet
@pipeline().RunId ID for den spesifikke datasamlebåndkjøringen
@pipeline().TriggerId ID for utløseren som startet datasamlebåndet
@pipeline().TriggerName Navnet på utløseren som startet datasamlebåndet
@pipeline().TriggerTime Tidspunktet for utløserkjøringen som startet datasamlebåndet. Dette er tidspunktet da utløseren faktisk ble avfyrt for å starte datasamlebåndkjøringen, og det kan avvike litt fra utløserens planlagte tid.
@pipeline().GroupId ID for gruppen som datasamlebåndkjøring tilhører.
@pipeline()?. TriggeredByPipelineName Navnet på datasamlebåndet som utløser datasamlebåndkjøringen. Gjelder når datasamlebåndkjøringen utløses av en ExecutePipeline-aktivitet. Evaluer til Null når den brukes i andre tilfeller. Legg merke til spørsmålstegnet etter @pipeline()
@pipeline()?. TriggeredByPipelineRunId Kjør ID for datasamlebåndet som utløser datasamlebåndkjøringen. Gjelder når datasamlebåndkjøringen utløses av en ExecutePipeline-aktivitet. Evaluer til Null når den brukes i andre tilfeller. Legg merke til spørsmålstegnet etter @pipeline()

Merk

Utløserrelaterte systemvariabler for dato/klokkeslett (i både datasamlebånd og utløseromfang) returnerer UTC-datoer i ISO 8601-format, for eksempel 2017-06-01T22:20:00.4061448Z.

Funksjoner

Du kan kalle opp funksjoner i uttrykk. Avsnittene nedenfor inneholder informasjon om funksjonene som kan brukes i et uttrykk.

Datofunksjoner

Dato- eller klokkeslettfunksjon Oppgave
addDays Legg til et antall dager i et tidsstempel.
addHours Legg til et antall timer i et tidsstempel.
addMinutes Legg til et antall minutter i et tidsstempel.
addSeconds Legg til et antall sekunder i et tidsstempel.
addToTime Legg til et antall tidsenheter i et tidsstempel. Se også getFutureTime.
convertFromUtc Konverter et tidsstempel fra Universal Time Coordinated (UTC) til måltidssonen.
convertTimeZone Konverter et tidsstempel fra kildetidssonen til måltidssonen.
convertToUtc Konverter et tidsstempel fra kildetidssonen til Universal Time Coordinated (UTC).
dayOfMonth Returner dag for månedskomponenten fra et tidsstempel.
dayOfWeek Returner ukedagkomponenten fra et tidsstempel.
dayOfYear Returner dagen i året-komponenten fra et tidsstempel.
formatDateTime Returner tidsstempelet som en streng i valgfritt format.
getFutureTime Returner gjeldende tidsstempel pluss de angitte tidsenhetene. Se også addToTime.
getPastTime Returner gjeldende tidsstempel minus de angitte tidsenhetene. Se også subtractFromTime.
startOfDay Returner starten på dagen for et tidsstempel.
startOfHour Returner starten på timen for et tidsstempel.
startOfMonth Returner starten av måneden for et tidsstempel.
subtractFromTime Trekk fra et antall tidsenheter fra et tidsstempel. Se også getPastTime.
Flått Returner egenskapsverdien ticks for et angitt tidsstempel.
utcNow Returner gjeldende tidsstempel som en streng.

Strengfunksjoner

Hvis du vil arbeide med strenger, kan du bruke disse strengfunksjonene og også noen samlingsfunksjoner. Strengfunksjoner fungerer bare på strenger.

Strengfunksjon Oppgave
Concat Kombiner to eller flere strenger, og returner den kombinerte strengen.
endsWith Kontroller om en streng slutter med den angitte delstrengen.
Guid Generer en globalt unik identifikator (GUID) som en streng.
indexOf Returner startposisjonen for en delstreng.
lastIndexOf Returner startposisjonen for den siste forekomsten av en delstreng.
replace Erstatt en delstreng med den angitte strengen, og returner den oppdaterte strengen.
split Returner en matrise som inneholder delstrenger, atskilt med komma, fra en større streng basert på et angitt skilletegn i den opprinnelige strengen.
startsWith Kontroller om en streng starter med en bestemt delstreng.
Delstreng Returner tegn fra en streng, fra den angitte plasseringen.
toLower Returner en streng med små bokstaver.
toUpper Returner en streng med store bokstaver.
Trim Fjern innledende og etterfølgende mellomrom fra en streng, og returner den oppdaterte strengen.

Innsamlingsfunksjoner

Hvis du vil arbeide med samlinger, vanligvis matriser, strenger og noen ganger ordlister, kan du bruke disse samlingsfunksjonene.

Samlingsfunksjon Oppgave
Inneholder Kontroller om en samling har et bestemt element.
empty Kontroller om en samling er tom.
Første Returner det første elementet fra en samling.
Skjæringspunktet mellom Returner en samling som bare har de vanlige elementene på tvers av de angitte samlingene.
Delta Returner en streng som har alle elementene fra en matrise, atskilt med det angitte tegnet.
Siste Returner det siste elementet fra en samling.
Lengde Returner antall elementer i en streng eller matrise.
Hoppe over Fjern elementer fra forsiden av en samling, og returner alle de andre elementene.
Ta Returner elementer fra forsiden av en samling.
Union Returner en samling som har alle elementene fra de angitte samlingene.

Logiske funksjoner

Disse funksjonene er nyttige innenfor betingelser, de kan brukes til å evaluere alle typer logikk.

Logisk sammenligningsfunksjon Oppgave
and Kontroller om alle uttrykk er sanne.
Tilsvarer Kontroller om begge verdiene er like.
greater Kontroller om den første verdien er større enn den andre verdien.
greaterOrEquals Kontroller om den første verdien er større enn eller lik den andre verdien.
Hvis Kontroller om et uttrykk er sant eller usant. Hvis du er basert på resultatet, returnerer du en angitt verdi.
less Kontroller om den første verdien er mindre enn den andre verdien.
lessOrEquals Kontroller om den første verdien er mindre enn eller lik den andre verdien.
Ikke Kontroller om et uttrykk er usant.
or Kontroller om minst ett uttrykk er sant.

Konverteringsfunksjoner

Disse funksjonene brukes til å konvertere mellom hver av de opprinnelige typene på språket:

  • streng
  • integer
  • flyttall
  • boolean
  • Matriser
  • Ordbøker
Konverteringsfunksjon Oppgave
Matrise Returner en matrise fra én enkelt angitt inndata. Hvis du vil ha flere inndata, kan du se createArray.
base64 Returner den base64-kodede versjonen for en streng.
base64ToBinary Returner binærversjonen for en base64-kodet streng.
base64ToString Returner strengversjonen for en base64-kodet streng.
Binære Returner binærversjonen for en inndataverdi.
Bool Returner den boolske versjonen for en inndataverdi.
Koaliserer Returner den første verdien som ikke er null fra én eller flere parametere.
createArray Returner en matrise fra flere inndata.
dataUri Returner data-URI-en for en inndataverdi.
dataUriToBinary Returner binærversjonen for en data-URI.
dataUriToString Returner strengversjonen for en data-URI.
decodeBase64 Returner strengversjonen for en base64-kodet streng.
decodeDataUri Returner binærversjonen for en data-URI.
decodeUriComponent Returner en streng som erstatter escape-tegn med dekodede versjoner.
kodeUriComponent Returner en streng som erstatter url-usikre tegn med escape-tegn.
Flyte Returner et flyttall for en inndataverdi.
Int Returner heltallsversjonen for en streng.
Streng Returner strengversjonen for en inndataverdi.
uriComponent Returner den URI-kodede versjonen for en inndataverdi ved å erstatte url-usikre tegn med escape-tegn.
uriComponentToBinary Returner binærversjonen for en URI-kodet streng.
uriComponentToString Returner strengversjonen for en URI-kodet streng.
Xml Returner XML-versjonen for en streng.
Xpath Kontroller XML for noder eller verdier som samsvarer med et XPath-uttrykk (XML Path Language), og returner de samsvarende nodene eller verdiene.

Matematiske funksjoner

Disse funksjonene kan brukes for begge typer tall: heltall og flyter.

Matematikk (funksjon) Oppgave
Legge Returner resultatet fra å legge til to tall.
Div Returner resultatet fra å dele to tall.
Maks Returner den høyeste verdien fra et sett med tall eller en matrise.
Min Returner den laveste verdien fra et sett med tall eller en matrise.
Mod Returner resten fra å dele to tall.
mul Returner produktet fra å multiplisere to tall.
Rand Returner et tilfeldig heltall fra et angitt område.
range Returner en heltallmatrise som starter fra et angitt heltall.
Sub Returner resultatet fra å trekke det andre tallet fra det første tallet.

Funksjonsreferanse

Denne delen viser alle tilgjengelige funksjoner i alfabetisk rekkefølge.

Legge

Returner resultatet fra å legge til to tall.

add(<summand_1>, <summand_2>)
Parameter Kreves Type Bekrivelse
<>summand_1, <summand_2> Ja Heltall, flyt eller blandet Tallene som skal legges til
Returverdi Type Bekrivelse
<resultatsum> Heltall eller flyt Resultatet av å legge til de angitte tallene

Eksempel

Dette eksemplet legger til de angitte tallene:

add(1, 1.5)

Og returnerer dette resultatet: 2.5

addDays

Legg til et antall dager i et tidsstempel.

addDays('<timestamp>', <days>, '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<Dager> Ja Integer Det positive eller negative antallet dager som skal legges til
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<oppdatert tidsstempel> Streng Tidsstempelet pluss det angitte antallet dager

Eksempel 1

Dette eksemplet legger til 10 dager i det angitte tidsstempelet:

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

Og returnerer dette resultatet: "2018-03-25T00:00:0000000Z"

Eksempel 2

Dette eksemplet trekker fem dager fra det angitte tidsstempelet:

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

Og returnerer dette resultatet: "2018-03-10T00:00:0000000Z"

addHours

Legg til et antall timer i et tidsstempel.

addHours('<timestamp>', <hours>, '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<Timer> Ja Integer Positivt eller negativt antall timer som skal legges til
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<oppdatert tidsstempel> Streng Tidsstempelet pluss det angitte antall timer

Eksempel 1

Dette eksemplet legger til 10 timer i det angitte tidsstempelet:

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

Og returnerer dette resultatet: "2018-03-15T10:00:0000000Z"

Eksempel 2

Dette eksemplet trekker fem timer fra det angitte tidsstempelet:

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

Og returnerer dette resultatet: "2018-03-15T10:00:0000000Z"

addMinutes

Legg til et antall minutter i et tidsstempel.

addMinutes('<timestamp>', <minutes>, '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<Minutter> Ja Integer Positivt eller negativt antall minutter å legge til
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<oppdatert tidsstempel> Streng Tidsstempelet pluss det angitte antallet minutter

Eksempel 1

Dette eksemplet legger til 10 minutter i det angitte tidsstempelet:

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

Og returnerer dette resultatet: "2018-03-15T00:20:00.0000000Z"

Eksempel 2

Dette eksemplet trekker fem minutter fra det angitte tidsstempelet:

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

Og returnerer dette resultatet: "2018-03-15T00:15:00.0000000Z"

addSeconds

Legg til et antall sekunder i et tidsstempel.

addSeconds('<timestamp>', <seconds>, '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<Sekunder> Ja Integer Positivt eller negativt antall sekunder du vil legge til
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<oppdatert tidsstempel> Streng Tidsstempelet pluss angitt antall sekunder

Eksempel 1

Dette eksemplet legger til 10 sekunder i det angitte tidsstempelet:

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

Og returnerer dette resultatet: "2018-03-15T00:00:10.0000000Z"

Eksempel 2

Dette eksemplet trekker fem sekunder til det angitte tidsstempelet:

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

Og returnerer dette resultatet: "2018-03-15T00:00:25.0000000Z"

addToTime

Legg til et antall tidsenheter i et tidsstempel. Se også getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<Intervall> Ja Integer Antall angitte tidsenheter som skal legges til
<timeUnit> Ja Streng Tidsenheten som skal brukes med intervall: «Sekund», «Minutt», «Time», «Dag», «Uke», «Måned», «År»
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<oppdatert tidsstempel> Streng Tidsstempelet pluss det angitte antallet tidsenheter

Eksempel 1

Dette eksemplet legger til én dag i det angitte tidsstempelet:

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

Og returnerer dette resultatet: "2018-01-02T00:00:00.0000000Z"

Eksempel 2

Dette eksemplet legger til én dag i det angitte tidsstempelet:

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

Og returnerer resultatet ved hjelp av det valgfrie «D»-formatet: "Tuesday, January 2, 2018"

og

Kontroller om begge uttrykkene er sanne. Returner sann når begge uttrykkene er sanne, eller returner usann når minst ett uttrykk er usann.

and(<expression1>, <expression2>)
Parameter Kreves Type Bekrivelse
<uttrykk1>, <uttrykk2> Ja Boolean Uttrykkene som skal kontrolleres
Returverdi Type Bekrivelse
sann eller usann Boolean Returner sann når begge uttrykkene er sanne. Returner usann når minst ett uttrykk er usann.

Eksempel 1

Disse eksemplene kontrollerer om de angitte boolske verdiene begge er sanne:

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

Og returnerer disse resultatene:

  • Første eksempel: Begge uttrykkene er sanne, så returnerer true.
  • Andre eksempel: Ett uttrykk er usann, så returnerer false.
  • Tredje eksempel: Begge uttrykkene er usann, så returnerer false.

Eksempel 2

Disse eksemplene kontrollerer om de angitte uttrykkene begge er sanne:

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

Og returnerer disse resultatene:

  • Første eksempel: Begge uttrykkene er sanne, så returnerer true.
  • Andre eksempel: Ett uttrykk er usann, så returnerer false.
  • Tredje eksempel: Begge uttrykkene er usann, så returnerer false.

matrise

Returner en matrise fra én enkelt angitt inndata. Hvis du vil ha flere inndata, kan du se createArray().

array('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Strengen for å opprette en matrise
Returverdi Type Bekrivelse
[<verdi>] Matrise En matrise som inneholder enkelt angitte inndata

Eksempel

Dette eksemplet oppretter en matrise fra «hallo»-strengen:

array('hello')

Og returnerer dette resultatet: ["hello"]

base64

Returner den base64-kodede versjonen for en streng.

base64('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Inndatastrengen
Returverdi Type Bekrivelse
<base64-streng> Streng Den base64-kodede versjonen for inndatastrengen

Eksempel

Dette eksemplet konverterer «hallo»-strengen til en base64-kodet streng:

base64('hello')

Og returnerer dette resultatet: "aGVsbG8="

base64ToBinary

Returner binærversjonen for en base64-kodet streng.

base64ToBinary('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Den base64-kodede strengen som skal konverteres
Returverdi Type Bekrivelse
<binær-for-base64-streng> Streng Binærversjonen for den base64-kodede strengen

Eksempel

Dette eksemplet konverterer den base64-kodede strengen «aGVsbG8=» til en binær streng:

base64ToBinary('aGVsbG8=')

Og returnerer dette resultatet:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Returner strengversjonen for en base64-kodet streng, som effektivt dekoder base64-strengen. Bruk denne funksjonen i stedet for decodeBase64(). Selv om begge funksjonene fungerer på samme måte, base64ToString() foretrekkes.

base64ToString('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Den base64-kodede strengen som skal dekodes
Returverdi Type Bekrivelse
<dekodet base64-streng> Streng Strengversjonen for en base64-kodet streng

Eksempel

Dette eksemplet konverterer den base64-kodede strengen «aGVsbG8=» til bare en streng:

base64ToString('aGVsbG8=')

Og returnerer dette resultatet: "hello"

Binære

Returner binærversjonen for en streng.

binary('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Strengen som skal konverteres
Returverdi Type Bekrivelse
<binær-for-inndata-verdi> Streng Binærversjonen for den angitte strengen

Eksempel

Dette eksemplet konverterer «hallo»-strengen til en binær streng:

binary('hello')

Og returnerer dette resultatet:

"0110100001100101011011000110110001101111"

boolsk

Returner den boolske versjonen for en verdi.

bool(<value>)
Parameter Kreves Type Bekrivelse
<Verdi> Ja Any Verdien som skal konverteres
Returverdi Type Bekrivelse
sann eller usann Boolean Boolsk versjon for den angitte verdien

Eksempel

Disse eksemplene konverterer de angitte verdiene til boolske verdier:

bool(1)
bool(0)

Og returnerer disse resultatene:

  • Første eksempel: true
  • Andre eksempel: false

Koaliserer

Returner den første verdien som ikke er null fra én eller flere parametere. Tomme strenger, tomme matriser og tomme objekter er ikke null.

coalesce(<object_1>, <object_2>, ...)
Parameter Kreves Type Bekrivelse
<>object_1, <object_2>, ... Ja Alle, kan blande typer Ett eller flere elementer å se etter null
Returverdi Type Bekrivelse
<første-ikke-null-element> Any Det første elementet eller verdien som ikke er null. Hvis alle parameterne er null, returnerer denne funksjonen null.

Eksempel

Disse eksemplene returnerer den første verdien som ikke er null fra de angitte verdiene, eller null når alle verdiene er null:

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

Og returnerer disse resultatene:

  • Første eksempel: true
  • Andre eksempel: "hello"
  • Tredje eksempel: null

concat

Kombiner to eller flere strenger, og returner den kombinerte strengen.

concat('<text1>', '<text2>', ...)
Parameter Kreves Type Bekrivelse
<text1>, <text2>, ... Ja Streng Minst to strenger å kombinere
Returverdi Type Bekrivelse
<text1text2...> Streng Strengen som er opprettet fra de kombinerte inndatastrengene

Eksempel

Dette eksemplet kombinerer strengene "Hello" og "World":

concat('Hello', 'World')

Og returnerer dette resultatet: "HelloWorld"

Inneholder

Kontroller om en samling har et bestemt element. Returner sann når elementet blir funnet, eller returner usann når det ikke blir funnet. Denne funksjonen skiller mellom store og små bokstaver.

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

Denne funksjonen fungerer spesielt på disse samlingstypene:

  • En streng for å finne en delstreng
  • En matrise for å finne en verdi
  • En ordliste for å finne en nøkkel
Parameter Kreves Type Bekrivelse
<Samling> Ja Streng, matrise eller ordliste Samlingen som skal kontrolleres
<Verdi> Ja Henholdsvis streng, matrise eller ordliste Elementet du vil finne
Returverdi Type Bekrivelse
sann eller usann Boolean Returner sann når elementet blir funnet. Returner usann når den ikke ble funnet.

Eksempel 1

Dette eksemplet kontrollerer strengen «halloverden» for delstrengen «verden» og returnerer sann:

contains('hello world', 'world')

Eksempel 2

Dette eksemplet kontrollerer strengen «halloverden» for delstrengen «universet» og returnerer usann:

contains('hello world', 'universe')

convertFromUtc

Konverter et tidsstempel fra Universal Time Coordinated (UTC) til måltidssonen.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<destinationTimeZone> Ja Streng Navnet på måltidssonen. Hvis du vil ha navn på tidssone, kan du se Microsofts tidssoneverdier, men du må kanskje fjerne tegnsetting fra tidssonenavnet.
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<konvertert tidsstempel> Streng Tidsstempelet konvertert til måltidssonen

Eksempel 1

Dette eksemplet konverterer et tidsstempel til den angitte tidssonen:

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

Og returnerer dette resultatet: "2018-01-01T00:00:00Z"

Eksempel 2

Dette eksemplet konverterer et tidsstempel til den angitte tidssonen og formatet:

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

Og returnerer dette resultatet: "Monday, January 1, 2018"

convertTimeZone

Konverter et tidsstempel fra kildetidssonen til måltidssonen.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<sourceTimeZone> Ja Streng Navnet på kildetidssonen. Hvis du vil ha navn på tidssone, kan du se Microsofts tidssoneverdier, men du må kanskje fjerne tegnsetting fra tidssonenavnet.
<destinationTimeZone> Ja Streng Navnet på måltidssonen. Hvis du vil ha navn på tidssone, kan du se Microsofts tidssoneverdier, men du må kanskje fjerne tegnsetting fra tidssonenavnet.
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<konvertert tidsstempel> Streng Tidsstempelet konvertert til måltidssonen

Eksempel 1

Dette eksemplet konverterer kildetidssonen til måltidssonen:

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

Og returnerer dette resultatet: "2018-01-01T00:00:00.0000000"

Eksempel 2

Dette eksemplet konverterer en tidssone til den angitte tidssonen og formatet:

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

Og returnerer dette resultatet: "Monday, January 1, 2018"

convertToUtc

Konverter et tidsstempel fra kildetidssonen til Universal Time Coordinated (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<sourceTimeZone> Ja Streng Navnet på kildetidssonen. Hvis du vil ha navn på tidssone, kan du se Microsofts tidssoneverdier, men du må kanskje fjerne tegnsetting fra tidssonenavnet.
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<konvertert tidsstempel> Streng Tidsstempelet konvertert til UTC

Eksempel 1

Dette eksemplet konverterer et tidsstempel til UTC:

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

Og returnerer dette resultatet: "2018-01-01T08:00:00.0000000Z"

Eksempel 2

Dette eksemplet konverterer et tidsstempel til UTC:

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

Og returnerer dette resultatet: "Monday, January 1, 2018"

createArray

Returner en matrise fra flere inndata. Hvis du vil ha enkle inndatamatriser, kan du se matrise().

createArray('<object1>', '<object2>', ...)
Parameter Kreves Type Bekrivelse
<object1>, <object2>, ... Ja Alle, men ikke blandet Minst to elementer for å opprette matrisen
Returverdi Type Bekrivelse
[<object1>, <object2>, ...] Matrise Matrisen som er opprettet fra alle inndataelementene

Eksempel

Dette eksemplet oppretter en matrise fra disse inndataene:

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

Og returnerer dette resultatet: ["h", "e", "l", "l", "o"]

dataUri

Returner en URI (data uniform resource identifier) for en streng.

dataUri('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Strengen som skal konverteres
Returverdi Type Bekrivelse
<data-uri> Streng Data-URI-en for inndatastrengen

Eksempel

Dette eksemplet oppretter en data-URI for «hallo»-strengen:

dataUri('hello')

Og returnerer dette resultatet: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Returner binærversjonen for en URI (Data Uniform Resource Identifier). Bruk denne funksjonen i stedet for decodeDataUri(). Selv om begge funksjonene fungerer på samme måte, dataUriBinary() foretrekkes.

dataUriToBinary('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Data-URI-en som skal konverteres
Returverdi Type Bekrivelse
<binær-for-data-uri> Streng Binærversjonen for data-URI

Eksempel

Dette eksemplet oppretter en binær versjon for denne data-URI-en:

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

Og returnerer dette resultatet:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Returner strengversjonen for en URI (Data Uniform Resource Identifier).

dataUriToString('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Data-URI-en som skal konverteres
Returverdi Type Bekrivelse
<string-for-data-uri> Streng Strengversjonen for data-URI

Eksempel

Dette eksemplet oppretter en streng for denne data-URI-en:

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

Og returnerer dette resultatet: "hello"

dayOfMonth

Returner dagen i måneden fra et tidsstempel.

dayOfMonth('<timestamp>')
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
Returverdi Type Bekrivelse
<dag i måneden> Integer Dagen i måneden fra det angitte tidsstempelet

Eksempel

Dette eksemplet returnerer tallet for dagen i måneden fra dette tidsstempelet:

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

Og returnerer dette resultatet: 15

dayOfWeek

Returner ukedagen fra et tidsstempel.

dayOfWeek('<timestamp>')
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
Returverdi Type Bekrivelse
<dag i uken> Integer Ukedagen fra det angitte tidsstempelet der søndag er 0, mandag er 1 og så videre

Eksempel

Dette eksemplet returnerer tallet for ukedagen fra dette tidsstempelet:

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

Og returnerer dette resultatet: 3

dayOfYear

Returner dagen i året fra et tidsstempel.

dayOfYear('<timestamp>')
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
Returverdi Type Bekrivelse
<dag i året> Integer Dagen i året fra det angitte tidsstempelet

Eksempel

Dette eksemplet returnerer antall dager i året fra dette tidsstempelet:

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

Og returnerer dette resultatet: 74

decodeBase64

Returner strengversjonen for en base64-kodet streng, som effektivt dekoder base64-strengen. Vurder å bruke base64ToString() i stedet decodeBase64()for . Selv om begge funksjonene fungerer på samme måte, base64ToString() foretrekkes.

decodeBase64('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Den base64-kodede strengen som skal dekodes
Returverdi Type Bekrivelse
<dekodet base64-streng> Streng Strengversjonen for en base64-kodet streng

Eksempel

Dette eksemplet oppretter en streng for en base64-kodet streng:

decodeBase64('aGVsbG8=')

Og returnerer dette resultatet: "hello"

decodeDataUri

Returner binærversjonen for en URI (Data Uniform Resource Identifier). Vurder å bruke dataUriToBinary(), i stedet decodeDataUri()for . Selv om begge funksjonene fungerer på samme måte, dataUriToBinary() foretrekkes.

decodeDataUri('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Data-URI-strengen som skal dekodes
Returverdi Type Bekrivelse
<binær-for-data-uri> Streng Binærversjonen for en data-URI-streng

Eksempel

Dette eksemplet returnerer binærversjonen for denne data-URI-en:

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

Og returnerer dette resultatet:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Returner en streng som erstatter escape-tegn med dekodede versjoner.

decodeUriComponent('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Strengen med escape-tegnene som skal dekodes
Returverdi Type Bekrivelse
<decoded-uri> Streng Den oppdaterte strengen med dekodede escape-tegnene

Eksempel

Dette eksemplet erstatter escape-tegnene i denne strengen med dekodede versjoner:

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

Og returnerer dette resultatet: "https://contoso.com"

Div

Returner heltallsresultatet fra å dele to tall. Hvis du vil ha resten av resultatet, kan du se mod().

div(<dividend>, <divisor>)
Parameter Kreves Type Bekrivelse
<Utbytte> Ja Heltall eller flyt Tallet som skal divideres med divisoren
<Divisor> Ja Heltall eller flyt Tallet som deler utbyttet, men som ikke kan være 0
Returverdi Type Bekrivelse
<kvotientresultat> Integer Heltallsresultatet fra å dividere det første tallet med det andre tallet

Eksempel

Begge eksemplene deler det første tallet med det andre tallet:

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

Og returner dette resultatet: 2

kodeUriComponent

Returner en uniform resource identifier (URI) kodet versjon for en streng ved å erstatte url-usikre tegn med escape-tegn. Vurder å bruke uriComponent(), i stedet encodeUriComponent()for . Selv om begge funksjonene fungerer på samme måte, uriComponent() foretrekkes.

encodeUriComponent('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Strengen som skal konverteres til URI-kodet format
Returverdi Type Bekrivelse
<kodet-uri> Streng Den URI-kodede strengen med escape-tegn

Eksempel

Dette eksemplet oppretter en URI-kodet versjon for denne strengen:

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

Og returnerer dette resultatet: "http%3A%2F%2Fcontoso.com"

empty

Kontroller om en samling er tom. Returner sann når samlingen er tom, eller returner usann når den ikke er tom.

empty('<collection>')
empty([<collection>])
Parameter Kreves Type Bekrivelse
<Samling> Ja Streng, matrise eller objekt Samlingen som skal kontrolleres
Returverdi Type Bekrivelse
sann eller usann Boolean Returner sann når samlingen er tom. Returner usann når den ikke er tom.

Eksempel

Disse eksemplene kontrollerer om de angitte samlingene er tomme:

empty('')
empty('abc')

Og returnerer disse resultatene:

  • Første eksempel: Sender en tom streng, slik at funksjonen returnerer true.
  • Andre eksempel: Sender strengen «abc», slik at funksjonen returnerer false.

endsWith

Kontroller om en streng slutter med en bestemt delstreng. Returner sann når delstrengen blir funnet, eller returner usann når den ikke blir funnet. Denne funksjonen skiller ikke mellom store og små bokstaver.

endsWith('<text>', '<searchText>')
Parameter Kreves Type Beskrivelse
<Tekst> Ja Streng Strengen som skal kontrolleres
<Søkettertekst> Ja Streng Sluttunderstrengen du vil finne
Returverdi Type Bekrivelse
sann eller usann Boolean Returner sann når sluttunderstrengen blir funnet. Returner usann når den ikke ble funnet.

Eksempel 1

Dette eksemplet kontrollerer om «hello world»-strengen slutter med «verden»-strengen:

endsWith('hello world', 'world')

Og returnerer dette resultatet: true

Eksempel 2

Dette eksemplet kontrollerer om «hello world»-strengen slutter med «universet»-strengen:

endsWith('hello world', 'universe')

Og returnerer dette resultatet: false

equals

Kontroller om både verdier, uttrykk eller objekter er like. Returner sann når begge er like, eller returner usann når de ikke er likeverdige.

equals('<object1>', '<object2>')
Parameter Kreves Type Bekrivelse
<object1>, <object2> Ja Diverse Verdiene, uttrykkene eller objektene som skal sammenlignes
Returverdi Type Bekrivelse
sann eller usann Boolean Returner sann når begge er like. Returner usann når den ikke tilsvarer.

Eksempel

Disse eksemplene kontrollerer om de angitte inndataene er like.

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

Og returnerer disse resultatene:

  • Første eksempel: Begge verdiene er like, så funksjonen returnerer true.
  • Andre eksempel: Begge verdiene er ikke like, så funksjonen returnerer false.

Første

Returner det første elementet fra en streng eller matrise.

first('<collection>')
first([<collection>])
Parameter Kreves Type Bekrivelse
<Samling> Ja Streng eller matrise Samlingen der du finner det første elementet
Returverdi Type Bekrivelse
<første samling-element> Any Det første elementet i samlingen

Eksempel

Disse eksemplene finner det første elementet i disse samlingene:

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

Og returner disse resultatene:

  • Første eksempel: "h"
  • Andre eksempel: 0

flyttall

Konverter en strengversjon for et flyttall til et faktisk flyttall.

float('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Strengen som har et gyldig flyttall som skal konverteres
Returverdi Type Bekrivelse
<flytverdi> Float Flyttallsnummeret for den angitte strengen

Eksempel

Dette eksemplet oppretter en strengversjon for dette flyttallsnummeret:

float('10.333')

Og returnerer dette resultatet: 10.333

formatDateTime

Returner et tidsstempel i det angitte formatet.

formatDateTime('<timestamp>', '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<tidsstempel for reformatert tidsstempel> Streng Det oppdaterte tidsstempelet i det angitte formatet

Eksempel

Dette eksemplet konverterer et tidsstempel til det angitte formatet:

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

Og returnerer dette resultatet: "2018-03-15T12:00:00"

getFutureTime

Returner gjeldende tidsstempel pluss de angitte tidsenhetene.

getFutureTime(<interval>, <timeUnit>, <format>?)
Parameter Kreves Type Bekrivelse
<Intervall> Ja Integer Antall angitte tidsenheter som skal legges til
<timeUnit> Ja Streng Tidsenheten som skal brukes med intervall: «Sekund», «Minutt», «Time», «Dag», «Uke», «Måned», «År»
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<oppdatert tidsstempel> Streng Gjeldende tidsstempel pluss angitt antall tidsenheter

Eksempel 1

La oss si at gjeldende tidsstempel er «2018-03-01T00:00:00.0000000Z». Dette eksemplet legger til fem dager i tidsstempelet:

getFutureTime(5, 'Day')

Og returnerer dette resultatet: "2018-03-06T00:00:00.0000000Z"

Eksempel 2

La oss si at gjeldende tidsstempel er «2018-03-01T00:00:00.0000000Z». Dette eksemplet legger til fem dager og konverterer resultatet til D-format:

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

Og returnerer dette resultatet: "Tuesday, March 6, 2018"

getPastTime

Returner gjeldende tidsstempel minus de angitte tidsenhetene.

getPastTime(<interval>, <timeUnit>, <format>?)
Parameter Kreves Type Bekrivelse
<Intervall> Ja Integer Antall angitte tidsenheter som skal trekkes fra
<timeUnit> Ja Streng Tidsenheten som skal brukes med intervall: «Sekund», «Minutt», «Time», «Dag», «Uke», «Måned», «År»
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<oppdatert tidsstempel> Streng Gjeldende tidsstempel minus det angitte antallet tidsenheter

Eksempel 1

La oss si at gjeldende tidsstempel er 2018-02-01T00:00:00.000000Z. Dette eksemplet trekker fem dager fra tidsstempelet:

getPastTime(5, 'Day')

Og returnerer dette resultatet: "2018-01-27T00:00:00.0000000Z"

Eksempel 2

La oss si at gjeldende tidsstempel er 2018-02-01T00:00:00.000000Z. Dette eksemplet trekker fra fem dager og konverterer resultatet til D-format:

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

Og returnerer dette resultatet: "Saturday, January 27, 2018"

greater

Kontroller om den første verdien er større enn den andre verdien. Returner sann når den første verdien er mer, eller returner usann når mindre.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Heltall, flyt eller streng Den første verdien for å kontrollere om større enn den andre verdien
<compareTo> Ja Henholdsvis heltall, flyt eller streng Sammenligningsverdien
Returverdi Type Bekrivelse
sann eller usann Boolean Returner sann når den første verdien er større enn den andre verdien. Returner usann når den første verdien er lik eller mindre enn den andre verdien.

Eksempel

Disse eksemplene kontrollerer om den første verdien er større enn den andre verdien:

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

Og returner disse resultatene:

  • Første eksempel: true
  • Andre eksempel: false

greaterOrEquals

Kontroller om den første verdien er større enn eller lik den andre verdien. Returner sann når den første verdien er større eller lik, eller returner usann når den første verdien er mindre.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Heltall, flyt eller streng Den første verdien for å kontrollere om større enn eller lik den andre verdien
<compareTo> Ja Henholdsvis heltall, flyt eller streng Sammenligningsverdien
Returverdi Type Bekrivelse
sann eller usann Boolean Returner sann når den første verdien er større enn eller lik den andre verdien. Returner usann når den første verdien er mindre enn den andre verdien.

Eksempel

Disse eksemplene kontrollerer om den første verdien er større eller lik den andre verdien:

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

Og returner disse resultatene:

  • Første eksempel: true
  • Andre eksempel: false

Guid

Generer en globalt unik identifikator (GUID) som en streng, for eksempel "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Du kan også angi et annet format for GUID-en annet enn standardformatet D, som er 32 sifre atskilt med bindestreker.

guid('<format>')
Parameter Kreves Type Bekrivelse
<Format> No Streng En enkelt formatangitter for den returnerte GUID-en. Som standard er formatet «D», men du kan bruke «N», «D», «B», «P» eller «X».
Returverdi Type Bekrivelse
<GUID-verdi> Streng En tilfeldig generert GUID

Eksempel

Dette eksemplet genererer samme GUID, men som 32 sifre, atskilt med bindestreker og omsluttet av parenteser:

guid('P')

Og returnerer dette resultatet: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

Kontroller om et uttrykk er sant eller usant. Hvis du er basert på resultatet, returnerer du en angitt verdi.

if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parameter Kreves Type Bekrivelse
<Uttrykk> Ja Boolean Uttrykket som skal kontrolleres
<valueIfTrue> Ja Any Verdien som skal returneres når uttrykket er sant
<valueIfFalse> Ja Any Verdien som skal returneres når uttrykket er usant
Returverdi Type Bekrivelse
<angitt returverdi> Any Den angitte verdien som returnerer basert på om uttrykket er sant eller usant

Eksempel

Dette eksemplet returnerer "yes" fordi det angitte uttrykket returnerer sann. Ellers returnerer "no"eksemplet:

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

indexOf

Returner startposisjonen eller indeksverdien for en delstreng. Denne funksjonen skiller ikke mellom store og små bokstaver, og indekser starter med tallet 0.

indexOf('<text>', '<searchText>')
Parameter Kreves Type Beskrivelse
<Tekst> Ja Streng Strengen som har delstrengen å finne
<Søkettertekst> Ja Streng Delstrengen du vil finne
Returverdi Type Bekrivelse
<indeksverdi> Integer Startposisjonen eller indeksverdien for den angitte delstrengen.
Hvis strengen ikke blir funnet, returnerer du tallet -1.

Eksempel

Dette eksemplet finner startindeksverdien for «verden»-delstrengen i «hello world»-strengen:

indexOf('hello world', 'world')

Og returnerer dette resultatet: 6

heltall

Returner heltallsversjonen for en streng.

int('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Strengen som skal konverteres
Returverdi Type Bekrivelse
<heltall-resultat> Integer Heltallsversjonen for den angitte strengen

Eksempel

Dette eksemplet oppretter en heltallsversjon for strengen "10":

int('10')

Og returnerer dette resultatet: 10

json

Returner JSON-typeverdien (JavaScript Object Notation) eller objektet for en streng eller XML.

json('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng eller XML Strengen eller XML-filen som skal konverteres
Returverdi Type Bekrivelse
<JSON-resultat> JSON opprinnelig type eller objekt JSON-verdien eller objektet for den angitte strengen eller XML-en. Hvis strengen er null, returnerer funksjonen et tomt objekt.

Eksempel 1

Dette eksemplet konverterer denne strengen til JSON-verdien:

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

Og returnerer dette resultatet: [1, 2, 3]

Eksempel 2

Dette eksemplet konverterer denne strengen til JSON:

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

Og returnerer dette resultatet:

{
  "fullName": "Sophia Owen"
}

Eksempel 3

Dette eksemplet konverterer denne XML-filen til JSON:

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

Og returnerer dette resultatet:

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

Skjæringspunktet mellom

Returner en samling som bare har de vanlige elementene på tvers av de angitte samlingene. Hvis du vil vises i resultatet, må et element vises i alle samlingene som sendes til denne funksjonen. Hvis ett eller flere elementer har samme navn, vises det siste elementet med dette navnet i resultatet.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parameter Kreves Type Bekrivelse
<samling1>, <samling2>, ... Ja Matrise eller objekt, men ikke begge Samlingene der du bare vil ha de vanlige elementene
Returverdi Type Bekrivelse
<vanlige elementer> Henholdsvis matrise eller objekt En samling som bare har de vanlige elementene på tvers av de angitte samlingene

Eksempel

Dette eksemplet finner de vanlige elementene på tvers av disse matrisene:

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

Og returnerer en matrise med bare disse elementene: [1, 2]

join

Returner en streng som har alle elementene fra en matrise og har hvert tegn atskilt med et skilletegn.

join([<collection>], '<delimiter>')
Parameter Kreves Type Bekrivelse
<Samling> Ja Matrise Matrisen som har elementene å bli med i
<Skilletegn> Ja Streng Skilletegnet som vises mellom hvert tegn i resultatstrengen
Returverdi Type Bekrivelse
<tegn1><skilletegn><2><skilletegn...> Streng Resultatstrengen som er opprettet fra alle elementene i den angitte matrisen

Eksempel

Dette eksemplet oppretter en streng fra alle elementene i denne matrisen med det angitte tegnet som skilletegn:

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

Og returnerer dette resultatet: "a.b.c"

Siste

Returner det siste elementet fra en samling.

last('<collection>')
last([<collection>])
Parameter Kreves Type Bekrivelse
<Samling> Ja Streng eller matrise Samlingen der du finner det siste elementet
Returverdi Type Bekrivelse
<siste samling-element> Henholdsvis streng eller matrise Det siste elementet i samlingen

Eksempel

Disse eksemplene finner det siste elementet i disse samlingene:

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

Og returnerer disse resultatene:

  • Første eksempel: "d"
  • Andre eksempel: 3

lastIndexOf

Returner startposisjonen eller indeksverdien for den siste forekomsten av en delstreng. Denne funksjonen skiller ikke mellom store og små bokstaver, og indekser starter med tallet 0.

lastIndexOf('<text>', '<searchText>')
Parameter Kreves Type Beskrivelse
<Tekst> Ja Streng Strengen som har delstrengen å finne
<Søkettertekst> Ja Streng Delstrengen du vil finne
Returverdi Type Bekrivelse
<sluttindeksverdi> Integer Startposisjonen eller indeksverdien for den siste forekomsten av den angitte delstrengen.
Hvis strengen ikke blir funnet, returnerer du tallet -1.

Eksempel

Dette eksemplet finner startindeksverdien for den siste forekomsten av «verden»-delstrengen i «hello world»-strengen:

lastIndexOf('hello world', 'world')

Og returnerer dette resultatet: 6

length

Returner antall elementer i en samling.

length('<collection>')
length([<collection>])
Parameter Kreves Type Bekrivelse
<Samling> Ja Streng eller matrise Samlingen med elementene som skal telles
Returverdi Type Bekrivelse
<lengde-eller-antall> Integer Antall elementer i samlingen

Eksempel

Disse eksemplene teller antall elementer i disse samlingene:

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

Og returner dette resultatet: 4

less

Kontroller om den første verdien er mindre enn den andre verdien. Returner sann når den første verdien er mindre, eller returner usann når den første verdien er mer.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Heltall, flyt eller streng Den første verdien for å kontrollere om mindre enn den andre verdien
<compareTo> Ja Henholdsvis heltall, flyt eller streng Sammenligningselementet
Returverdi Type Bekrivelse
sann eller usann Boolean Returner sann når den første verdien er mindre enn den andre verdien. Returner usann når den første verdien er lik eller større enn den andre verdien.

Eksempel

Disse eksemplene kontrollerer om den første verdien er mindre enn den andre verdien.

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

Og returner disse resultatene:

  • Første eksempel: true
  • Andre eksempel: false

lessOrEquals

Kontroller om den første verdien er mindre enn eller lik den andre verdien. Returner sann når den første verdien er mindre enn eller lik, eller returner usann når den første verdien er mer.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Heltall, flyt eller streng Den første verdien for å kontrollere om mindre enn eller lik den andre verdien
<compareTo> Ja Henholdsvis heltall, flyt eller streng Sammenligningselementet
Returverdi Type Bekrivelse
sann eller usann Boolean Returner sann når den første verdien er mindre enn eller lik den andre verdien. Returner usann når den første verdien er større enn den andre verdien.

Eksempel

Disse eksemplene kontrollerer om den første verdien er mindre eller lik den andre verdien.

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

Og returner disse resultatene:

  • Første eksempel: true
  • Andre eksempel: false

Maks

Returner den høyeste verdien fra en liste eller matrise med tall som er inkludert i begge ender.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parameter Kreves Type Bekrivelse
<tall1>, <tall2>, ... Ja Heltall, flyt eller begge deler Settet med tall som du vil finne den høyeste verdien fra
[<tall1>, <tall2>; ...] Ja Matrise – heltall, flyt eller begge deler Matrisen med tall du vil finne den høyeste verdien fra
Returverdi Type Bekrivelse
<maksimal verdi> Heltall eller flyt Den høyeste verdien i den angitte matrisen eller settet med tall

Eksempel

Disse eksemplene får den høyeste verdien fra settet med tall og matrisen:

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

Og returner dette resultatet: 3

min

Returner den laveste verdien fra et sett med tall eller en matrise.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parameter Kreves Type Bekrivelse
<tall1>, <tall2>, ... Ja Heltall, flyt eller begge deler Settet med tall som du vil finne den laveste verdien fra
[<tall1>, <tall2>; ...] Ja Matrise – heltall, flyt eller begge deler Matrisen med tall du vil finne den laveste verdien fra
Returverdi Type Bekrivelse
<min-verdi> Heltall eller flyt Den laveste verdien i det angitte settet med tall eller angitt matrise

Eksempel

Disse eksemplene får den laveste verdien i settet med tall og matrisen:

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

Og returner dette resultatet: 1

mod

Returner resten fra å dele to tall. Hvis du vil hente heltallsresultatet, kan du se div().

mod(<dividend>, <divisor>)
Parameter Kreves Type Bekrivelse
<Utbytte> Ja Heltall eller flyt Tallet som skal divideres med divisoren
<Divisor> Ja Heltall eller flyt Tallet som deler utbyttet, men kan ikke være 0.
Returverdi Type Bekrivelse
<modulo-resultat> Heltall eller flyt Resten fra å dele det første tallet med det andre tallet

Eksempel

Dette eksemplet deler det første tallet med det andre tallet:

mod(3, 2)

Og returner dette resultatet: 1

mul

Returner produktet fra å multiplisere to tall.

mul(<multiplicand1>, <multiplicand2>)
Parameter Kreves Type Bekrivelse
<multiplikator1> Ja Heltall eller flyt Tallet som skal multipliseres med multiplikator2
<multiplikator2> Ja Heltall eller flyt Tallet som multipler multiplikerte1
Returverdi Type Bekrivelse
<produktresultat> Heltall eller flyt Produktet fra å multiplisere det første tallet med det andre tallet

Eksempel

Disse eksemplene er flere ganger det første tallet etter det andre tallet:

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

Og returner disse resultatene:

  • Første eksempel: 2
  • Andre eksempel 3

not

Kontroller om et uttrykk er usant. Returner sann når uttrykket er usant, eller returner usann når sann.

not(<expression>)
Parameter Kreves Type Bekrivelse
<Uttrykk> Ja Boolean Uttrykket som skal kontrolleres
Returverdi Type Bekrivelse
sann eller usann Boolean Returner sann når uttrykket er usant. Returner usann når uttrykket er sant.

Eksempel 1

Disse eksemplene kontrollerer om de angitte uttrykkene er usanne:

not(false)
not(true)

Og returner disse resultatene:

  • Første eksempel: Uttrykket er usant, så funksjonen returnerer true.
  • Andre eksempel: Uttrykket er sant, så funksjonen returnerer false.

Eksempel 2

Disse eksemplene kontrollerer om de angitte uttrykkene er usanne:

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

Og returner disse resultatene:

  • Første eksempel: Uttrykket er usant, så funksjonen returnerer true.
  • Andre eksempel: Uttrykket er sant, så funksjonen returnerer false.

or

Kontroller om minst ett uttrykk er sant. Returner sann når minst ett uttrykk er sant, eller returner usann når begge er usann.

or(<expression1>, <expression2>)
Parameter Kreves Type Bekrivelse
<uttrykk1>, <uttrykk2> Ja Boolean Uttrykkene som skal kontrolleres
Returverdi Type Bekrivelse
sann eller usann Boolean Returner sann når minst ett uttrykk er sant. Returner usann når begge uttrykkene er usann.

Eksempel 1

Disse eksemplene kontrollerer om minst ett uttrykk er sant:

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

Og returner disse resultatene:

  • Første eksempel: Minst ett uttrykk er sant, så funksjonen returnerer true.
  • Andre eksempel: Begge uttrykkene er usann, så funksjonen returnerer false.

Eksempel 2

Disse eksemplene kontrollerer om minst ett uttrykk er sant:

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

Og returner disse resultatene:

  • Første eksempel: Minst ett uttrykk er sant, så funksjonen returnerer true.
  • Andre eksempel: Begge uttrykkene er usann, så funksjonen returnerer false.

Rand

Returner et tilfeldig heltall fra et angitt område, som bare er inkludert i startenden.

rand(<minValue>, <maxValue>)
Parameter Kreves Type Bekrivelse
<minValue> Ja Integer Det laveste heltallet i området
<maxValue> Ja Integer Heltallet som følger det høyeste heltallet i området som funksjonen kan returnere
Returverdi Type Bekrivelse
<tilfeldig resultat> Integer Det tilfeldige heltallet som returneres fra det angitte området

Eksempel

Dette eksemplet får et tilfeldig heltall fra det angitte området, unntatt maksimumsverdien:

rand(1, 5)

Og returnerer ett av disse tallene som resultat: 1, , 23eller4

range

Returner en heltallmatrise som starter fra et angitt heltall.

range(<startIndex>, <count>)
Parameter Kreves Type Bekrivelse
<Startindex> Ja Integer En heltallsverdi som starter matrisen som det første elementet
<Telle> Ja Integer Antall heltall i matrisen
Returverdi Type Bekrivelse
[<områderesultat>] Matrise Matrisen med heltall som starter fra den angitte indeksen

Eksempel

Dette eksemplet oppretter en heltallsmatrise som starter fra den angitte indeksen og har det angitte antallet heltall:

range(1, 4)

Og returnerer dette resultatet: [1, 2, 3, 4]

replace

Erstatt en delstreng med den angitte strengen, og returner resultatstrengen. Denne funksjonen skiller mellom store og små bokstaver.

replace('<text>', '<oldText>', '<newText>')
Parameter Kreves Type Beskrivelse
<Tekst> Ja Streng Strengen som har delstrengen som skal erstattes
<Gammeltekst> Ja Streng Delstrengen som skal erstattes
<Nytekst> Ja Streng Erstatningsstrengen
Returverdi Type Bekrivelse
<oppdatert tekst> Streng Den oppdaterte strengen etter å ha erstattet delstrengen
Hvis delstrengen ikke blir funnet, returnerer du den opprinnelige strengen.

Eksempel

Dette eksemplet finner den gamle delstrengen i den gamle strengen og erstatter «gammel» med «ny»:

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

Og returnerer dette resultatet: "the new string"

skip

Fjern elementer fra forsiden av en samling, og returner alle de andre elementene.

skip([<collection>], <count>)
Parameter Kreves Type Bekrivelse
<Samling> Ja Matrise Samlingen med elementer du vil fjerne
<Telle> Ja Integer Et positivt heltall for antall elementer som skal fjernes foran
Returverdi Type Bekrivelse
[<oppdatert samling>] Matrise Den oppdaterte samlingen etter fjerning av de angitte elementene

Eksempel

Dette eksemplet fjerner ett element, tallet 0, fra forsiden av den angitte matrisen:

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

Og returnerer denne matrisen med de gjenværende elementene: [1,2,3]

split

Returner en matrise som inneholder delstrenger, atskilt med komma, basert på det angitte skilletegnet i den opprinnelige strengen.

split('<text>', '<delimiter>')
Parameter Kreves Type Beskrivelse
<Tekst> Ja Streng Strengen som skal skilles i delstrenger basert på det angitte skilletegnet i den opprinnelige strengen
<Skilletegn> Ja Streng Tegnet i den opprinnelige strengen som skal brukes som skilletegn
Returverdi Type Bekrivelse
[<delstreng1,delstreng2>><,...] Matrise En matrise som inneholder delstrenger fra den opprinnelige strengen, atskilt med komma

Eksempel

Dette eksemplet oppretter en matrise med delstrenger fra den angitte strengen basert på det angitte tegnet som skilletegn:

split('a_b_c', '_')

Og returnerer denne matrisen som resultatet: ["a","b","c"]

startOfDay

Returner starten på dagen for et tidsstempel.

startOfDay('<timestamp>', '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<oppdatert tidsstempel> Streng Det angitte tidsstempelet, men starter på nulltimersmerket for dagen

Eksempel

Dette eksemplet finner starten på dagen for dette tidsstempelet:

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

Og returnerer dette resultatet: "2018-03-15T00:00:00.0000000Z"

startOfHour

Returner starten på timen for et tidsstempel.

startOfHour('<timestamp>', '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<oppdatert tidsstempel> Streng Det angitte tidsstempelet, men starter ved nullminuttmerket for timen

Eksempel

Dette eksemplet finner starten på timen for dette tidsstempelet:

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

Og returnerer dette resultatet: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Returner starten av måneden for et tidsstempel.

startOfMonth('<timestamp>', '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<oppdatert tidsstempel> Streng Det angitte tidsstempelet, men starter på den første dagen i måneden ved nulltimersmerket

Eksempel

Dette eksemplet returnerer starten på måneden for dette tidsstempelet:

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

Og returnerer dette resultatet: "2018-03-01T00:00:00.0000000Z"

startsWith

Kontroller om en streng starter med en bestemt delstreng. Returner sann når delstrengen blir funnet, eller returner usann når den ikke blir funnet. Denne funksjonen skiller ikke mellom store og små bokstaver.

startsWith('<text>', '<searchText>')
Parameter Kreves Type Beskrivelse
<Tekst> Ja Streng Strengen som skal kontrolleres
<Søkettertekst> Ja Streng Startstrengen du vil finne
Returverdi Type Bekrivelse
sann eller usann Boolean Returner sann når startunderstrengen blir funnet. Returner usann når den ikke ble funnet.

Eksempel 1

Dette eksemplet kontrollerer om «hello world»-strengen starter med «hello»-delstrengen:

startsWith('hello world', 'hello')

Og returnerer dette resultatet: true

Eksempel 2

Dette eksemplet kontrollerer om «hello world»-strengen starter med «hilsener»-delstrengen:

startsWith('hello world', 'greetings')

Og returnerer dette resultatet: false

streng

Returner strengversjonen for en verdi.

string(<value>)
Parameter Kreves Type Bekrivelse
<Verdi> Ja Any Verdien som skal konverteres
Returverdi Type Bekrivelse
<strengverdi> Streng Strengversjonen for den angitte verdien

Eksempel 1

Dette eksemplet oppretter strengversjonen for dette tallet:

string(10)

Og returnerer dette resultatet: "10"

Eksempel 2

Dette eksemplet oppretter en streng for det angitte JSON-objektet og bruker omvendt skråstrek (\) som escape-tegn for dobbelt anførselstegnet (").

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

Og returnerer dette resultatet: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

Returner resultatet fra å trekke det andre tallet fra det første tallet.

sub(<minuend>, <subtrahend>)
Parameter Kreves Type Bekrivelse
<minuend> Ja Heltall eller flyt Tallet du vil trekke fra undertrahendet fra
<Subtrahend> Ja Heltall eller flyt Tallet som skal trekkes fra minuend
Returverdi Type Bekrivelse
<Resultatet> Heltall eller flyt Resultatet fra å trekke det andre tallet fra det første tallet

Eksempel

Dette eksemplet trekker det andre tallet fra det første tallet:

sub(10.3, .3)

Og returnerer dette resultatet: 10

Delstreng

Returner tegn fra en streng, fra den angitte plasseringen eller indeksen. Indeksverdier starter med tallet 0.

substring('<text>', <startIndex>, <length>)
Parameter Kreves Type Beskrivelse
<Tekst> Ja Streng Strengen med tegn du vil bruke
<Startindex> Ja Integer Et positivt tall lik eller større enn 0 som du vil bruke som startposisjon eller indeksverdi
<Lengde> Ja Integer Et positivt antall tegn du vil bruke i delstrengen
Returverdi Type Bekrivelse
<delstrengresultat> Streng En delstreng med angitt antall tegn, som starter ved den angitte indeksplasseringen i kildestrengen

Eksempel

Dette eksemplet oppretter en delstreng med fem tegn fra den angitte strengen, fra indeksverdien 6:

substring('hello world', 6, 5)

Og returnerer dette resultatet: "world"

subtractFromTime

Trekk fra et antall tidsenheter fra et tidsstempel. Se også getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen som inneholder tidsstempelet
<Intervall> Ja Integer Antall angitte tidsenheter som skal trekkes fra
<timeUnit> Ja Streng Tidsenheten som skal brukes med intervall: «Sekund», «Minutt», «Time», «Dag», «Uke», «Måned», «År»
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<oppdatert tidsstempel> Streng Tidsstempelet minus det angitte antallet tidsenheter

Eksempel 1

Dette eksemplet trekker én dag fra dette tidsstempelet:

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

Og returnerer dette resultatet: "2018-01-01T00:00:00:0000000Z"

Eksempel 2

Dette eksemplet trekker én dag fra dette tidsstempelet:

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

Og returnerer dette resultatet ved hjelp av det valgfrie D-formatet: "Monday, January, 1, 2018"

take

Returner elementer fra forsiden av en samling.

take('<collection>', <count>)
take([<collection>], <count>)
Parameter Kreves Type Bekrivelse
<Samling> Ja Streng eller matrise Samlingen med elementer du vil bruke
<Telle> Ja Integer Et positivt heltall for antall elementer du vil bruke fra forsiden
Returverdi Type Bekrivelse
<delsett> eller [<delsett>] Henholdsvis streng eller matrise En streng eller matrise som har det angitte antallet elementer som er tatt fra forsiden av den opprinnelige samlingen

Eksempel

Disse eksemplene henter det angitte antallet elementer fra forsiden av disse samlingene:

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

Og returner disse resultatene:

  • Første eksempel: "abc"
  • Andre eksempel: [0, 1, 2]

Flått

Returner egenskapsverdien ticks for et angitt tidsstempel. Et kryss er et intervall på 100 nanosekunder.

ticks('<timestamp>')
Parameter Kreves Type Bekrivelse
<Tidsstempel> Ja Streng Strengen for et tidsstempel
Returverdi Type Bekrivelse
<ticks-number> Integer Antall flått som har gått siden 12:00:00 midnatt, 1. januar 0001 i den gregorianske kalenderen siden tidsstempelet for inndata

toLower

Returner en streng med små bokstaver. Hvis et tegn i strengen ikke har en liten versjon, forblir tegnet uendret i den returnerte strengen.

toLower('<text>')
Parameter Kreves Type Beskrivelse
<Tekst> Ja Streng Strengen som skal returneres med små bokstaver
Returverdi Type Bekrivelse
<små bokstaver i tekst> Streng Den opprinnelige strengen med små bokstaver

Eksempel

Dette eksemplet konverterer denne strengen til små bokstaver:

toLower('Hello World')

Og returnerer dette resultatet: "hello world"

toUpper

Returner en streng med store bokstaver. Hvis et tegn i strengen ikke har en stor versjon, forblir dette tegnet uendret i den returnerte strengen.

toUpper('<text>')
Parameter Kreves Type Beskrivelse
<Tekst> Ja Streng Strengen som skal returneres med store bokstaver
Returverdi Type Bekrivelse
<stor tekst> Streng Den opprinnelige strengen med store bokstaver

Eksempel

Dette eksemplet konverterer denne strengen til store bokstaver:

toUpper('Hello World')

Og returnerer dette resultatet: "HELLO WORLD"

Trim

Fjern innledende og etterfølgende mellomrom fra en streng, og returner den oppdaterte strengen.

trim('<text>')
Parameter Kreves Type Beskrivelse
<Tekst> Ja Streng Strengen som har det innledende og etterfølgende mellomrom for å fjerne
Returverdi Type Bekrivelse
<updatedText> Streng En oppdatert versjon for den opprinnelige strengen uten innledende eller etterfølgende mellomrom

Eksempel

Dette eksemplet fjerner det innledende og etterfølgende mellomrom fra strengen " Hello World ":

trim(' Hello World  ')

Og returnerer dette resultatet: "Hello World"

Union

Returner en samling som har alle elementene fra de angitte samlingene. Hvis du vil vises i resultatet, kan et element vises i en hvilken som helst samling som sendes til denne funksjonen. Hvis ett eller flere elementer har samme navn, vises det siste elementet med dette navnet i resultatet.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parameter Kreves Type Bekrivelse
<samling1>, <samling2>, ... Ja Matrise eller objekt, men ikke begge Samlingene der du vil ha alle elementene
Returverdi Type Bekrivelse
<updatedCollection> Henholdsvis matrise eller objekt En samling med alle elementene fra de angitte samlingene – ingen duplikater

Eksempel

Dette eksemplet henter alle elementene fra disse samlingene:

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

Og returnerer dette resultatet: [1, 2, 3, 10, 101]

uriComponent

Returner en uniform resource identifier (URI) kodet versjon for en streng ved å erstatte url-usikre tegn med escape-tegn. Bruk denne funksjonen i stedet for å kodeUriComponent(). Selv om begge funksjonene fungerer på samme måte, uriComponent() foretrekkes.

uriComponent('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Strengen som skal konverteres til URI-kodet format
Returverdi Type Bekrivelse
<kodet-uri> Streng Den URI-kodede strengen med escape-tegn

Eksempel

Dette eksemplet oppretter en URI-kodet versjon for denne strengen:

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

Og returnerer dette resultatet: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Returner binærversjonen for en URI-komponent (uniform resource identifier).

uriComponentToBinary('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Den URI-kodede strengen som skal konverteres
Returverdi Type Bekrivelse
<binær-for-kodet-uri> Streng Binærversjonen for den URI-kodede strengen. Det binære innholdet er base64-kodet og representert av $content.

Eksempel

Dette eksemplet oppretter den binære versjonen for denne URI-kodede strengen:

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

Og returnerer dette resultatet:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Returner strengversjonen for en URI-kodet streng (uniform resource identifier), som effektivt dekoder den URI-kodede strengen.

uriComponentToString('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Den URI-kodede strengen som skal dekodes
Returverdi Type Bekrivelse
<decoded-uri> Streng Den dekodede versjonen for den URI-kodede strengen

Eksempel

Dette eksemplet oppretter den dekodede strengversjonen for denne URI-kodede strengen:

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

Og returnerer dette resultatet: "https://contoso.com"

utcNow

Returner gjeldende tidsstempel.

utcNow('<format>')

Du kan også angi et annet format med formatparameteren<>.

Parameter Kreves Type Bekrivelse
<Format> No Streng Enten en enkelt formatangitter eller et egendefinert formatmønster. Standardformatet for tidsstempelet er "o" (ååååå-MM-ddTHH:mm:ss.fffffffK), som overholder ISO 8601 og bevarer tidssoneinformasjon.
Returverdi Type Bekrivelse
<gjeldende tidsstempel> Streng Gjeldende dato og klokkeslett

Eksempel 1

La oss si at i dag er 15. april 2018 kl. 13:00:00. Dette eksemplet henter gjeldende tidsstempel:

utcNow()

Og returnerer dette resultatet: "2018-04-15T13:00:00.0000000Z"

Eksempel 2

La oss si at i dag er 15. april 2018 kl. 13:00:00. Dette eksemplet henter gjeldende tidsstempel ved hjelp av det valgfrie D-formatet:

utcNow('D')

Og returnerer dette resultatet: "Sunday, April 15, 2018"

xml

Returner XML-versjonen for en streng som inneholder et JSON-objekt.

xml('<value>')
Parameter Kreves Type Bekrivelse
<Verdi> Ja Streng Strengen med JSON-objektet som skal konverteres
JSON-objektet må bare ha én rotegenskap, som ikke kan være en matrise.
Bruk omvendt skråstrek (\) som escape-tegn for det doble anførselstegnet (").
Returverdi Type Bekrivelse
<XML-versjon> Object Den kodede XML-koden for den angitte strengen eller JSON-objektet

Eksempel 1

Dette eksemplet oppretter XML-versjonen for denne strengen, som inneholder et JSON-objekt:

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

Og returnerer denne XML-filen for resultat:

<name>Sophia Owen</name>

Eksempel 2

La oss si at du har dette JSON-objektet:

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

Dette eksemplet oppretter XML for en streng som inneholder dette JSON-objektet:

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

Og returnerer denne XML-filen for resultat:

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

Xpath

Kontroller XML for noder eller verdier som samsvarer med et XPath-uttrykk (XML Path Language), og returner de samsvarende nodene eller verdiene. Et XPath-uttrykk, eller bare «XPath», hjelper deg med å navigere i en XML-dokumentstruktur, slik at du kan velge noder eller databehandlingsverdier i XML-innholdet.

xpath('<xml>', '<xpath>')
Parameter Kreves Type Bekrivelse
<Xml> Ja Any XML-strengen for å søke etter noder eller verdier som samsvarer med en XPath-uttrykksverdi
<Xpath> Ja Any XPath-uttrykket som brukes til å finne samsvarende XML-noder eller verdier
Returverdi Type Bekrivelse
<xml-node> XML En XML-node når bare én node samsvarer med det angitte XPath-uttrykket
<Verdi> Any Verdien fra en XML-node når bare én enkelt verdi samsvarer med det angitte XPath-uttrykket
[<xml-node1>, <xml-node2>, ...]
-or-
[<value1>, <value2>, ...]		 Matrise En matrise med XML-noder eller verdier som samsvarer med det angitte XPath-uttrykket

Eksempel 1

Dette eksemplet finner noder som samsvarer <count></count> med noden, og legger til disse nodeverdiene med sum() funksjonen:

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

Og returnerer dette resultatet: 30

Eksempel 2

I dette eksemplet finner begge uttrykkene noder som samsvarer <location></location> med noden, i de angitte argumentene, som inkluderer XML med et navneområde. Uttrykkene bruker omvendt skråstrek (\) som et escape-tegn for det doble anførselstegnet (").

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

Her er argumentene:

  • Denne XML-filen, som inkluderer XML-dokumentnavneområdet: xmlns="http://contoso.com"

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

  • XPath-uttrykk her:

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

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

Her er resultatnoden som samsvarer med <location></location> noden:

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

Eksempel 3

Følgende i eksempel 3 finner dette eksemplet verdien i <location></location> noden:

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

Og returnerer dette resultatet: "Paris"

Merk

Man kan legge til kommentarer i dataflytuttrykk, men ikke i datasamlebånduttrykk.

Relatert innhold

Hvis du vil ha instruksjoner om generell parameterbruk, kan du se Parametere for Data Factory i Fabric