Udtryk og funktioner for Data Factory i Microsoft Fabric

Artikel
11/15/2023

Denne artikel indeholder oplysninger om udtryk og funktioner, der understøttes af Data Factory i Microsoft Fabric.

Udtryk

Udtryksværdier i definitionen kan være konstanter eller udtryk, der evalueres på kørselstidspunktet. Eksempler:

"value"

"@pipeline().parameters.password"

Udtryk kan vises hvor som helst i en strengværdi og altid resultere i en anden strengværdi. Hvis en værdi er et udtryk, udtrækkes brødteksten i udtrykket ved at fjerne at-tegnet (@). Hvis der kræves en konstantstreng, der starter med @, skal den være escape-strengen ved hjælp af @@. Følgende eksempler viser, hvordan udtryk evalueres.

Udtryksværdi	Resultat
"parametre"	Tegnene 'parametre' returneres.
"parametre[1]"	Tegnene 'parametre[1]' returneres.
"@@"	Der returneres en streng på 1 tegn, der indeholder '@'.
" @"	En streng på 2 tegn, der indeholder ' @', returneres.

Udtryk kan også vises i strenge ved hjælp af en funktion, der kaldes strenginterpolering , hvor udtryk ombrydes i @{ ... }. Eksempel: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Ved hjælp af strenginterpolering er resultatet altid en streng. Lad os sige, at jeg har defineret myNumber som 42 og myString som foo:

Udtryksværdi	Resultat
"@pipeline().parameters.myString"	Returnerer `foo` som en streng.
"@{pipeline().parameters.myString}"	Returnerer `foo` som en streng.
"@pipeline().parameters.myNumber"	Returnerer `42` som et tal.
"@{pipeline().parameters.myNumber}"	Returnerer `42` som en streng.
"Svaret er: @{pipeline().parameters.myNumber}"	Returnerer strengen `Answer is: 42`.
"@concat('Answer is: ', string(pipeline().parameters.myNumber))"	Returnerer strengen `Answer is: 42`
"Svaret er: @@{pipeline().parameters.myNumber}"	Returnerer strengen `Answer is: @{pipeline().parameters.myNumber}`.

I aktiviteter i kontrolelementflowet, f.eks. ForHver-aktivitet, kan du angive en matrix, der skal gentages for egenskabselementerne, og bruge @item() til at gentage en enkelt optælling i ForEach-aktivitet. Hvis elementer f.eks. er en matrix: [1, 2, 3], @item() returneres 1 i den første gentagelse, 2 i den anden gentagelse og 3 i den tredje gentagelse. Du kan også bruge @range(0,10) like expression til at gentage 10 gange startende med 0, der slutter med 9.

Du kan bruge @activity('aktivitetsnavn' til at registrere output af aktivitet og træffe beslutninger. Overvej en webaktivitet kaldet Web1. For at placere outputtet fra den første aktivitet i brødteksten i den anden ser udtrykket generelt ud som: @activity('Web1').output eller @activity('Web1').output.data eller noget lignende, afhængigt af hvordan outputtet fra den første aktivitet ser ud.

Eksempler

Eksempel på komplekst udtryk

I nedenstående eksempel vises et komplekst eksempel, der refererer til et dybt underfelt med aktivitetsoutput. Hvis du vil referere til en pipelineparameter, der evalueres til et underfelt, skal du bruge [] syntaks i stedet for operatoren dot(.) (som i tilfælde af underfelt1 og underfelt2) som en del af et aktivitetsoutput.

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

Oprettelse af filer dynamisk og navngivning af dem er almindeligt mønster. Lad os udforske nogle få eksempler på dynamisk navngivning af filer.

Føj dato til et filnavn: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
Tilføj DateTime i kundens tidszone: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
Tidspunkt for tilføjelse af udløser: @concat('Test_', pipeline().TriggerTime)
Skriv et brugerdefineret filnavn i en tilknytning Dataflow, når der skrives til en enkelt fil med dato:'Test_' + toString(currentDate()) + '.csv'

I ovenstående tilfælde oprettes der fire dynamiske filnavne startende med Test_.

Dynamisk indholdseditor

Den dynamiske indholdseditor undgår automatisk tegn i dit indhold, når du er færdig med at redigere. Følgende indhold i indholdseditoren er f.eks. en strenginterpolering med en udtryksfunktion.

"@{toUpper('myData')}"

Den dynamiske indholdseditor konverterer over indhold til udtryk "@{toUpper('myData')}". Resultatet af dette udtryk er den formaterede streng, der vises nedenfor.

"MYDATA"

Erstatning af specialtegn

Den dynamiske indholdseditor undgår automatisk tegn som dobbelte anførselstegn og omvendt skråstreg i dit indhold, når du er færdig med at redigere. Dette medfører problemer, hvis du vil erstatte linjeskift eller tabulator ved hjælp af funktionen \n, \t i replace(). Du kan redigere dit dynamiske indhold i kodevisning for at fjerne den ekstra \ i udtrykket, eller du kan følge nedenstående trin for at erstatte specialtegn ved hjælp af udtrykssprog:

URL-kodning i forhold til den oprindelige strengværdi
Erstat den kodede URL-streng, f.eks. linjeskift (%0A), vognretur(%0D), vandret fane(%09).
Afkodning af URL-adresse

Variablen companyName med et newline-tegn i værdien @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) kan f.eks. fjerne tegnet newline.

Contoso- Corporation

Escaping enkelt anførselstegn

Udtryksfunktioner bruger enkelt anførselstegn til strengværdiparametre. Brug to enkelte anførselstegn til at undslippe et ' tegn i strengfunktioner. Udtrykket @concat('Baba', '''s ', 'book store') returnerer f.eks. under resultatet.

Baba's book store

Variabler for pipelineomfang

Der kan refereres til disse systemvariabler overalt i pipelinen.

Variabelnavn	Beskrivelse
@pipeline().DataFactory	Navnet på de data eller Synapse-arbejdsområdet, som pipelinekørslen kører i
@pipeline().Pipeline	Navnet på pipelinen
@pipeline().RunId	Id for den specifikke pipelinekørsel
@pipeline().TriggerId	Id'et for den udløser, der aktiverede pipelinen
@pipeline().TriggerName	Navnet på den udløser, der aktiverede pipelinen
@pipeline().TriggerTime	Tidspunktet for den kørsel af udløseren, der aktiverede pipelinen. Dette er det tidspunkt, hvor udløseren faktisk udløses for at aktivere pipelinekørslen, og det kan afvige en smule fra udløserens planlagte tidspunkt.
@pipeline().GroupId	Id'et for den gruppe, som pipelinekørslen tilhører.
@pipeline()?. TriggeredByPipelineName	Navnet på den pipeline, der udløser pipelinekørslen. Gælder, når pipelinekørslen udløses af en ExecutePipeline-aktivitet. Evaluer til Null , når det bruges i andre tilfælde. Bemærk spørgsmålstegnet efter @pipeline()
@pipeline()?. TriggeredByPipelineRunId	Kør id'et for den pipeline, der udløser pipelinekørslen. Gælder, når pipelinekørslen udløses af en ExecutePipeline-aktivitet. Evaluer til Null , når det bruges i andre tilfælde. Bemærk spørgsmålstegnet efter @pipeline()

Bemærk

Systemvariabler relateret til udløsere (både i pipeline- og udløserområder) returnerer UTC-datoer i ISO 8601-format, 2017-06-01T22:20:00.4061448Zf.eks. .

Funktioner

Du kan kalde funktioner i udtryk. Følgende afsnit indeholder oplysninger om de funktioner, der kan bruges i et udtryk.

Datofunktioner

Funktionen Dato eller klokkeslæt	Opgave
addDays	Føj et antal dage til et tidsstempel.
addHours	Føj et antal timer til et tidsstempel.
addMinutes	Føj et antal minutter til et tidsstempel.
addSeconds	Føj et antal sekunder til et tidsstempel.
addToTime	Føj et antal tidsenheder til et tidsstempel. Se også getFutureTime.
convertFromUtc	Konvertér et tidsstempel fra UTC (Universal Time Coordinated) til måltidszonen.
convertTimeZone	Konvertér et tidsstempel fra kildetidszonen til måltidszonen.
convertToUtc	Konvertér et tidsstempel fra kildetidszonen til UTC (Universal Time Coordinated).
dayOfMonth	Returner dag i månedskomponenten fra et tidsstempel.
dayOfWeek	Returner ugedagskomponenten fra et tidsstempel.
dayOfYear	Returner dag i år-komponenten fra et tidsstempel.
formatDateTime	Returner tidsstemplet som en streng i valgfrit format.
getFutureTime	Returner det aktuelle tidsstempel plus de angivne tidsenheder. Se også addToTime.
getPastTime	Returner det aktuelle tidsstempel minus de angivne tidsenheder. Se også subtraherFromTime.
startOfDay	Returner starten af dagen for et tidsstempel.
startOfHour	Returner timestart for et tidsstempel.
startOfMonth	Returner starten af måneden for et tidsstempel.
subtraherFromTime	Træk et antal tidsenheder fra et tidsstempel. Se også getPastTime.
Flåter	Returner egenskabsværdien `ticks` for et angivet tidsstempel.
utcNow	Returner det aktuelle tidsstempel som en streng.

Strengfunktioner

Hvis du vil arbejde med strenge, kan du bruge disse strengfunktioner og også nogle samlingsfunktioner. Strengfunktioner fungerer kun på strenge.

Strengfunktion	Opgave
Concat	Kombiner to eller flere strenge, og returner den kombinerede streng.
endsWith	Kontrollér, om en streng slutter med den angivne understreng.
Guid	Opret et globalt entydigt id (GUID) som en streng.
indexOf	Returner startpositionen for en understreng.
lastIndexOf	Returner startpositionen for den sidste forekomst af en understreng.
replace	Erstat en understreng med den angivne streng, og returner den opdaterede streng.
split	Returnerer en matrix, der indeholder understrenge, adskilt af kommaer, fra en større streng, der er baseret på et angivet afgrænsertegn i den oprindelige streng.
startsWith	Kontrollér, om en streng starter med en bestemt understreng.
Understreng	Returnerer tegn fra en streng med start fra den angivne placering.
toLower	Returner en streng med små bogstaver.
toUpper	Returnerer en streng med store bogstaver.
Trim	Fjern foranstillede og efterstillede mellemrum fra en streng, og returner den opdaterede streng.

Indsamlingsfunktioner

Hvis du vil arbejde med samlinger, generelt matrixer, strenge og nogle gange ordbøger, kan du bruge disse samlingsfunktioner.

Funktionen Collection	Opgave
Indeholder	Kontrollér, om en samling har et bestemt element.
tom	Kontrollér, om en samling er tom.
Første	Returner det første element fra en samling.
Skæringspunktet mellem	Returner en samling, der kun indeholder de fælles elementer på tværs af de angivne samlinger.
Deltage	Returner en streng, der indeholder alle elementerne fra en matrix adskilt af det angivne tegn.
Sidste	Returner det sidste element fra en samling.
Længde	Returner antallet af elementer i en streng eller matrix.
Springe	Fjern elementer fra forsiden af en samling, og returner alle de andre elementer.
Tage	Returner elementer fra forsiden af en samling.
Unionen	Returner en samling, der indeholder alle elementerne fra de angivne samlinger.

Logiske funktioner

Disse funktioner er nyttige i forhold. De kan bruges til at evaluere enhver type logik.

Logisk sammenligningsfunktion	Opgave
and	Kontrollér, om alle udtryk er sande.
Svarer	Kontrollér, om begge værdier er ækvivalente.
greater	Kontrollér, om den første værdi er større end den anden værdi.
greaterOrEquals	Kontrollér, om den første værdi er større end eller lig med den anden værdi.
Hvis	Kontrollér, om et udtryk er true eller false. På baggrund af resultatet skal du returnere en angivet værdi.
less	Kontrollér, om den første værdi er mindre end den anden værdi.
lessOrEquals	Kontrollér, om den første værdi er mindre end eller lig med den anden værdi.
Ikke	Kontrollér, om et udtryk er falsk.
or	Kontrollér, om mindst ét udtryk er sandt.

Konverteringsfunktioner

Disse funktioner bruges til at konvertere mellem hver af de oprindelige typer på sproget:

string
integer
flydende felter
boolean
Arrays
Ordbøger

Konverteringsfunktion	Opgave
Array	Returnerer en matrix fra et enkelt angivet input. Du kan få flere input under createArray.
base64	Returner den base64-kodede version for en streng.
base64ToBinary	Returner den binære version for en base64-kodet streng.
base64ToString	Returner strengversionen for en base64-kodet streng.
Binære	Returner den binære version for en inputværdi.
Bool	Returner den booleske version for en inputværdi.
Hånd	Returner den første værdi, der ikke er null, fra en eller flere parametre.
createArray	Returner en matrix fra flere input.
dataUri	Returner data-URI'en for en inputværdi.
dataUriToBinary	Returner den binære version for en data-URI.
dataUriToString	Returner strengversionen for en data-URI.
decodeBase64	Returner strengversionen for en base64-kodet streng.
decodeDataUri	Returner den binære version for en data-URI.
decodeUriComponent	Returner en streng, der erstatter escape-tegn med afkodede versioner.
encodeUriComponent	Returner en streng, der erstatter url-usikre tegn med escape-tegn.
Flyde	Returnerer et flydende tal for en inputværdi.
Int	Returner heltalsversionen for en streng.
Streng	Returner strengversionen for en inputværdi.
uri-komponent	Returner den URI-kodede version for en inputværdi ved at erstatte URL-usikre tegn med escape-tegn.
uriComponentToBinary	Returner den binære version for en URI-kodet streng.
uriComponentToString	Returner strengversionen for en URI-kodet streng.
Xml	Returner XML-versionen for en streng.
Xpath	Kontrollér XML for noder eller værdier, der svarer til et XPath-udtryk (XML Path Language), og returner de matchende noder eller værdier.

Matematiske funktioner

Disse funktioner kan bruges til begge typer tal: heltal og flydende værdier.

Matematisk funktion	Opgave
Tilføj	Returner resultatet ved at tilføje to tal.
Div	Returnerer resultatet ved at dividere to tal.
Maks	Returnerer den højeste værdi fra et sæt tal eller en matrix.
Min	Returner den laveste værdi fra et sæt tal eller en matrix.
mod	Returnerer resten fra at dividere to tal.
Mul	Returner produktet ved at multiplicere to tal.
rand	Returnerer et tilfældigt heltal fra et angivet område.
range	Returner en heltalsmatrix, der starter fra et angivet heltal.
Sub	Returnerer resultatet fra at trække det andet tal fra det første tal.

Funktionsreference

I dette afsnit vises alle tilgængelige funktioner i alfabetisk rækkefølge.

Tilføj

Returner resultatet ved at tilføje to tal.

add(<summand_1>, <summand_2>)

Parameter	Obligatorisk	Type	Description
<>summand_1, <summand_2>	Ja	Heltal, flydende eller blandet	De tal, der skal tilføjes

Returværdi	Skriv	Description
<result-sum>	Heltal eller flydende	Resultatet af at tilføje de angivne tal

Eksempel

I dette eksempel tilføjes de angivne tal:

add(1, 1.5)

Og returnerer dette resultat: 2.5

addDays

Føj et antal dage til et tidsstempel.

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<Dage>	Ja	Heltal	Det positive eller negative antal dage, der skal tilføjes
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<opdateret tidsstempel>	String	Tidsstemplet plus det angivne antal dage

Eksempel 1

I dette eksempel føjes 10 dage til det angivne tidsstempel:

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

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

Eksempel 2

I dette eksempel trækkes fem dage fra det angivne tidsstempel:

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

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

addHours

Føj et antal timer til et tidsstempel.

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<Timer>	Ja	Heltal	Det positive eller negative antal timer, der skal tilføjes
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<opdateret tidsstempel>	String	Tidsstemplet plus det angivne antal timer

Eksempel 1

I dette eksempel føjes 10 timer til det angivne tidsstempel:

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

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

Eksempel 2

I dette eksempel trækkes fem timer fra det angivne tidsstempel:

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

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

addMinutes

Føj et antal minutter til et tidsstempel.

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<Minutter>	Ja	Heltal	Det positive eller negative antal minutter, der skal tilføjes
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<opdateret tidsstempel>	String	Tidsstemplet plus det angivne antal minutter

Eksempel 1

Dette eksempel føjer 10 minutter til det angivne tidsstempel:

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

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

Eksempel 2

I dette eksempel trækkes fem minutter fra det angivne tidsstempel:

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

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

addSeconds

Føj et antal sekunder til et tidsstempel.

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<Sekunder>	Ja	Heltal	Det positive eller negative antal sekunder, der skal tilføjes
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<opdateret tidsstempel>	String	Tidsstempel plus det angivne antal sekunder

Eksempel 1

I dette eksempel føjes 10 sekunder til det angivne tidsstempel:

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

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

Eksempel 2

I dette eksempel trækkes fem sekunder fra det angivne tidsstempel:

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

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

addToTime

Føj et antal tidsenheder til et tidsstempel. Se også getFutureTime().

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<interval>	Ja	Heltal	Det antal angivne tidsenheder, der skal tilføjes
<timeUnit>	Ja	String	Den tidsenhed, der skal bruges med intervallet: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<opdateret tidsstempel>	String	Tidsstempel plus det angivne antal tidsenheder

Eksempel 1

I dette eksempel føjes en dag til det angivne tidsstempel:

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

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

Eksempel 2

I dette eksempel føjes en dag til det angivne tidsstempel:

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

Og returnerer resultatet ved hjælp af det valgfri "D"-format: "Tuesday, January 2, 2018"

og

Kontrollér, om begge udtryk er sande. Returnerer true, når begge udtryk er true, eller returnerer false, når mindst ét udtryk er false.

and(<expression1>, <expression2>)

Parameter	Obligatorisk	Type	Description
<expression1>, <expression2>	Ja	Boolean	De udtryk, der skal kontrolleres

Returværdi	Skriv	Description
true eller false	Boolean	Returner true, når begge udtryk er true. Returnerer false, når mindst ét udtryk er falsk.

Eksempel 1

Disse eksempler kontrollerer, om de angivne booleske værdier begge er sande:

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

Og returnerer disse resultater:

Første eksempel: Begge udtryk er sande, så returnerer true.
Andet eksempel: Et udtryk er falsk, så returnerer false.
Tredje eksempel: Begge udtryk er false, så returnerer false.

Eksempel 2

Disse eksempler kontrollerer, om de angivne udtryk begge er sande:

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

Og returnerer disse resultater:

Første eksempel: Begge udtryk er sande, så returnerer true.
Andet eksempel: Et udtryk er falsk, så returnerer false.
Tredje eksempel: Begge udtryk er false, så returnerer false.

matrix

Returnerer en matrix fra et enkelt angivet input. Du kan få flere input under createArray().

array('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Strengen til oprettelse af en matrix

Returværdi	Skriv	Description
[<værdi>]	Matrix	En matrix, der indeholder det angivne input

Eksempel

I dette eksempel oprettes en matrix ud fra strengen "hello":

array('hello')

Og returnerer dette resultat: ["hello"]

base64

Returner den base64-kodede version for en streng.

base64('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Inputstrengen

Returværdi	Skriv	Description
<base64-streng>	String	Den base64-kodede version for inputstrengen

Eksempel

I dette eksempel konverteres strengen "hello" til en base64-kodet streng:

base64('hello')

Og returnerer dette resultat: "aGVsbG8="

base64ToBinary

Returner den binære version for en base64-kodet streng.

base64ToBinary('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den base64-kodede streng, der skal konverteres

Returværdi	Skriv	Description
<binary-for-base64-string>	String	Den binære version for den base64-kodede streng

Eksempel

I dette eksempel konverteres den base64-kodede base64-kodede streng "aGVsbG8=" til en binær streng:

base64ToBinary('aGVsbG8=')

Og returnerer dette resultat:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Returner strengversionen for en base64-kodet streng, hvor base64-strengen afkodes effektivt. Brug denne funktion i stedet for at afkodeBase64(). Selvom begge funktioner fungerer på samme måde, base64ToString() foretrækkes.

base64ToString('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den base64-kodede streng, der skal afkodes

Returværdi	Skriv	Description
<decoded-base64-string>	String	Strengversionen for en base64-kodet streng

Eksempel

I dette eksempel konverteres den base64-kodede base64-kodede streng "aGVsbG8=" til en streng:

base64ToString('aGVsbG8=')

Og returnerer dette resultat: "hello"

Binære

Returner den binære version for en streng.

binary('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den streng, der skal konverteres

Returværdi	Skriv	Description
<binary-for-input-value>	String	Den binære version for den angivne streng

Eksempel

I dette eksempel konverteres strengen "hello" til en binær streng:

binary('hello')

Og returnerer dette resultat:

"0110100001100101011011000110110001101111"

bool

Returner den booleske version for en værdi.

bool(<value>)

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	Any	Den værdi, der skal konverteres

Returværdi	Skriv	Description
true eller false	Boolean	Den booleske version for den angivne værdi

Eksempel

Disse eksempler konverterer de angivne værdier til booleske værdier:

bool(1)
bool(0)

Og returnerer disse resultater:

Første eksempel: true
Andet eksempel: false

Hånd

Returner den første værdi, der ikke er null, fra en eller flere parametre. Tomme strenge, tomme matrixer og tomme objekter er ikke null.

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

Parameter	Obligatorisk	Type	Description
<>object_1, <object_2>, ...	Ja	Enhver kan blande typer	Et eller flere elementer, der skal kontrolleres for null

Returværdi	Skriv	Description
<første-ikke-null-element>	Any	Det første element eller den første værdi, der ikke er null. Hvis alle parametre er null, returnerer denne funktion null.

Eksempel

Disse eksempler returnerer den første værdi, der ikke er null, fra de angivne værdier eller null, når alle værdierne er null:

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

Og returnerer disse resultater:

Første eksempel: true
Andet eksempel: "hello"
Tredje eksempel: null

concat

Kombiner to eller flere strenge, og returner den kombinerede streng.

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

Parameter	Obligatorisk	Type	Description
<text1>, <text2>, ...	Ja	String	Mindst to strenge, der skal kombineres

Returværdi	Skriv	Description
<text1text2...>	String	Den streng, der er oprettet ud fra de kombinerede inputstrenge

Eksempel

I dette eksempel kombineres strengene "Hello" og "World":

concat('Hello', 'World')

Og returnerer dette resultat: "HelloWorld"

indeholder

Kontrollér, om en samling har et bestemt element. Returner true, når elementet findes, eller returner false, når det ikke blev fundet. Der er forskel på store og små bogstaver i denne funktion.

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

Denne funktion fungerer specifikt på disse samlingstyper:

En streng til at finde en understreng
En matrix til at finde en værdi
En ordbog til at finde en nøgle

Parameter	Obligatorisk	Type	Description
<Samling>	Ja	Streng, matrix eller ordbog	Den samling, der skal kontrolleres
<Værdi>	Ja	Streng, matrix eller ordbog	Det element, der skal søges efter

Returværdi	Skriv	Description
true eller false	Boolean	Returner sand, når elementet findes. Returner false, når den ikke blev fundet.

Eksempel 1

I dette eksempel kontrolleres strengen "hello world" for understrengen "world" og returneres true:

contains('hello world', 'world')

Eksempel 2

I dette eksempel kontrolleres strengen "hello world" for understrengen "universe" og returneres false:

contains('hello world', 'universe')

convertFromUtc

Konvertér et tidsstempel fra UTC (Universal Time Coordinated) til måltidszonen.

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<destinationTimeZone>	Ja	String	Navnet på måltidszonen. Du kan se navne på tidszoner i Microsoft Tidszoneværdier, men du skal muligvis fjerne tegnsætning fra tidszonenavnet.
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<konverteret tidsstempel>	String	Det tidsstempel, der er konverteret til måltidszonen

Eksempel 1

I dette eksempel konverteres et tidsstempel til den angivne tidszone:

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

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

Eksempel 2

I dette eksempel konverteres et tidsstempel til den angivne tidszone og det angivne format:

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

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

convertTimeZone

Konvertér et tidsstempel fra kildetidszonen til måltidszonen.

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<sourceTimeZone>	Ja	String	Navnet på kildetidszonen. Du kan se navne på tidszoner i Microsoft Tidszoneværdier, men du skal muligvis fjerne tegnsætning fra tidszonenavnet.
<destinationTimeZone>	Ja	String	Navnet på måltidszonen. Du kan se navne på tidszoner i Microsoft Tidszoneværdier, men du skal muligvis fjerne tegnsætning fra tidszonenavnet.
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<konverteret tidsstempel>	String	Det tidsstempel, der er konverteret til måltidszonen

Eksempel 1

I dette eksempel konverteres kildetidszonen til måltidszonen:

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

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

Eksempel 2

I dette eksempel konverteres en tidszone til den angivne tidszone og det angivne format:

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

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

convertToUtc

Konvertér et tidsstempel fra kildetidszonen til UTC (Universal Time Coordinated).

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<sourceTimeZone>	Ja	String	Navnet på kildetidszonen. Du kan se navne på tidszoner i Microsoft Tidszoneværdier, men du skal muligvis fjerne tegnsætning fra tidszonenavnet.
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<konverteret tidsstempel>	String	Tidsstempel konverteret til UTC

Eksempel 1

I dette eksempel konverteres et tidsstempel til UTC:

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

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

Eksempel 2

I dette eksempel konverteres et tidsstempel til UTC:

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

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

createArray

Returner en matrix fra flere input. Du kan se enkelte inputmatrixer under matrix().

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

Parameter	Obligatorisk	Type	Description
<object1>, <object2>, ...	Ja	Enhver, men ikke blandet	Mindst to elementer for at oprette matrixen

Returværdi	Skriv	Description
[<objekt1>, <objekt2>, ...]	Matrix	Den matrix, der er oprettet ud fra alle inputelementer

Eksempel

I dette eksempel oprettes der en matrix ud fra disse input:

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

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

dataUri

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

dataUri('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den streng, der skal konverteres

Returværdi	Skriv	Description
<data-uri>	String	Data-URI'en for inputstrengen

Eksempel

I dette eksempel oprettes en data-URI for strengen "hello":

dataUri('hello')

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

dataUriToBinary

Returner den binære version for en URI (Data Uniform Resource Identifier). Brug denne funktion i stedet for decodeDataUri(). Selvom begge funktioner fungerer på samme måde, dataUriBinary() foretrækkes.

dataUriToBinary('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den data-URI, der skal konverteres

Returværdi	Skriv	Description
<binary-for-data-uri>	String	Den binære version for data-URI'en

Eksempel

I dette eksempel oprettes der en binær version for denne data-URI:

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

Og returnerer dette resultat:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Returner strengversionen for et datauniformet ressource-id (URI).

dataUriToString('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den data-URI, der skal konverteres

Returværdi	Skriv	Description
<string-for-data-uri>	String	Strengversionen for data-URI'en

Eksempel

I dette eksempel oprettes der en streng til denne data-URI:

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

Og returnerer dette resultat: "hello"

dayOfMonth

Returner dagen i måneden fra et tidsstempel.

dayOfMonth('<timestamp>')

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet

Returværdi	Skriv	Description
<dag i måneden>	Heltal	Dagen i måneden fra det angivne tidsstempel

Eksempel

I dette eksempel returneres tallet for dagen i måneden fra dette tidsstempel:

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

Og returnerer dette resultat: 15

dayOfWeek

Returner ugedagen fra et tidsstempel.

dayOfWeek('<timestamp>')

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet

Returværdi	Skriv	Description
<ugedag>	Heltal	Ugedagen fra det angivne tidsstempel, hvor søndag er 0, mandag er 1 osv.

Eksempel

I dette eksempel returneres tallet for ugedagen fra dette tidsstempel:

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

Og returnerer dette resultat: 3

dayOfYear

Returner dagen i året fra et tidsstempel.

dayOfYear('<timestamp>')

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet

Returværdi	Skriv	Description
<dag i året>	Heltal	Dagen i året fra det angivne tidsstempel

Eksempel

I dette eksempel returneres antallet af dagen i året fra dette tidsstempel:

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

Og returnerer dette resultat: 74

decodeBase64

Returner strengversionen for en base64-kodet streng, hvor base64-strengen afkodes effektivt. Overvej at bruge base64ToString() i stedet decodeBase64()for . Selvom begge funktioner fungerer på samme måde, base64ToString() foretrækkes.

decodeBase64('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den base64-kodede streng, der skal afkodes

Returværdi	Skriv	Description
<decoded-base64-string>	String	Strengversionen for en base64-kodet streng

Eksempel

I dette eksempel oprettes en streng for en base64-kodet streng:

decodeBase64('aGVsbG8=')

Og returnerer dette resultat: "hello"

decodeDataUri

Returner den binære version for en URI (Data Uniform Resource Identifier). Overvej at bruge dataUriToBinary() i stedet decodeDataUri()for . Selvom begge funktioner fungerer på samme måde, dataUriToBinary() foretrækkes.

decodeDataUri('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den data-URI-streng, der skal afkodes

Returværdi	Skriv	Description
<binary-for-data-uri>	String	Den binære version for en data-URI-streng

Eksempel

I dette eksempel returneres den binære version for denne data-URI:

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

Og returnerer dette resultat:

decodeUriComponent

Returner en streng, der erstatter escape-tegn med afkodede versioner.

decodeUriComponent('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Strengen med escape-tegnene til afkodning

Returværdi	Skriv	Description
<decoded-uri>	String	Den opdaterede streng med de afkodede escape-tegn

Eksempel

I dette eksempel erstattes escape-tegnene i denne streng med afkodede versioner:

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

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

Div

Returnerer heltalsresultatet ved at dividere to tal. Hvis du vil have vist restresultatet, skal du se mod().

div(<dividend>, <divisor>)

Parameter	Obligatorisk	Type	Description
<Udbytte>	Ja	Heltal eller flydende	Det tal, der skal divideres med divisoren
<Divisor>	Ja	Heltal eller flydende	Det tal, der dividerer dividenden, men ikke kan være 0

Returværdi	Skriv	Description
<kvotient-resultat>	Heltal	Heltalsresultatet ved at dividere det første tal med det andet tal

Eksempel

I begge eksempler divideres det første tal med det andet tal:

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

Og returner dette resultat: 2

encodeUriComponent

Returner en URI-kodet version (Uniform Resource Identifier) for en streng ved at erstatte url-usikre tegn med escape-tegn. Overvej at bruge uriComponent() i stedet encodeUriComponent()for . Selvom begge funktioner fungerer på samme måde, uriComponent() foretrækkes.

encodeUriComponent('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den streng, der skal konverteres til URI-kodet format

Returværdi	Skriv	Description
<encoded-uri>	String	Den URI-kodede streng med escape-tegn

Eksempel

I dette eksempel oprettes en URI-kodet version for denne streng:

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

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

tom

Kontrollér, om en samling er tom. Returner true, når samlingen er tom, eller returner false, når den ikke er tom.

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

Parameter	Obligatorisk	Type	Description
<Samling>	Ja	Streng, matrix eller objekt	Den samling, der skal kontrolleres

Returværdi	Skriv	Description
true eller false	Boolean	Returner true, når samlingen er tom. Returner false, når den ikke er tom.

Eksempel

Disse eksempler kontrollerer, om de angivne samlinger er tomme:

empty('')
empty('abc')

Og returnerer disse resultater:

Første eksempel: Overfører en tom streng, så funktionen returnerer true.
Andet eksempel: Overfører strengen "abc", så funktionen returnerer false.

endsWith

Kontrollér, om en streng slutter med en bestemt understreng. Returner true, når understrengen findes, eller returner false, når den ikke blev fundet. Der er ikke forskel på store og små bogstaver i denne funktion.

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

Parameter	Obligatorisk	Type	Beskrivelse
<Tekst>	Ja	String	Den streng, der skal kontrolleres
<Tekstdergennemsøges>	Ja	String	Den slutunderstreng, der skal søges efter

Returværdi	Skriv	Description
true eller false	Boolean	Returner true, når slutunderstrengen findes. Returner false, når den ikke blev fundet.

Eksempel 1

I dette eksempel kontrolleres det, om strengen "hello world" slutter med strengen "world":

endsWith('hello world', 'world')

Og returnerer dette resultat: true

Eksempel 2

I dette eksempel kontrolleres det, om strengen "hello world" slutter med strengen "univers":

endsWith('hello world', 'universe')

Og returnerer dette resultat: false

equals

Kontrollér, om begge værdier, udtryk eller objekter er ækvivalente. Returner true, når begge er ækvivalente, eller returner false, når de ikke svarer til hinanden.

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

Parameter	Obligatorisk	Type	Description
<objekt1>, <objekt2>	Ja	Forskellige	De værdier, udtryk eller objekter, der skal sammenlignes

Returværdi	Skriv	Description
true eller false	Boolean	Returner true, når begge er ækvivalente. Returnerer false, når den ikke svarer til værdien.

Eksempel

Disse eksempler kontrollerer, om de angivne input er ækvivalente.

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

Og returnerer disse resultater:

Første eksempel: Begge værdier er ækvivalente, så funktionen returnerer true.
Andet eksempel: Begge værdier er ikke ækvivalente, så funktionen returnerer false.

Første

Returner det første element fra en streng eller matrix.

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

Parameter	Obligatorisk	Type	Description
<Samling>	Ja	Streng eller matrix	Samlingen, hvor du kan finde det første element

Returværdi	Skriv	Description
<first-collection-item>	Any	Det første element i samlingen

Eksempel

Disse eksempler finder det første element i disse samlinger:

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

Og returner disse resultater:

Første eksempel: "h"
Andet eksempel: 0

flydende felter

Konvertér en strengversion for et flydende tal til et faktisk flydende tal.

float('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den streng, der har et gyldigt flydende tal, der skal konverteres

Returværdi	Skriv	Description
<float-value>	Flyde	Det flydende tal for den angivne streng

Eksempel

I dette eksempel oprettes der en strengversion for dette flydende tal:

float('10.333')

Og returnerer dette resultat: 10.333

formatDateTime

Returner et tidsstempel i det angivne format.

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<omformateret tidsstempel>	String	Det opdaterede tidsstempel i det angivne format

Eksempel

I dette eksempel konverteres et tidsstempel til det angivne format:

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

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

getFutureTime

Returner det aktuelle tidsstempel plus de angivne tidsenheder.

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

Parameter	Obligatorisk	Type	Description
<interval>	Ja	Heltal	Det antal angivne tidsenheder, der skal tilføjes
<timeUnit>	Ja	String	Den tidsenhed, der skal bruges med intervallet: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<opdateret tidsstempel>	String	Det aktuelle tidsstempel plus det angivne antal tidsenheder

Eksempel 1

Lad os antage, at det aktuelle tidsstempel er "2018-03-01T00:00:00.0000000Z". I dette eksempel føjes fem dage til dette tidsstempel:

getFutureTime(5, 'Day')

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

Eksempel 2

Lad os antage, at det aktuelle tidsstempel er "2018-03-01T00:00:00.0000000Z". I dette eksempel tilføjes fem dage, og resultatet konverteres til "D"-format:

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

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

getPastTime

Returner det aktuelle tidsstempel minus de angivne tidsenheder.

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

Parameter	Obligatorisk	Type	Description
<interval>	Ja	Heltal	Det antal angivne tidsenheder, der skal trækkes fra
<timeUnit>	Ja	String	Den tidsenhed, der skal bruges med intervallet: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<opdateret tidsstempel>	String	Det aktuelle tidsstempel minus det angivne antal tidsenheder

Eksempel 1

Lad os antage, at det aktuelle tidsstempel er "2018-02-01T00:00:00.0000000Z". I dette eksempel trækkes fem dage fra dette tidsstempel:

getPastTime(5, 'Day')

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

Eksempel 2

Lad os antage, at det aktuelle tidsstempel er "2018-02-01T00:00:00.0000000Z". Dette eksempel trækker fem dage fra og konverterer resultatet til "D"-format:

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

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

greater

Kontrollér, om den første værdi er større end den anden værdi. Returner true, når den første værdi er mere, eller returner false, når den er mindre.

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

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	Heltal, flydende eller streng	Den første værdi, der kontrollerer, om den er større end den anden værdi
<compareTo>	Ja	Henholdsvis Heltal, Flydende eller Streng	Sammenligningsværdien

Returværdi	Skriv	Description
true eller false	Boolean	Returnerer true, når den første værdi er større end den anden værdi. Returnerer false, når den første værdi er lig med eller mindre end den anden værdi.

Eksempel

Disse eksempler kontrollerer, om den første værdi er større end den anden værdi:

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

Og returner disse resultater:

Første eksempel: true
Andet eksempel: false

greaterOrEquals

Kontrollér, om den første værdi er større end eller lig med den anden værdi. Returnerer true, når den første værdi er større eller lig med, eller returnerer false, når den første værdi er mindre.

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

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	Heltal, flydende eller streng	Den første værdi, der skal kontrolleres, om den er større end eller lig med den anden værdi
<compareTo>	Ja	Henholdsvis Heltal, Flydende eller Streng	Sammenligningsværdien

Returværdi	Skriv	Description
true eller false	Boolean	Returnerer true, når den første værdi er større end eller lig med den anden værdi. Returnerer false, når den første værdi er mindre end den anden værdi.

Eksempel

Disse eksempler kontrollerer, om den første værdi er større eller lig med den anden værdi:

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

Og returner disse resultater:

Første eksempel: true
Andet eksempel: false

Guid

Generér et GUID (Globally Unique Identifier) som en streng, f.eks. "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Du kan også angive et andet format for GUID'et end standardformatet "D", som er 32 cifre adskilt af bindestreger.

guid('<format>')

Parameter	Obligatorisk	Type	Description
<Format>	Nej	String	En enkelt formatangivelse for det returnerede GUID. Formatet er som standard "D", men du kan bruge "N", "D", "B", "P" eller "X".

Returværdi	Skriv	Description
<GUID-værdi>	String	Et tilfældigt genereret GUID

Eksempel

I dette eksempel genereres det samme GUID, men som 32 cifre adskilt af bindestreger og omsluttet af parenteser:

guid('P')

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

if

Kontrollér, om et udtryk er true eller false. På baggrund af resultatet skal du returnere en angivet værdi.

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

Parameter	Obligatorisk	Type	Description
<Udtryk>	Ja	Boolean	Det udtryk, der skal kontrolleres
<valueIfTrue>	Ja	Any	Den værdi, der skal returneres, når udtrykket er true
<valueIfFalse>	Ja	Any	Den værdi, der skal returneres, når udtrykket er falsk

Returværdi	Skriv	Description
<specified-return-value>	Any	Den angivne værdi, der returnerer, afhængigt af om udtrykket er true eller false

Eksempel

Dette eksempel returnerer "yes" , fordi det angivne udtryk returnerer true. Ellers returnerer "no"eksemplet :

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

indexOf

Returner startplaceringen eller indeksværdien for en understreng. Der er ikke forskel på store og små bogstaver i denne funktion, og indeks starter med tallet 0.

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

Parameter	Obligatorisk	Type	Beskrivelse
<Tekst>	Ja	String	Den streng, der har den understreng, der skal søges efter
<Tekstdergennemsøges>	Ja	String	Den understreng, der skal søges efter

Returværdi	Skriv	Description
<indeksværdi>	Heltal	Startpositionen eller indeksværdien for den angivne understreng. Hvis strengen ikke findes, skal du returnere tallet -1.

Eksempel

I dette eksempel findes startindeksværdien for understrengen "world" i strengen "hello world":

indexOf('hello world', 'world')

Og returnerer dette resultat: 6

heltal

Returner heltalsversionen for en streng.

int('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den streng, der skal konverteres

Returværdi	Skriv	Description
<integer-result>	Heltal	Heltalsversionen for den angivne streng

Eksempel

I dette eksempel oprettes der et heltal for strengen "10":

int('10')

Og returnerer dette resultat: 10

json

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

json('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	Streng eller XML	Den streng eller XML, der skal konverteres

Returværdi	Skriv	Description
<JSON-resultat>	Oprindelig JSON-type eller -objekt	Den oprindelige JSON-typeværdi eller -objekt for den angivne streng eller XML. Hvis strengen er null, returnerer funktionen et tomt objekt.

Eksempel 1

I dette eksempel konverteres denne streng til JSON-værdien:

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

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

Eksempel 2

I dette eksempel konverteres denne streng til JSON:

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

Og returnerer dette resultat:

{
  "fullName": "Sophia Owen"
}

Eksempel 3

Dette eksempel konverterer denne XML til JSON:

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

Og returnerer dette resultat:

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

Skæringspunktet mellem

Returner en samling, der kun indeholder de fælles elementer på tværs af de angivne samlinger. Hvis et element skal vises i resultatet, skal det vises i alle de samlinger, der overføres til denne funktion. Hvis et eller flere elementer har det samme navn, vises det sidste element med dette navn i resultatet.

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

Parameter	Obligatorisk	Type	Description
<collection1>, <collection2>, ...	Ja	Matrix eller objekt, men ikke begge	De samlinger, hvor du kun vil have de almindelige elementer fra

Returværdi	Skriv	Description
<almindelige elementer>	Matrix eller objekt, henholdsvis	En samling, der kun indeholder almindelige elementer på tværs af de angivne samlinger

Eksempel

I dette eksempel findes de almindelige elementer på tværs af disse matrixer:

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

Og returnerer en matrix med kun disse elementer: [1, 2]

join

Returnerer en streng, der indeholder alle elementerne fra en matrix og har hvert tegn adskilt af en afgrænser.

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

Parameter	Obligatorisk	Type	Description
<Samling>	Ja	Matrix	Den matrix, der indeholder de elementer, der skal joinforbindes
<Afgrænser>	Ja	String	Den separator, der vises mellem hvert tegn i den resulterende streng

Returværdi	Skriv	Description
<tegn1><afgrænser><tegn2><afgrænser...>	String	Den resulterende streng, der er oprettet ud fra alle elementerne i den angivne matrix

Eksempel

I dette eksempel oprettes der en streng ud fra alle elementerne i denne matrix med det angivne tegn som afgrænser:

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

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

Sidste

Returner det sidste element fra en samling.

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

Parameter	Obligatorisk	Type	Description
<Samling>	Ja	Streng eller matrix	Den samling, hvor du kan finde det sidste element

Returværdi	Skriv	Description
<last-collection-item>	Henholdsvis streng eller matrix	Det sidste element i samlingen

Eksempel

Disse eksempler finder det sidste element i disse samlinger:

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

Og returnerer disse resultater:

Første eksempel: "d"
Andet eksempel: 3

lastIndexOf

Returner startpositionen eller indeksværdien for den sidste forekomst af en understreng. Der er ikke forskel på store og små bogstaver i denne funktion, og indeks starter med tallet 0.

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

Parameter	Obligatorisk	Type	Beskrivelse
<Tekst>	Ja	String	Den streng, der har den understreng, der skal søges efter
<Tekstdergennemsøges>	Ja	String	Den understreng, der skal søges efter

Returværdi	Skriv	Description
<ending-index-value>	Heltal	Startpositionen eller indeksværdien for den sidste forekomst af den angivne understreng. Hvis strengen ikke findes, skal du returnere tallet -1.

Eksempel

I dette eksempel findes startindeksværdien for den sidste forekomst af understrengen "world" i strengen "hello world":

lastIndexOf('hello world', 'world')

Og returnerer dette resultat: 6

length

Returner antallet af elementer i en samling.

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

Parameter	Obligatorisk	Type	Description
<Samling>	Ja	Streng eller matrix	Samlingen med de elementer, der skal tælles

Returværdi	Skriv	Description
<length-or-count>	Heltal	Antallet af elementer i samlingen

Eksempel

I disse eksempler tælles antallet af elementer i disse samlinger:

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

Og returner dette resultat: 4

less

Kontrollér, om den første værdi er mindre end den anden værdi. Returner true, når den første værdi er mindre, eller returner false, når den første værdi er mere.

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

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	Heltal, flydende eller streng	Den første værdi, der skal kontrolleres, om den er mindre end den anden værdi
<compareTo>	Ja	Henholdsvis Heltal, Flydende eller Streng	Sammenligningselementet

Returværdi	Skriv	Description
true eller false	Boolean	Returnerer true, når den første værdi er mindre end den anden værdi. Returnerer false, når den første værdi er lig med eller større end den anden værdi.

Eksempel

Disse eksempler kontrollerer, om den første værdi er mindre end den anden værdi.

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

Og returner disse resultater:

Første eksempel: true
Andet eksempel: false

lessOrEquals

Kontrollér, om den første værdi er mindre end eller lig med den anden værdi. Returnerer true, når den første værdi er mindre end eller lig med, eller returnerer false, når den første værdi er større.

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

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	Heltal, flydende eller streng	Den første værdi, der skal kontrolleres, om den er mindre end eller lig med den anden værdi
<compareTo>	Ja	Henholdsvis Heltal, Flydende eller Streng	Sammenligningselementet

Returværdi	Skriv	Description
true eller false	Boolean	Returnerer true, når den første værdi er mindre end eller lig med den anden værdi. Returnerer false, når den første værdi er større end den anden værdi.

Eksempel

Disse eksempler kontrollerer, om den første værdi er mindre eller lig med den anden værdi.

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

Og returner disse resultater:

Første eksempel: true
Andet eksempel: false

Maks

Returner den højeste værdi fra en liste eller matrix med tal, der er inklusive i begge ender.

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

Parameter	Obligatorisk	Type	Description
<number1>, <number2>, ...	Ja	Heltal, flydende eller begge dele	Det sæt tal, du vil have den højeste værdi fra
[<tal1>, <tal2>, ...]	Ja	Matrix – heltal, flydende eller begge dele	Matrixen af tal, som du vil have den højeste værdi fra

Returværdi	Skriv	Description
<maks. værdi>	Heltal eller flydende	Den højeste værdi i den angivne matrix eller det angivne talsæt

Eksempel

Disse eksempler henter den højeste værdi fra sættet af tal og matrixen:

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

Og returner dette resultat: 3

min.

Returner den laveste værdi fra et sæt tal eller en matrix.

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

Parameter	Obligatorisk	Type	Description
<number1>, <number2>, ...	Ja	Heltal, flydende eller begge dele	Det sæt tal, du vil have den laveste værdi fra
[<tal1>, <tal2>, ...]	Ja	Matrix – heltal, flydende eller begge dele	Matrixen af tal, som du vil have den laveste værdi fra

Returværdi	Skriv	Description
<min.-værdi>	Heltal eller flydende	Den laveste værdi i det angivne sæt tal eller den angivne matrix

Eksempel

Disse eksempler henter den laveste værdi i sættet af tal og matrixen:

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

Og returner dette resultat: 1

mod

Returnerer resten fra at dividere to tal. Hvis du vil hente heltalsresultatet, skal du se div().

mod(<dividend>, <divisor>)

Parameter	Obligatorisk	Type	Description
<Udbytte>	Ja	Heltal eller flydende	Det tal, der skal divideres med divisoren
<Divisor>	Ja	Heltal eller flydende	Det tal, der dividerer dividenden, men kan ikke være 0.

Returværdi	Skriv	Description
<modulo-resultat>	Heltal eller flydende	Resten fra at dividere det første tal med det andet tal

Eksempel

I dette eksempel divideres det første tal med det andet tal:

mod(3, 2)

Og returner dette resultat: 1

Mul

Returner produktet ved at multiplicere to tal.

mul(<multiplicand1>, <multiplicand2>)

Parameter	Obligatorisk	Type	Description
<multiplicand1>	Ja	Heltal eller flydende	Det tal, der skal multipliceres med multiplicand2
<multiplicand2>	Ja	Heltal eller flydende	Det tal, multiplicand1 multiplicand1

Returværdi	Skriv	Description
<produktresultat>	Heltal eller flydende	Produktet ved at multiplicere det første tal med det andet tal

Eksempel

Disse eksempler multiplumer det første tal med det andet tal:

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

Og returner disse resultater:

Første eksempel: 2
Andet eksempel 3

not

Kontrollér, om et udtryk er falsk. Returner true, når udtrykket er false, eller returner false, når true.

not(<expression>)

Parameter	Obligatorisk	Type	Description
<Udtryk>	Ja	Boolean	Det udtryk, der skal kontrolleres

Returværdi	Skriv	Description
true eller false	Boolean	Returner true, når udtrykket er falsk. Returnerer false, når udtrykket er true.

Eksempel 1

Disse eksempler kontrollerer, om de angivne udtryk er false:

not(false)
not(true)

Og returner disse resultater:

Første eksempel: Udtrykket er false, så funktionen returnerer true.
Andet eksempel: Udtrykket er true, så funktionen returnerer false.

Eksempel 2

Disse eksempler kontrollerer, om de angivne udtryk er false:

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

Og returner disse resultater:

Første eksempel: Udtrykket er false, så funktionen returnerer true.
Andet eksempel: Udtrykket er true, så funktionen returnerer false.

or

Kontrollér, om mindst ét udtryk er sandt. Returner true, når mindst ét udtryk er true, eller returner false, når begge er false.

or(<expression1>, <expression2>)

Parameter	Obligatorisk	Type	Description
<expression1>, <expression2>	Ja	Boolean	De udtryk, der skal kontrolleres

Returværdi	Skriv	Description
true eller false	Boolean	Returner true, når mindst ét udtryk er true. Returnerer false, når begge udtryk er false.

Eksempel 1

Disse eksempler kontrollerer, om mindst ét udtryk er sandt:

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

Og returner disse resultater:

Første eksempel: Mindst ét udtryk er true, så funktionen returnerer true.
Andet eksempel: Begge udtryk er false, så funktionen returnerer false.

Eksempel 2

Disse eksempler kontrollerer, om mindst ét udtryk er sandt:

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

Og returner disse resultater:

Første eksempel: Mindst ét udtryk er true, så funktionen returnerer true.
Andet eksempel: Begge udtryk er false, så funktionen returnerer false.

rand

Returnerer et tilfældigt heltal fra et angivet område, som kun er inkluderet i startafslutningen.

rand(<minValue>, <maxValue>)

Parameter	Obligatorisk	Type	Description
<minValue>	Ja	Heltal	Det laveste heltal i området
<maxValue>	Ja	Heltal	Det heltal, der følger efter det højeste heltal i det område, som funktionen kan returnere

Returværdi	Skriv	Description
<tilfældigt resultat>	Heltal	Det tilfældige heltal, der returneres fra det angivne område

Eksempel

I dette eksempel hentes et tilfældigt heltal fra det angivne område, bortset fra maksimumværdien:

rand(1, 5)

Og returnerer et af disse tal som resultat: 1, 2, 3eller 4

range

Returner en heltalsmatrix, der starter fra et angivet heltal.

range(<startIndex>, <count>)

Parameter	Obligatorisk	Type	Description
<startIndex>	Ja	Heltal	En heltalsværdi, der starter matrixen som det første element
<Tælle>	Ja	Heltal	Antallet af heltal i matrixen

Returværdi	Skriv	Description
[<range-result>]	Matrix	Matrixen med heltal, der starter fra det angivne indeks

Eksempel

I dette eksempel oprettes en heltalsmatrix, der starter fra det angivne indeks og har det angivne antal heltal:

range(1, 4)

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

replace

Erstat en understreng med den angivne streng, og returner resultatstrengen. Der er forskel på store og små bogstaver i denne funktion.

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

Parameter	Obligatorisk	Type	Beskrivelse
<Tekst>	Ja	String	Den streng, der har den understreng, der skal erstattes
<Gammeltekst>	Ja	String	Den understreng, der skal erstattes
<Nytekst>	Ja	String	Erstatningsstrengen

Returværdi	Skriv	Description
<opdateret tekst>	String	Den opdaterede streng efter erstatning af understrengen Hvis understrengen ikke findes, skal du returnere den oprindelige streng.

Eksempel

I dette eksempel findes understrengen "old" i "den gamle streng" og erstattes "old" med "new":

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

Og returnerer dette resultat: "the new string"

skip

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

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

Parameter	Obligatorisk	Type	Description
<Samling>	Ja	Matrix	Den samling, hvis elementer du vil fjerne
<Tælle>	Ja	Heltal	Et positivt heltal for det antal elementer, der skal fjernes forrest

Returværdi	Skriv	Description
[<updated-collection>]	Matrix	Den opdaterede samling efter fjernelse af de angivne elementer

Eksempel

I dette eksempel fjernes ét element, tallet 0, fra forsiden af den angivne matrix:

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

Og returnerer denne matrix med de resterende elementer: [1,2,3]

split

Returner en matrix, der indeholder understrenge adskilt af kommaer, baseret på det angivne afgrænsertegn i den oprindelige streng.

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

Parameter	Obligatorisk	Type	Beskrivelse
<Tekst>	Ja	String	Den streng, der skal adskilles i understrenge baseret på den angivne afgrænser i den oprindelige streng
<Afgrænser>	Ja	String	Det tegn i den oprindelige streng, der skal bruges som afgrænser

Returværdi	Skriv	Description
[<understreng1,understreng2><>,...]	Matrix	En matrix, der indeholder understrenge fra den oprindelige streng adskilt af kommaer

Eksempel

I dette eksempel oprettes en matrix med understrenge fra den angivne streng baseret på det angivne tegn som afgrænser:

split('a_b_c', '_')

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

startOfDay

Returner starten af dagen for et tidsstempel.

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<opdateret tidsstempel>	String	Det angivne tidsstempel, men starter ved nul-time-mærket for dagen

Eksempel

I dette eksempel finder vi starten på dagen for dette tidsstempel:

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

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

startOfHour

Returner timestart for et tidsstempel.

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<opdateret tidsstempel>	String	Det angivne tidsstempel, men starter ved nul-minut-mærket for timen

Eksempel

I dette eksempel finder vi starten af timen for dette tidsstempel:

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

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

startOfMonth

Returner starten af måneden for et tidsstempel.

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<opdateret tidsstempel>	String	Det angivne tidsstempel, men starter den første dag i måneden ved nul-time-mærket

Eksempel

I dette eksempel returneres starten af måneden for dette tidsstempel:

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

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

startsWith

Kontrollér, om en streng starter med en bestemt understreng. Returner true, når understrengen findes, eller returner false, når den ikke blev fundet. Der er ikke forskel på store og små bogstaver i denne funktion.

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

Parameter	Obligatorisk	Type	Beskrivelse
<Tekst>	Ja	String	Den streng, der skal kontrolleres
<Tekstdergennemsøges>	Ja	String	Startstrengen, der skal søges efter

Returværdi	Skriv	Description
true eller false	Boolean	Returner true, når startunderstrengen findes. Returner false, når den ikke blev fundet.

Eksempel 1

I dette eksempel kontrolleres det, om strengen "hello world" starter med understrengen "hello":

startsWith('hello world', 'hello')

Og returnerer dette resultat: true

Eksempel 2

I dette eksempel kontrolleres det, om strengen "hej verden" starter med understrengen "hilsener":

startsWith('hello world', 'greetings')

Og returnerer dette resultat: false

string

Returner strengversionen for en værdi.

string(<value>)

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	Any	Den værdi, der skal konverteres

Returværdi	Skriv	Description
<string-value>	String	Strengversionen for den angivne værdi

Eksempel 1

I dette eksempel oprettes strengversionen for dette tal:

string(10)

Og returnerer dette resultat: "10"

Eksempel 2

I dette eksempel oprettes en streng for det angivne JSON-objekt, og omvendt skråstreg (\) bruges som escape-tegn for dobbelt anførselstegn (").

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

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

sub

Returnerer resultatet fra at trække det andet tal fra det første tal.

sub(<minuend>, <subtrahend>)

Parameter	Obligatorisk	Type	Description
<minuend>	Ja	Heltal eller flydende	Det tal, som undertrahend skal trækkes fra
<subtrahend>	Ja	Heltal eller flydende	Det tal, der skal trækkes fra minuend

Returværdi	Skriv	Beskrivelse
<Resultat>	Heltal eller flydende	Resultatet af at trække det andet tal fra det første tal

Eksempel

I dette eksempel trækkes det andet tal fra det første tal:

sub(10.3, .3)

Og returnerer dette resultat: 10

Understreng

Returnerer tegn fra en streng med start fra den angivne placering eller det angivne indeks. Indeksværdier starter med tallet 0.

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

Parameter	Obligatorisk	Type	Beskrivelse
<Tekst>	Ja	String	Den streng, hvis tegn du vil bruge
<startIndex>	Ja	Heltal	Et positivt tal, der er lig med eller større end 0, som du vil bruge som startposition eller indeksværdi
<Længde>	Ja	Heltal	Et positivt antal tegn, du vil have i understrengen

Returværdi	Skriv	Description
<understrengsresultat>	String	En understreng med det angivne antal tegn, der starter ved den angivne indeksplacering i kildestrengen

Eksempel

I dette eksempel oprettes en understreng på fem tegn ud fra den angivne streng med start fra indeksværdien 6:

substring('hello world', 6, 5)

Og returnerer dette resultat: "world"

subtraherFromTime

Træk et antal tidsenheder fra et tidsstempel. Se også getPastTime.

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

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Den streng, der indeholder tidsstemplet
<interval>	Ja	Heltal	Det antal angivne tidsenheder, der skal trækkes fra
<timeUnit>	Ja	String	Den tidsenhed, der skal bruges med intervallet: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<opdateret tidsstempel>	String	Tidsstempel minus det angivne antal tidsenheder

Eksempel 1

I dette eksempel trækkes én dag fra dette tidsstempel:

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

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

Eksempel 2

I dette eksempel trækkes én dag fra dette tidsstempel:

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

Og returnerer dette resultat ved hjælp af det valgfri "D"-format: "Monday, January, 1, 2018"

take

Returner elementer fra forsiden af en samling.

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

Parameter	Obligatorisk	Type	Description
<Samling>	Ja	Streng eller matrix	Den samling, hvis elementer du vil have
<Tælle>	Ja	Heltal	Et positivt heltal for det antal elementer, du vil have fra forsiden

Returværdi	Skriv	Description
<undersæt> eller [<undersæt>]	Henholdsvis streng eller matrix	En streng eller matrix, der har det angivne antal elementer, der er taget fra forsiden af den oprindelige samling

Eksempel

Disse eksempler henter det angivne antal elementer fra forsiden af disse samlinger:

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

Og returner disse resultater:

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

Flåter

Returner egenskabsværdien ticks for et angivet tidsstempel. Et tik er et interval på 100 nanosekunder.

ticks('<timestamp>')

Parameter	Obligatorisk	Type	Description
<Tidsstempel>	Ja	String	Strengen for et tidsstempel

Returværdi	Skriv	Description
<ticks-number>	Heltal	Antallet af aksemærker, der er gået siden kl. 12:00:00 midnat, 1. januar 0001 i den gregorianske kalender siden inputtidsstempel

toLower

Returner en streng med små bogstaver. Hvis et tegn i strengen ikke har en version med små bogstaver, forbliver dette tegn uændret i den returnerede streng.

toLower('<text>')

Parameter	Obligatorisk	Type	Beskrivelse
<Tekst>	Ja	String	Den streng, der skal returneres med små bogstaver

Returværdi	Skriv	Description
<tekst med små bogstaver>	String	Den oprindelige streng med små bogstaver

Eksempel

I dette eksempel konverteres denne streng til små bogstaver:

toLower('Hello World')

Og returnerer dette resultat: "hello world"

toUpper

Returnerer en streng med store bogstaver. Hvis et tegn i strengen ikke har en version med store bogstaver, forbliver dette tegn uændret i den returnerede streng.

toUpper('<text>')

Parameter	Obligatorisk	Type	Beskrivelse
<Tekst>	Ja	String	Den streng, der skal returneres med store bogstaver

Returværdi	Skriv	Description
<store bogstaver>	String	Den oprindelige streng med store bogstaver

Eksempel

I dette eksempel konverteres denne streng til store bogstaver:

toUpper('Hello World')

Og returnerer dette resultat: "HELLO WORLD"

Trim

Fjern foranstillede og efterstillede mellemrum fra en streng, og returner den opdaterede streng.

trim('<text>')

Parameter	Obligatorisk	Type	Beskrivelse
<Tekst>	Ja	String	Den streng, der har det foranstillede og efterstillede mellemrum, der skal fjernes

Returværdi	Skriv	Description
<opdateret tekst>	String	En opdateret version af den oprindelige streng uden foranstillede eller efterstillede mellemrum

Eksempel

I dette eksempel fjernes det foranstillede og efterstillede mellemrum fra strengen " Hello World ":

trim(' Hello World  ')

Og returnerer dette resultat: "Hello World"

Unionen

Returner en samling, der indeholder alle elementerne fra de angivne samlinger. For at blive vist i resultatet kan et element vises i en hvilken som helst samling, der overføres til denne funktion. Hvis et eller flere elementer har det samme navn, vises det sidste element med dette navn i resultatet.

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

Parameter	Obligatorisk	Type	Description
<collection1>, <collection2>, ...	Ja	Matrix eller objekt, men ikke begge	De samlinger, hvorfra du vil have alle elementerne

Returværdi	Skriv	Description
<updatedCollection>	Matrix eller objekt, henholdsvis	En samling med alle elementerne fra de angivne samlinger – ingen dubletter

Eksempel

I dette eksempel hentes alle elementerne fra disse samlinger:

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

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

uri-komponent

Returner en URI-kodet version (Uniform Resource Identifier) for en streng ved at erstatte url-usikre tegn med escape-tegn. Brug denne funktion i stedet for encodeUriComponent(). Selvom begge funktioner fungerer på samme måde, uriComponent() foretrækkes.

uriComponent('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den streng, der skal konverteres til URI-kodet format

Returværdi	Skriv	Description
<encoded-uri>	String	Den URI-kodede streng med escape-tegn

Eksempel

I dette eksempel oprettes en URI-kodet version for denne streng:

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

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

uriComponentToBinary

Returner den binære version for en URI-komponent (Uniform Resource Identifier).

uriComponentToBinary('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den URI-kodede streng, der skal konverteres

Returværdi	Skriv	Description
<binary-for-encoded-uri>	String	Den binære version for den URI-kodede streng. Det binære indhold er base64-kodet og repræsenteret af `$content`.

Eksempel

I dette eksempel oprettes den binære version for denne URI-kodede streng:

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

Og returnerer dette resultat:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Returner strengversionen for en URI-kodet streng (Uniform Resource Identifier), der effektivt afkodede den URI-kodede streng.

uriComponentToString('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Den URI-kodede streng, der skal afkodes

Returværdi	Skriv	Description
<decoded-uri>	String	Den afkodede version for den URI-kodede streng

Eksempel

I dette eksempel oprettes den afkodede strengversion for denne URI-kodede streng:

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

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

utcNow

Returner det aktuelle tidsstempel.

utcNow('<format>')

Du kan også angive et andet format med formatparameteren<>.

Parameter	Obligatorisk	Type	Description
<Format>	Nej	String	Enten en enkelt formatangivelse eller et brugerdefineret formatmønster. Standardformatet for tidsstemplet er "o" (yyyy-MM-ddTHH:mm:ss.fffffffffK), som overholder ISO 8601 og bevarer tidszoneoplysninger.

Returværdi	Skriv	Description
<current-timestamp>	String	Den aktuelle dato og det aktuelle klokkeslæt

Eksempel 1

Lad os antage, at i dag er den 15. april 2018 kl. 13:00:00. Dette eksempel henter det aktuelle tidsstempel:

utcNow()

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

Eksempel 2

Lad os antage, at i dag er den 15. april 2018 kl. 13:00:00. I dette eksempel hentes det aktuelle tidsstempel ved hjælp af det valgfri "D"-format:

utcNow('D')

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

xml

Returner XML-versionen for en streng, der indeholder et JSON-objekt.

xml('<value>')

Parameter	Obligatorisk	Type	Description
<Værdi>	Ja	String	Strengen med det JSON-objekt, der skal konverteres JSON-objektet må kun have én rodegenskab, som ikke kan være en matrix. Brug omvendt skråstreg (\) som escape-tegn til dobbelt anførselstegn (").

Returværdi	Skriv	Description
<xml-version>	Object	Den kodede XML for den angivne streng eller det angivne JSON-objekt

Eksempel 1

I dette eksempel oprettes XML-versionen for denne streng, som indeholder et JSON-objekt:

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

Og returnerer dette resultat-XML:

<name>Sophia Owen</name>

Eksempel 2

Forestil dig, at du har dette JSON-objekt:

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

I dette eksempel oprettes XML for en streng, der indeholder dette JSON-objekt:

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

Og returnerer dette resultat-XML:

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

Xpath

Kontrollér XML for noder eller værdier, der svarer til et XPath-udtryk (XML Path Language), og returner de matchende noder eller værdier. Et XPath-udtryk eller blot "XPath" hjælper dig med at navigere i en XML-dokumentstruktur, så du kan vælge noder eller beregningsværdier i XML-indholdet.

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

Parameter	Obligatorisk	Type	Description
<Xml>	Ja	Any	Den XML-streng, der skal søge efter noder eller værdier, der svarer til en XPath-udtryksværdi
<Xpath>	Ja	Any	Det XPath-udtryk, der bruges til at finde matchende XML-noder eller -værdier

Returværdi	Skriv	Description
<xml-node>	XML	En XML-node, når kun en enkelt node svarer til det angivne XPath-udtryk
<Værdi>	Any	Værdien fra en XML-node, når kun en enkelt værdi svarer til det angivne XPath-udtryk
[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]	Matrix	En matrix med XML-noder eller værdier, der svarer til det angivne XPath-udtryk

Eksempel 1

I overensstemmelse med eksempel 1 finder dette eksempel noder, der svarer til noden <count></count> , og tilføjer disse nodeværdier med funktionen sum() :

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

Og returnerer dette resultat: 30

Eksempel 2

I dette eksempel finder begge udtryk noder, der svarer til noden <location></location> , i de angivne argumenter, som omfatter XML med et navneområde. Udtrykkene bruger omvendt skråstreg (\) som et escape-tegn for det dobbelte anførselstegn (").

Udtryk 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 argumenterne:

Denne XML-fil, som indeholder XML-dokumentnavneområdet: xmlns="http://contoso.com"

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

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

Her er den resultatnode, der svarer til noden <location></location> :

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

Eksempel 3

Efter eksempel 3 finder dette eksempel værdien i noden <location></location> :

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

Og returnerer dette resultat: "Paris"

Bemærk

Man kan føje kommentarer til dataflowudtryk, men ikke i pipelineudtryk.

Du kan finde oplysninger om generel parameteranvendelse under Parametre for Data Factory i Fabric

Share via

Udtryk og funktioner for Data Factory i Microsoft Fabric

Udtryk

Eksempler

Eksempel på komplekst udtryk

Dynamisk indholdseditor

Erstatning af specialtegn

Escaping enkelt anførselstegn

Variabler for pipelineomfang

Funktioner

Datofunktioner

Strengfunktioner

Indsamlingsfunktioner

Logiske funktioner

Konverteringsfunktioner

Matematiske funktioner

Funktionsreference

Tilføj

addDays

addHours

addMinutes

addSeconds

addToTime

og

matrix

base64

base64ToBinary

base64ToString

Binære

bool

Hånd

concat

indeholder

convertFromUtc

convertTimeZone

convertToUtc

createArray

dataUri

dataUriToBinary

dataUriToString

dayOfMonth

dayOfWeek

dayOfYear

decodeBase64

decodeDataUri

decodeUriComponent

Div

encodeUriComponent

tom

endsWith

equals

Første

flydende felter

formatDateTime

getFutureTime

getPastTime

greater

greaterOrEquals

Guid

if

indexOf

heltal

json

Skæringspunktet mellem

join

Sidste

lastIndexOf

length

less

lessOrEquals

Maks

min.

mod

Mul

not

or

rand

range

replace

skip