Uttryck och funktioner i Azure Data Factory och Azure Synapse Analytics

Artikel
05/17/2024

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Dricks

Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!

Den här artikeln innehåller information om uttryck och funktioner som stöds av Azure Data Factory och Azure Synapse Analytics.

Uttryck

JSON-värden i definitionen kan vara literala eller uttryck som utvärderas vid körning. Till exempel:

"name": "value"

eller

"name": "@pipeline().parameters.password"

Uttryck kan visas var som helst i ett JSON-strängvärde och alltid resultera i ett annat JSON-värde. Om ett JSON-värde är ett uttryck extraheras uttryckets brödtext genom att ta bort at-sign (@). Om en literalsträng behövs som börjar med @måste den vara undantagen med hjälp av @@. I följande exempel visas hur uttryck utvärderas.

JSON-värde	Result
"parametrar"	Tecknen "parameters" returneras.
"parameters[1]"	Tecknen "parameters[1]" returneras.
"@@"	En sträng med 1 tecken som innehåller @returneras.
" @"	En sträng med två tecken som innehåller @returneras.

Uttryck kan också visas inuti strängar med hjälp av en funktion som kallas stränginterpolation där uttryck omsluts i @{ ... }. Till exempel: "name" : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Med stränginterpolation är resultatet alltid en sträng. Säg att jag har definierat myNumber som 42 och myString som foo:

JSON-värde	Result
"@pipeline().parameters.myString"	Returnerar `foo` som en sträng.
"@{pipeline().parameters.myString}"	Returnerar `foo` som en sträng.
"@pipeline().parameters.myNumber"	Returnerar `42` som ett tal.
"@{pipeline().parameters.myNumber}"	Returnerar `42` som en sträng.
"Svaret är: @{pipeline().parameters.myNumber}"	Returnerar strängen `Answer is: 42`.
"@concat('Answer is: ', string(pipeline().parameters.myNumber))"	Returnerar strängen `Answer is: 42`
"Svaret är: @@{pipeline().parameters.myNumber}"	Returnerar strängen `Answer is: @{pipeline().parameters.myNumber}`.

I kontrollflödesaktiviteter som ForEach-aktivitet kan du ange en matris som ska itereras över för egenskapsobjekten och som används @item() för att iterera över en enda uppräkning i ForEach-aktiviteten. Om objekt till exempel är en matris: [1, 2, 3], @item() returnerar 1 i den första iterationen, 2 i den andra iterationen och 3 i den tredje iterationen. Du kan också använda @range(0,10) like-uttryck för att iterera tio gånger från och med 0 som slutar med 9.

Du kan använda @activity("aktivitetsnamn") för att samla in utdata från aktivitet och fatta beslut. Överväg en webbaktivitet som heter Web1. För att placera utdata från den första aktiviteten i brödtexten i den andra ser uttrycket vanligtvis ut som: @activity('Web1').output eller @activity('Web1').output.data eller något liknande beroende på hur utdata från den första aktiviteten ser ut.

Exempel

Exempel på komplext uttryck

Exemplet nedan visar ett komplext exempel som refererar till ett djupt underfält med aktivitetsutdata. Om du vill referera till en pipelineparameter som utvärderas till ett underfält använder du [] syntax i stället för dot(.) operator (som i fallet med underfält1 och underfält2) som en del av en aktivitetsutdata.

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

Det är vanligt att skapa filer dynamiskt och namnge dem. Låt oss utforska några exempel på dynamisk filnamngivning.

Lägg till datum i ett filnamn: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
Lägg till DateTime i kundens tidszon: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
Tilläggstid för utlösare: @concat('Test_', pipeline().TriggerTime)
Mata ut ett anpassat filnamn i ett mappningsdataflöde när du matar ut till en enda fil med datum : 'Test_' + toString(currentDate()) + '.csv'

I ovanstående fall skapas 4 dynamiska filnamn från och med Test_.

Redigerare för dynamiskt innehåll

Redigeraren för dynamiskt innehåll undflyr automatiskt tecken i ditt innehåll när du är klar med redigeringen. Följande innehåll i innehållsredigeraren är till exempel en stränginterpolation med två uttrycksfunktioner.

{ 
  "type": "@{if(equals(1, 2), 'Blob', 'Table' )}",
  "name": "@{toUpper('myData')}"
}

Redigeraren för dynamiskt innehåll konverterar innehållet till uttrycket "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}". Resultatet av det här uttrycket är en JSON-formatsträng som visas nedan.

{
  "type": "Table",
  "name": "MYDATA"
}

En datauppsättning med en parameter

I följande exempel tar BlobDataset en parameter med namnet path. Dess värde används för att ange ett värde för egenskapen folderPath med uttrycket : dataset().path.

{
    "name": "BlobDataset",
    "properties": {
        "type": "AzureBlob",
        "typeProperties": {
            "folderPath": "@dataset().path"
        },
        "linkedServiceName": {
            "referenceName": "AzureStorageLinkedService",
            "type": "LinkedServiceReference"
        },
        "parameters": {
            "path": {
                "type": "String"
            }
        }
    }
}

En pipeline med en parameter

I följande exempel tar pipelinen inputPath - och outputPath-parametrar . Sökvägen för den parametriserade blobdatauppsättningen anges med hjälp av värdena för dessa parametrar. Syntaxen som används här är: pipeline().parameters.parametername.

{
    "name": "Adfv2QuickStartPipeline",
    "properties": {
        "activities": [
            {
                "name": "CopyFromBlobToBlob",
                "type": "Copy",
                "inputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.inputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "outputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.outputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "typeProperties": {
                    "source": {
                        "type": "BlobSource"
                    },
                    "sink": {
                        "type": "BlobSink"
                    }
                }
            }
        ],
        "parameters": {
            "inputPath": {
                "type": "String"
            },
            "outputPath": {
                "type": "String"
            }
        }
    }
}

Ersätta specialtecken

Redigeraren för dynamiskt innehåll undflyr automatiskt tecken som dubbla citattecken, omvänt snedstreck i ditt innehåll när du är klar med redigeringen. Detta orsakar problem om du vill ersätta radmatning eller flik med hjälp av funktionen \n, \t i replace(). Du kan redigera ditt dynamiska innehåll i kodvyn för att ta bort det extra \ i uttrycket, eller så kan du följa stegen nedan för att ersätta specialtecken med uttrycksspråket:

URL-kodning mot det ursprungliga strängvärdet
Ersätt URL-kodad sträng, till exempel radmatning (%0A), vagnretur (%0D), vågrät flik(%09).
URL-avkodning

Variabeln companyName med ett nytt radtecken i värdet kan till @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) exempel ta bort det nya radtecknet.

Contoso-
Corporation

Undfly enkelt citattecken

Uttrycksfunktioner i pipelines använder det enkla citattecknet (') för att omge strängvärdeparametrar. Använd två på varandra följande enkla citattecken i ett pipelinestränguttryck för att inkludera ett enda citattecken. Här är ett exempel: uttrycket @concat('Here is a double quote character: ". ', 'And here is a single quote character all within the same string: ''.') returnerar följande resultat:

Here is a double quote character: ". And here is a single quote character all within the same string: '.

I dataflödesuttryck stöds dock inte den här syntaxen. I stället kan dataflödesuttryck omges av enkla eller dubbla citattecken. Omslut text som kräver enkla citattecken inom dubbla citattecken och text som kräver dubbla citattecken inom enkla citattecken, inom strängfunktioner. Om du behöver en sträng som innehåller både enkla och dubbla citattecken kan du använda concat() för att sammanfoga två delsträngar som var och en innehåller antingen enkla citattecken eller dubbla citattecken. Dataflödets motsvarighet till exemplet med föregående pipelineuttryck skulle vara concat('Here is a double quote character: ". ', "And here is a single quote character all within the same string: '."). I ett dataflöde returnerar uttrycket samma resultat som i föregående exempel för pipelineuttryck.

Självstudier

Den här självstudien beskriver hur du skickar parametrar mellan en pipeline och aktivitet samt mellan aktiviteterna. Självstudien visar specifikt steg för en Azure Data Factory, men stegen för en Synapse-arbetsyta är nästan likvärdiga men med ett något annorlunda användargränssnitt.

Funktioner

Du kan anropa funktioner i uttryck. Följande avsnitt innehåller information om de funktioner som kan användas i ett uttryck.

Datumfunktioner

Datum- eller tidsfunktion	Uppgift
addDays	Lägg till ett antal dagar i en tidsstämpel.
addHours	Lägg till ett antal timmar i en tidsstämpel.
addMinutes	Lägg till ett antal minuter i en tidsstämpel.
addSeconds	Lägg till ett antal sekunder i en tidsstämpel.
addToTime	Lägg till ett antal tidsenheter i en tidsstämpel. Se även getFutureTime.
convertFromUtc	Konvertera en tidsstämpel från Universal Time Coordinated (UTC) till måltidszonen.
convertTimeZone	Konvertera en tidsstämpel från källtidszonen till måltidszonen.
convertToUtc	Konvertera en tidsstämpel från källtidszonen till Universal Time Coordinated (UTC).
dayOfMonth	Returnera månadskomponenten från en tidsstämpel.
dayOfWeek	Returnera veckodag-komponenten från en tidsstämpel.
dayOfYear	Returnera årskomponentens dag från en tidsstämpel.
formatDateTime	Returnera tidsstämpeln som en sträng i valfritt format.
getFutureTime	Returnera den aktuella tidsstämpeln plus de angivna tidsenheterna. Se även addToTime.
getPastTime	Returnera den aktuella tidsstämpeln minus de angivna tidsenheterna. Se även subtractFromTime.
startOfDay	Returnera dagens start för en tidsstämpel.
startOfHour	Returnera timmens start för en tidsstämpel.
startOfMonth	Returnera början av månaden för en tidsstämpel.
subtractFromTime	Subtrahera ett antal tidsenheter från en tidsstämpel. Se även getPastTime.
Fästingar	Returnera egenskapsvärdet `ticks` för en angiven tidsstämpel.
utcNow	Returnera den aktuella tidsstämpeln som en sträng.

Strängfunktioner

Om du vill arbeta med strängar kan du använda dessa strängfunktioner och även vissa samlingsfunktioner. Strängfunktioner fungerar endast på strängar.

Strängfunktion	Uppgift
concat	Kombinera två eller flera strängar och returnera den kombinerade strängen.
endsWith	Kontrollera om en sträng slutar med den angivna delsträngen.
GUID	Generera en globalt unik identifierare (GUID) som en sträng.
indexOf	Returnera startpositionen för en delsträng.
lastIndexOf	Returnera startpositionen för den sista förekomsten av en delsträng.
ersätt	Ersätt en delsträng med den angivna strängen och returnera den uppdaterade strängen.
dela	Dela en sträng vid varje förekomst av en angiven avgränsare och returnera de resulterande delsträngarna som element i en matris.
startsWith	Kontrollera om en sträng börjar med en specifik delsträng.
Delsträng	Returnera tecken från en sträng med början från den angivna positionen.
toLower	Returnera en sträng i gemener.
toUpper	Returnera en sträng i versaler.
trimma	Ta bort inledande och avslutande blanksteg från en sträng och returnera den uppdaterade strängen.

Insamlingsfunktioner

Om du vill arbeta med samlingar, vanligtvis matriser, strängar och ibland ordlistor, kan du använda dessa samlingsfunktioner.

Samlingsfunktion	Uppgift
Innehåller	Kontrollera om en samling har ett specifikt objekt.
empty	Kontrollera om en samling är tom.
första	Returnera det första objektet från en samling.
vägkorsning	Returnera en samling som bara har de vanliga objekten i de angivna samlingarna.
join	Returnera en sträng som innehåller alla objekt från en matris, avgränsad med det angivna tecknet.
sist	Returnera det sista objektet från en samling.
length	Returnera antalet objekt i en sträng eller matris.
skippa	Ta bort objekt från framsidan av en samling och returnera alla andra objekt.
ta	Returnera objekt från framsidan av en samling.
union	Returnera en samling som innehåller alla objekt från de angivna samlingarna.

Logiska funktioner

Dessa funktioner är användbara inuti villkor, de kan användas för att utvärdera alla typer av logik.

Logisk jämförelsefunktion	Uppgift
and	Kontrollera om alla uttryck är sanna.
Motsvarar	Kontrollera om båda värdena är likvärdiga.
greater	Kontrollera om det första värdet är större än det andra värdet.
greaterOrEquals	Kontrollera om det första värdet är större än eller lika med det andra värdet.
om	Kontrollera om ett uttryck är sant eller falskt. Baserat på resultatet returnerar du ett angivet värde.
less	Kontrollera om det första värdet är mindre än det andra värdet.
lessOrEquals	Kontrollera om det första värdet är mindre än eller lika med det andra värdet.
inte	Kontrollera om ett uttryck är falskt.
or	Kontrollera om minst ett uttryck är sant.

Konverteringsfunktioner

Dessa funktioner används för att konvertera mellan var och en av de inbyggda typerna på språket:

sträng
integer
flyttal
boolean
Matriser
Ordböcker

Konverteringsfunktion	Uppgift
samling	Returnera en matris från en enda angiven indata. Flera indata finns i createArray.
base64	Returnera den base64-kodade versionen för en sträng.
base64ToBinary	Returnera den binära versionen för en base64-kodad sträng.
base64ToString	Returnera strängversionen för en base64-kodad sträng.
binär	Returnera den binära versionen för ett indatavärde.
Bool	Returnera den booleska versionen för ett indatavärde.
sammansmälta	Returnera det första värdet som inte är null från en eller flera parametrar.
createArray	Returnera en matris från flera indata.
dataUri	Returnera data-URI:n för ett indatavärde.
dataUriToBinary	Returnera den binära versionen för en data-URI.
dataUriToString	Returnera strängversionen för en data-URI.
avkodaBase64	Returnera strängversionen för en base64-kodad sträng.
decodeDataUri	Returnera den binära versionen för en data-URI.
decodeUriComponent	Returnera en sträng som ersätter escape-tecken med avkodade versioner.
encodeUriComponent	Returnera en sträng som ersätter URL-osäkra tecken med escape-tecken.
flyta	Returnera ett flyttalsnummer för ett indatavärde.
Int	Returnera heltalsversionen för en sträng.
json	Returnera JSON-typvärdet (JavaScript Object Notation) för en sträng eller XML.
sträng	Returnera strängversionen för ett indatavärde.
uriComponent	Returnera den URI-kodade versionen för ett indatavärde genom att ersätta URL-osäkra tecken med escape-tecken.
uriComponentToBinary	Returnera den binära versionen för en URI-kodad sträng.
uriComponentToString	Returnera strängversionen för en URI-kodad sträng.
xml	Returnera XML-versionen för en sträng.
xpath	Kontrollera XML för noder eller värden som matchar ett XPath-uttryck (XML Path Language) och returnera matchande noder eller värden.

Matematikfunktioner

Dessa funktioner kan användas för båda typerna av tal: heltal och flyttal.

Matematisk funktion	Uppgift
addera	Returnera resultatet från att lägga till två tal.
div	Returnera resultatet från att dividera ett tal med ett annat tal.
max	Returnera det högsta värdet från en uppsättning tal eller en matris.
min	Returnera det lägsta värdet från en uppsättning tal eller en matris.
mods	Returnera resten från att dividera ett tal med ett annat tal.
mul	Returnera produkten från att multiplicera två tal.
Rand	Returnera ett slumpmässigt heltal från ett angivet intervall.
intervall	Returnera en heltalsmatris som startar från ett angivet heltal.
under	Returnera resultatet från att subtrahera ett tal från ett annat tal.

Funktionsreferens

I det här avsnittet visas alla tillgängliga funktioner i alfabetisk ordning.

add

Returnera resultatet från att lägga till två tal.

add(<summand_1>, <summand_2>)

Parameter	Obligatoriskt	Type	Beskrivning
<>summand_1, <summand_2>	Ja	Heltal, flyttal eller blandat	De tal som ska läggas till

Returvärde	Typ	Beskrivning
<result-sum>	Heltal eller flyttal	Resultatet av att lägga till de angivna talen

Exempel

Det här exemplet lägger till de angivna talen:

add(1, 1.5)

Och returnerar det här resultatet: 2.5

addDays

Lägg till ett antal dagar i en tidsstämpel.

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<Dagar>	Ja	Integer	Det positiva eller negativa antalet dagar som ska läggas till
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Tidsstämpeln plus det angivna antalet dagar

Exempel 1

Det här exemplet lägger till 10 dagar till den angivna tidsstämpeln:

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

Och returnerar det här resultatet: "2018-03-25T00:00:0000000Z"

Exempel 2

Det här exemplet subtraherar fem dagar från den angivna tidsstämpeln:

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

Och returnerar det här resultatet: "2018-03-10T00:00:0000000Z"

addHours

Lägg till ett antal timmar i en tidsstämpel.

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<hours>	Ja	Integer	Det positiva eller negativa antalet timmar som ska läggas till
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Tidsstämpeln plus det angivna antalet timmar

Exempel 1

Det här exemplet lägger till 10 timmar till den angivna tidsstämpeln:

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

Och returnerar det här resultatet: "2018-03-15T10:00:0000000Z"

Exempel 2

Det här exemplet subtraherar fem timmar från den angivna tidsstämpeln:

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

Och returnerar det här resultatet: "2018-03-15T10:00:0000000Z"

addMinutes

Lägg till ett antal minuter i en tidsstämpel.

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<minutes>	Ja	Integer	Det positiva eller negativa antalet minuter som ska läggas till
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Tidsstämpeln plus det angivna antalet minuter

Exempel 1

Det här exemplet lägger till 10 minuter till den angivna tidsstämpeln:

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

Och returnerar det här resultatet: "2018-03-15T00:20:00.0000000Z"

Exempel 2

Det här exemplet subtraherar fem minuter från den angivna tidsstämpeln:

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

Och returnerar det här resultatet: "2018-03-15T00:15:00.0000000Z"

addSeconds

Lägg till ett antal sekunder i en tidsstämpel.

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<Sekunder>	Ja	Integer	Det positiva eller negativa antalet sekunder som ska läggas till
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Tidsstämpeln plus det angivna antalet sekunder

Exempel 1

Det här exemplet lägger till 10 sekunder till den angivna tidsstämpeln:

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

Och returnerar det här resultatet: "2018-03-15T00:00:10.0000000Z"

Exempel 2

Det här exemplet subtraherar fem sekunder till den angivna tidsstämpeln:

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

Och returnerar det här resultatet: "2018-03-15T00:00:25.0000000Z"

addToTime

Lägg till ett antal tidsenheter i en tidsstämpel. Se även getFutureTime().

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<interval>	Ja	Integer	Antalet angivna tidsenheter som ska läggas till
<timeUnit>	Ja	String	Den tidsenhet som ska användas med intervall: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Tidsstämpeln plus det angivna antalet tidsenheter

Exempel 1

Det här exemplet lägger till en dag i den angivna tidsstämpeln:

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

Och returnerar det här resultatet: "2018-01-02T00:00:00.0000000Z"

Exempel 2

Det här exemplet lägger till en dag i den angivna tidsstämpeln:

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

Och returnerar resultatet med det valfria D-formatet: "Tuesday, January 2, 2018"

och

Kontrollera om båda uttrycken är sanna. Returnera sant när båda uttrycken är sanna eller returnerar false när minst ett uttryck är falskt.

and(<expression1>, <expression2>)

Parameter	Obligatoriskt	Type	Beskrivning
<expression1>, <expression2>	Ja	Booleskt	De uttryck som ska kontrolleras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när båda uttrycken är sanna. Returnera false när minst ett uttryck är falskt.

Exempel 1

De här exemplen kontrollerar om de angivna booleska värdena båda är sanna:

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

Och returnerar följande resultat:

Första exemplet: Båda uttrycken är sanna, så returnerar true.
Andra exemplet: Ett uttryck är falskt, så returnerar false.
Tredje exemplet: Båda uttrycken är falska, så returnerar false.

Exempel 2

De här exemplen kontrollerar om de angivna uttrycken båda är sanna:

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

Och returnerar följande resultat:

Första exemplet: Båda uttrycken är sanna, så returnerar true.
Andra exemplet: Ett uttryck är falskt, så returnerar false.
Tredje exemplet: Båda uttrycken är falska, så returnerar false.

matris

Returnera en matris från en enda angiven indata. Flera indata finns i createArray().

array('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen för att skapa en matris

Returvärde	Typ	Beskrivning
[<värde>]	Matris	En matris som innehåller den enda angivna indatan

Exempel

I det här exemplet skapas en matris från "hello"-strängen:

array('hello')

Och returnerar det här resultatet: ["hello"]

base64

Returnera den base64-kodade versionen för en sträng.

base64('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Indatasträngen

Returvärde	Typ	Beskrivning
<base64-string>	String	Den base64-kodade versionen för indatasträngen

Exempel

I det här exemplet konverteras "hello"-strängen till en base64-kodad sträng:

base64('hello')

Och returnerar det här resultatet: "aGVsbG8="

base64ToBinary

Returnera den binära versionen för en base64-kodad sträng.

base64ToBinary('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Den base64-kodade sträng som ska konverteras

Returvärde	Typ	Beskrivning
<binary-for-base64-string>	String	Binärversionen för den base64-kodade strängen

Exempel

Det här exemplet konverterar "aGVsbG8=" base64-kodad sträng till en binär sträng:

base64ToBinary('aGVsbG8=')

Och returnerar det här resultatet:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Returnera strängversionen för en base64-kodad sträng, vilket effektivt avkodar base64-strängen. Använd den här funktionen i stället för att avkodaBase64(). Även om båda funktionerna fungerar på samma sätt base64ToString() är det att föredra.

base64ToString('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Den base64-kodade strängen som ska avkodas

Returvärde	Typ	Beskrivning
<decoded-base64-string>	String	Strängversionen för en base64-kodad sträng

Exempel

I det här exemplet konverteras "aGVsbG8=" base64-kodad sträng till bara en sträng:

base64ToString('aGVsbG8=')

Och returnerar det här resultatet: "hello"

binary

Returnera den binära versionen för en sträng.

binary('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen som ska konverteras

Returvärde	Typ	Beskrivning
<binary-for-input-value>	String	Binärversionen för den angivna strängen

Exempel

I det här exemplet konverteras "hello"-strängen till en binär sträng:

binary('hello')

Och returnerar det här resultatet:

"0110100001100101011011000110110001101111"

bool

Returnera den booleska versionen för ett värde.

bool(<value>)

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Alla	Värdet som ska konverteras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Den booleska versionen för det angivna värdet

Exempel

I de här exemplen konverteras de angivna värdena till booleska värden:

bool(1)
bool(0)

Och returnerar följande resultat:

Första exemplet: true
Andra exemplet: false

sammansmälta

Returnera det första värdet som inte är null från en eller flera parametrar. Tomma strängar, tomma matriser och tomma objekt är inte null.

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

Parameter	Obligatoriskt	Type	Beskrivning
<>object_1, <object_2>, ...	Ja	Valfritt, kan blanda typer	Ett eller flera objekt att söka efter null

Returvärde	Typ	Beskrivning
<first-non-null-item>	Alla	Det första objektet eller värdet som inte är null. Om alla parametrar är null returnerar den här funktionen null.

Exempel

De här exemplen returnerar det första värdet som inte är null från de angivna värdena eller null när alla värden är null:

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

Och returnerar följande resultat:

Första exemplet: true
Andra exemplet: "hello"
Tredje exemplet: null

concat

Kombinera två eller flera strängar och returnera den kombinerade strängen.

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

Parameter	Obligatoriskt	Type	Beskrivning
<text1>, <text2>, ...	Ja	String	Minst två strängar att kombinera

Returvärde	Typ	Beskrivning
<text1text2...>	String	Strängen som skapats från de kombinerade indatasträngarna

Exempel

I det här exemplet kombineras strängarna "Hello" och "World":

concat('Hello', 'World')

Och returnerar det här resultatet: "HelloWorld"

innehåller

Kontrollera om en samling har ett specifikt objekt. Returnera sant när objektet hittas eller returnera falskt när det inte hittas. Den här funktionen är skiftlägeskänslig.

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

Mer specifikt fungerar den här funktionen på följande samlingstyper:

En sträng för att hitta en delsträng
En matris för att hitta ett värde
En ordlista för att hitta en nyckel

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng, matris eller ordlista	Samlingen som ska kontrolleras
<värde>	Ja	Sträng, matris eller ordlista	Objektet som ska hittas

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när objektet hittas. Returnera falskt när det inte hittas.

Exempel 1

I det här exemplet kontrolleras strängen "hello world" för delsträngen "world" och returnerar true:

contains('hello world', 'world')

Exempel 2

I det här exemplet kontrolleras strängen "hello world" för understrängen "universe" och returnerar false:

contains('hello world', 'universe')

convertFromUtc

Konvertera en tidsstämpel från Universal Time Coordinated (UTC) till måltidszonen.

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<destinationTimeZone>	Ja	String	Namnet på måltidszonen. Information om tidszonsnamn finns i Microsofts tidszonsvärden, men du kan behöva ta bort eventuella skiljetecken från tidszonsnamnet.
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<konverterad tidsstämpel>	String	Tidsstämpeln konverterad till måltidszonen

Exempel 1

I det här exemplet konverteras en tidsstämpel till den angivna tidszonen:

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

Och returnerar det här resultatet: "2018-01-01T00:00:00Z"

Exempel 2

I det här exemplet konverteras en tidsstämpel till den angivna tidszonen och formatet:

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

Och returnerar det här resultatet: "Monday, January 1, 2018"

convertTimeZone

Konvertera en tidsstämpel från källtidszonen till måltidszonen.

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<sourceTimeZone>	Ja	String	Namnet på källtidszonen. Information om tidszonsnamn finns i Microsofts tidszonsvärden, men du kan behöva ta bort eventuella skiljetecken från tidszonsnamnet.
<destinationTimeZone>	Ja	String	Namnet på måltidszonen. Information om tidszonsnamn finns i Microsofts tidszonsvärden, men du kan behöva ta bort eventuella skiljetecken från tidszonsnamnet.
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<konverterad tidsstämpel>	String	Tidsstämpeln konverterad till måltidszonen

Exempel 1

I det här exemplet konverteras källtidszonen till måltidszonen:

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

Och returnerar det här resultatet: "2018-01-01T00:00:00.0000000"

Exempel 2

I det här exemplet konverteras en tidszon till den angivna tidszonen och formatet:

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

Och returnerar det här resultatet: "Monday, January 1, 2018"

convertToUtc

Konvertera en tidsstämpel från källtidszonen till Universal Time Coordinated (UTC).

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<sourceTimeZone>	Ja	String	Namnet på källtidszonen. Information om tidszonsnamn finns i Microsofts tidszonsvärden, men du kan behöva ta bort eventuella skiljetecken från tidszonsnamnet.
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<konverterad tidsstämpel>	String	Tidsstämpeln konverterad till UTC

Exempel 1

I det här exemplet konverteras en tidsstämpel till UTC:

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

Och returnerar det här resultatet: "2018-01-01T08:00:00.0000000Z"

Exempel 2

I det här exemplet konverteras en tidsstämpel till UTC:

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

Och returnerar det här resultatet: "Monday, January 1, 2018"

createArray

Returnera en matris från flera indata. För enskilda indatamatriser, se matris().

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

Parameter	Obligatoriskt	Type	Beskrivning
<object1>, <object2>, ...	Ja	Alla, men inte blandade	Minst två objekt för att skapa matrisen

Returvärde	Typ	Beskrivning
[<object1>, <object2>, ...]	Matris	Matrisen som skapats från alla indataobjekt

Exempel

I det här exemplet skapas en matris från dessa indata:

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

Och returnerar det här resultatet: ["h", "e", "l", "l", "o"]

dataUri

Returnera en datauniform resursidentifierare (URI) för en sträng.

dataUri('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen som ska konverteras

Returvärde	Typ	Beskrivning
<data-uri>	String	Data-URI för indatasträngen

Exempel

I det här exemplet skapas en data-URI för "hello"-strängen:

dataUri('hello')

Och returnerar det här resultatet: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Returnera den binära versionen för en datauniform resursidentifierare (URI). Använd den här funktionen i stället för att avkodaDataUri(). Även om båda funktionerna fungerar på samma sätt dataUriBinary() är det att föredra.

dataUriToBinary('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Data-URI:n som ska konverteras

Returvärde	Typ	Beskrivning
<binary-for-data-uri>	String	Den binära versionen för data-URI:n

Exempel

Det här exemplet skapar en binär version för den här data-URI:n:

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

Och returnerar det här resultatet:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Returnera strängversionen för en URI (Data Uniform Resource Identifier).

dataUriToString('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Data-URI:n som ska konverteras

Returvärde	Typ	Beskrivning
<string-for-data-uri>	String	Strängversionen för data-URI:n

Exempel

I det här exemplet skapas en sträng för den här data-URI:n:

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

Och returnerar det här resultatet: "hello"

dayOfMonth

Returnera dagen i månaden från en tidsstämpel.

dayOfMonth('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln

Returvärde	Typ	Beskrivning
<dag i månaden>	Integer	Dagen i månaden från den angivna tidsstämpeln

Exempel

Det här exemplet returnerar talet för dagen i månaden från den här tidsstämpeln:

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

Och returnerar det här resultatet: 15

dayOfWeek

Returnera veckodagen från en tidsstämpel.

dayOfWeek('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln

Returvärde	Typ	Beskrivning
<veckodag>	Integer	Veckodagen från den angivna tidsstämpeln där söndag är 0, måndag är 1 och så vidare

Exempel

Det här exemplet returnerar numret för veckodagen från den här tidsstämpeln:

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

Och returnerar det här resultatet: 3

dayOfYear

Returnera dagen på året från en tidsstämpel.

dayOfYear('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln

Returvärde	Typ	Beskrivning
<dag på året>	Integer	Dagen på året från den angivna tidsstämpeln

Exempel

Det här exemplet returnerar antalet dagar på året från den här tidsstämpeln:

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

Och returnerar det här resultatet: 74

avkodaBase64

Returnera strängversionen för en base64-kodad sträng, vilket effektivt avkodar base64-strängen. Överväg att använda base64ToString() i stället för decodeBase64(). Även om båda funktionerna fungerar på samma sätt base64ToString() är det att föredra.

decodeBase64('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Den base64-kodade strängen som ska avkodas

Returvärde	Typ	Beskrivning
<decoded-base64-string>	String	Strängversionen för en base64-kodad sträng

Exempel

I det här exemplet skapas en sträng för en base64-kodad sträng:

decodeBase64('aGVsbG8=')

Och returnerar det här resultatet: "hello"

decodeDataUri

Returnera den binära versionen för en datauniform resursidentifierare (URI). Överväg att använda dataUriToBinary(), i stället decodeDataUri()för . Även om båda funktionerna fungerar på samma sätt dataUriToBinary() är det att föredra.

decodeDataUri('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Data-URI-strängen som ska avkodas

Returvärde	Typ	Beskrivning
<binary-for-data-uri>	String	Binär version för en data-URI-sträng

Exempel

Det här exemplet returnerar binärversionen för den här data-URI:n:

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

Och returnerar det här resultatet:

decodeUriComponent

Returnera en sträng som ersätter escape-tecken med avkodade versioner.

decodeUriComponent('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen med escape-tecknen som ska avkodas

Returvärde	Typ	Beskrivning
<decoded-uri>	String	Den uppdaterade strängen med de avkodade escape-tecknen

Exempel

Det här exemplet ersätter escape-tecknen i den här strängen med avkodade versioner:

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

Och returnerar det här resultatet: "https://contoso.com"

div

Returnera resultatet av att dividera ett tal med ett annat tal.

div(<dividend>, <divisor>)

Den exakta returtypen för funktionen beror på vilka typer av parametrar den har – se exempel för detaljer.

Parameter	Obligatoriskt	Type	Beskrivning
<utdelning>	Ja	Heltal eller flyttal	Talet som ska divideras med divisorn
<divisor>	Ja	Heltal eller flyttal	Talet som delar utdelningen. Ett divisorvärde på noll orsakar ett fel vid körning.

Returvärde	Typ	Beskrivning
<kvotresultat>	Heltal eller flyttal	Resultatet av att dividera det första talet med det andra talet

Exempel 1

I de här exemplen delas talet 9 med 2:

div(9, 2.0)
div(9.0, 2)
div(9.0, 2.0)

Och alla returnerar det här resultatet: 4.5

Exempel 2

I det här exemplet delas även talet 9 med 2, men eftersom båda parametrarna är heltal ignoreras resten (heltalsdivision):

div(9, 2)

Uttrycket returnerar resultatet 4. Använd funktionen mod() för att hämta restens värde.

encodeUriComponent

Returnera en URI-kodad version (uniform resource identifier) för en sträng genom att ersätta URL-osäkra tecken med escape-tecken. Överväg att använda uriComponent(), i stället encodeUriComponent()för . Även om båda funktionerna fungerar på samma sätt uriComponent() är det att föredra.

encodeUriComponent('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen som ska konverteras till URI-kodat format

Returvärde	Typ	Beskrivning
<encoded-uri>	String	Den URI-kodade strängen med escape-tecken

Exempel

Det här exemplet skapar en URI-kodad version för den här strängen:

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

Och returnerar det här resultatet: "http%3A%2F%2Fcontoso.com"

empty

Kontrollera om en samling är tom. Returnera sant när samlingen är tom eller returnera falskt när den inte är tom.

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

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng, matris eller objekt	Samlingen som ska kontrolleras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när samlingen är tom. Returnera falskt när det inte är tomt.

Exempel

De här exemplen kontrollerar om de angivna samlingarna är tomma:

empty('')
empty('abc')

Och returnerar följande resultat:

Första exemplet: Skickar en tom sträng, så funktionen returnerar true.
Andra exemplet: Skickar strängen "abc", så funktionen returnerar false.

endsWith

Kontrollera om en sträng slutar med en specifik delsträng. Returnera sant när delsträngen hittas eller returnera falskt när den inte hittas. Den här funktionen är inte skiftlägeskänslig.

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

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som ska kontrolleras
<searchText>	Ja	String	Den avslutande delsträngen som ska hittas

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när den avslutande delsträngen hittas. Returnera falskt när det inte hittas.

Exempel 1

Det här exemplet kontrollerar om "hello world"-strängen slutar med "world"-strängen:

endsWith('hello world', 'world')

Och returnerar det här resultatet: true

Exempel 2

Det här exemplet kontrollerar om "hello world"-strängen slutar med "universum"-strängen:

endsWith('hello world', 'universe')

Och returnerar det här resultatet: false

equals

Kontrollera om båda värdena, uttrycken eller objekten är likvärdiga. Returnera sant när båda är likvärdiga eller returnerar false när de inte är likvärdiga.

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

Parameter	Obligatoriskt	Type	Beskrivning
<object1>, <object2>	Ja	Olika	De värden, uttryck eller objekt som ska jämföras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när båda är likvärdiga. Returnera falskt när det inte är likvärdigt.

Exempel

De här exemplen kontrollerar om de angivna indata är likvärdiga.

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

Och returnerar följande resultat:

Första exemplet: Båda värdena är likvärdiga, så funktionen returnerar true.
Andra exemplet: Båda värdena är inte likvärdiga, så funktionen returnerar false.

Första

Returnera det första objektet från en sträng eller matris.

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

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng eller matris	Samlingen där du hittar det första objektet

Returvärde	Typ	Beskrivning
<first-collection-item>	Alla	Det första objektet i samlingen

Exempel

De här exemplen hittar det första objektet i dessa samlingar:

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

Och returnera dessa resultat:

Första exemplet: "h"
Andra exemplet: 0

flyttal

Konvertera en strängversion för ett flyttalsnummer till ett verkligt flyttalsnummer.

float('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen som har ett giltigt flyttalsnummer att konvertera

Returvärde	Typ	Beskrivning
<float-value>	Flyttal	Flyttalsnumret för den angivna strängen

Exempel

I det här exemplet skapas en strängversion för det här flyttalsnumret:

float('10.333')

Och returnerar det här resultatet: 10.333

formatDateTime

Returnera en tidsstämpel i det angivna formatet.

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<formaterad tidsstämpel>	String	Den uppdaterade tidsstämpeln i det angivna formatet

Exempel

I det här exemplet konverteras en tidsstämpel till det angivna formatet:

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

Och returnerar det här resultatet: "2018-03-15T12:00:00"

getFutureTime

Returnera den aktuella tidsstämpeln plus de angivna tidsenheterna.

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

Parameter	Obligatoriskt	Type	Beskrivning
<interval>	Ja	Integer	Antalet angivna tidsenheter som ska läggas till
<timeUnit>	Ja	String	Den tidsenhet som ska användas med intervall: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Den aktuella tidsstämpeln plus det angivna antalet tidsenheter

Exempel 1

Anta att den aktuella tidsstämpeln är "2018-03-01T00:00:00.000000Z". Det här exemplet lägger till fem dagar till den tidsstämpeln:

getFutureTime(5, 'Day')

Och returnerar det här resultatet: "2018-03-06T00:00:00.0000000Z"

Exempel 2

Anta att den aktuella tidsstämpeln är "2018-03-01T00:00:00.000000Z". Det här exemplet lägger till fem dagar och konverterar resultatet till "D"-format:

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

Och returnerar det här resultatet: "Tuesday, March 6, 2018"

getPastTime

Returnera den aktuella tidsstämpeln minus de angivna tidsenheterna.

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

Parameter	Obligatoriskt	Type	Beskrivning
<interval>	Ja	Integer	Antalet angivna tidsenheter som ska subtraheras
<timeUnit>	Ja	String	Den tidsenhet som ska användas med intervall: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Den aktuella tidsstämpeln minus det angivna antalet tidsenheter

Exempel 1

Anta att den aktuella tidsstämpeln är "2018-02-01T00:00:00.0000000Z". Det här exemplet subtraherar fem dagar från den tidsstämpeln:

getPastTime(5, 'Day')

Och returnerar det här resultatet: "2018-01-27T00:00:00.0000000Z"

Exempel 2

Anta att den aktuella tidsstämpeln är "2018-02-01T00:00:00.0000000Z". Det här exemplet subtraherar fem dagar och konverterar resultatet till formatet "D":

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

Och returnerar det här resultatet: "Saturday, January 27, 2018"

greater

Kontrollera om det första värdet är större än det andra värdet. Returnera sant när det första värdet är mer eller returnera falskt när det är mindre.

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

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Heltal, flyttal eller sträng	Det första värdet för att kontrollera om större än det andra värdet
<compareTo>	Ja	Heltal, flyttal respektive sträng	Jämförelsevärdet

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när det första värdet är större än det andra värdet. Returnera false när det första värdet är lika med eller mindre än det andra värdet.

Exempel

De här exemplen kontrollerar om det första värdet är större än det andra värdet:

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

Och returnera dessa resultat:

Första exemplet: true
Andra exemplet: false

greaterOrEquals

Kontrollera om det första värdet är större än eller lika med det andra värdet. Returnera sant när det första värdet är större eller lika med eller returnerar falskt när det första värdet är mindre.

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

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Heltal, flyttal eller sträng	Det första värdet för att kontrollera om det är större än eller lika med det andra värdet
<compareTo>	Ja	Heltal, flyttal respektive sträng	Jämförelsevärdet

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när det första värdet är större än eller lika med det andra värdet. Returnera false när det första värdet är mindre än det andra värdet.

Exempel

De här exemplen kontrollerar om det första värdet är större eller lika med det andra värdet:

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

Och returnera dessa resultat:

Första exemplet: true
Andra exemplet: false

guid

Generera en globalt unik identifierare (GUID) som en sträng, till exempel "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Du kan också ange ett annat format för GUID än standardformatet "D", som är 32 siffror avgränsade med bindestreck.

guid('<format>')

Parameter	Obligatoriskt	Type	Beskrivning
<format>	Nej	String	En enskild formatspecificerare för det returnerade GUID:t. Som standard är formatet "D", men du kan använda "N", "D", "B", "P" eller "X".

Returvärde	Typ	Beskrivning
<GUID-värde>	String	Ett slumpmässigt genererat GUID

Exempel

Det här exemplet genererar samma GUID, men som 32 siffror avgränsade med bindestreck och omges av parenteser:

guid('P')

Och returnerar det här resultatet: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

Kontrollera om ett uttryck är sant eller falskt. Baserat på resultatet returnerar du ett angivet värde.

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

Parameter	Obligatoriskt	Type	Beskrivning
<uttryck>	Ja	Booleskt	Uttrycket som ska kontrolleras
<valueIfTrue>	Ja	Alla	Värdet som ska returneras när uttrycket är sant
<valueIfFalse>	Ja	Alla	Värdet som ska returneras när uttrycket är falskt

Returvärde	Typ	Beskrivning
<specified-return-value>	Alla	Det angivna värdet som returneras baserat på om uttrycket är sant eller falskt

Exempel

Det här exemplet returnerar "yes" eftersom det angivna uttrycket returnerar true. Annars returnerar "no"exemplet :

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

indexOf

Returnera startpositionen eller indexvärdet för en delsträng. Den här funktionen är inte skiftlägeskänslig och index börjar med talet 0.

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

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som har delsträngen att hitta
<searchText>	Ja	String	Delsträngen som ska hittas

Returvärde	Typ	Beskrivning
<indexvärde>	Integer	Startpositionen eller indexvärdet för den angivna delsträngen. Om strängen inte hittas returnerar du talet -1.

Exempel

Det här exemplet hittar startindexvärdet för understrängen "world" i strängen "hello world":

indexOf('hello world', 'world')

Och returnerar det här resultatet: 6

heltal

Returnera heltalsversionen för en sträng.

int('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen som ska konverteras

Returvärde	Typ	Beskrivning
<integer-result>	Integer	Heltalsversionen för den angivna strängen

Exempel

Det här exemplet skapar en heltalsversion för strängen "10":

int('10')

Och returnerar det här resultatet: 10

json

Returnera JSON-typvärdet (JavaScript Object Notation) för en sträng eller XML.

json('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Sträng eller XML	Strängen eller XML som ska konverteras

Returvärde	Typ	Beskrivning
<JSON-resultat>	Inbyggd JSON-typ eller -objekt	Det interna JSON-typvärdet eller -objektet för den angivna strängen eller XML-koden. Om strängen är null returnerar funktionen ett tomt objekt.

Exempel 1

I det här exemplet konverteras strängen till JSON-värdet:

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

Och returnerar det här resultatet: [1, 2, 3]

Exempel 2

I det här exemplet konverteras strängen till JSON:

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

Och returnerar det här resultatet:

{
  "fullName": "Sophia Owen"
}

Exempel 3

I det här exemplet konverteras den här XML:en till JSON:

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

Och returnerar det här resultatet:

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

vägkorsning

Returnera en samling som bara har de vanliga objekten i de angivna samlingarna. För att visas i resultatet måste ett objekt visas i alla samlingar som skickas till den här funktionen. Om ett eller flera objekt har samma namn visas det sista objektet med det namnet i resultatet.

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

Parameter	Obligatoriskt	Type	Beskrivning
<collection1>, <collection2>, ...	Ja	Matris eller objekt, men inte båda	Samlingarna där du bara vill ha de vanliga objekten

Returvärde	Typ	Beskrivning
<common-items>	Matris eller objekt, respektive	En samling som bara har de vanliga objekten i de angivna samlingarna

Exempel

Det här exemplet hittar de vanliga objekten i dessa matriser:

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

Och returnerar en matris med endast följande objekt: [1, 2]

anslut

Returnera en sträng som innehåller alla objekt från en matris och där varje tecken avgränsas med en avgränsare.

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

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Matris	Matrisen som har de objekt som ska kopplas
<avgränsare>	Ja	String	Avgränsaren som visas mellan varje tecken i den resulterande strängen

Returvärde	Typ	Beskrivning
<char1><avgränsare><char2><avgränsare...>	String	Den resulterande strängen som skapats från alla objekt i den angivna matrisen

Exempel

I det här exemplet skapas en sträng från alla objekt i den här matrisen med det angivna tecknet som avgränsare:

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

Och returnerar det här resultatet: "a.b.c"

senaste

Returnera det sista objektet från en samling.

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

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng eller matris	Samlingen där du hittar det sista objektet

Returvärde	Typ	Beskrivning
<last-collection-item>	Sträng eller matris, respektive	Det sista objektet i samlingen

Exempel

De här exemplen hittar det sista objektet i dessa samlingar:

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

Och returnerar följande resultat:

Första exemplet: "d"
Andra exemplet: 3

lastIndexOf

Returnera startpositionen eller indexvärdet för den sista förekomsten av en delsträng. Den här funktionen är inte skiftlägeskänslig och index börjar med talet 0.

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

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som har delsträngen att hitta
<searchText>	Ja	String	Delsträngen som ska hittas

Returvärde	Typ	Beskrivning
<ending-index-value>	Integer	Startpositionen eller indexvärdet för den senaste förekomsten av den angivna delsträngen. Om strängen inte hittas returnerar du talet -1.

Exempel

I det här exemplet hittas startindexvärdet för den sista förekomsten av understrängen "world" i strängen "hello world":

lastIndexOf('hello world', 'world')

Och returnerar det här resultatet: 6

längd

Returnera antalet objekt i en samling.

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

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng eller matris	Samlingen med de objekt som ska räknas

Returvärde	Typ	Beskrivning
<längd eller antal>	Integer	Antalet objekt i samlingen

Exempel

I de här exemplen räknas antalet objekt i dessa samlingar:

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

Och returnera det här resultatet: 4

less

Kontrollera om det första värdet är mindre än det andra värdet. Returnera sant när det första värdet är mindre eller returnera falskt när det första värdet är mer.

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

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Heltal, flyttal eller sträng	Det första värdet för att kontrollera om mindre än det andra värdet
<compareTo>	Ja	Heltal, flyttal respektive sträng	Jämförelseobjektet

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när det första värdet är mindre än det andra värdet. Returnera false när det första värdet är lika med eller större än det andra värdet.

Exempel

De här exemplen kontrollerar om det första värdet är mindre än det andra värdet.

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

Och returnera dessa resultat:

Första exemplet: true
Andra exemplet: false

lessOrEquals

Kontrollera om det första värdet är mindre än eller lika med det andra värdet. Returnera sant när det första värdet är mindre än eller lika med, eller returnera falskt när det första värdet är mer.

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

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Heltal, flyttal eller sträng	Det första värdet för att kontrollera om mindre än eller lika med det andra värdet
<compareTo>	Ja	Heltal, flyttal respektive sträng	Jämförelseobjektet

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när det första värdet är mindre än eller lika med det andra värdet. Returnera false när det första värdet är större än det andra värdet.

Exempel

De här exemplen kontrollerar om det första värdet är mindre eller lika med det andra värdet.

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

Och returnera dessa resultat:

Första exemplet: true
Andra exemplet: false

max

Returnera det högsta värdet från en lista eller matris med tal som är inkluderande i båda ändar.

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

Parameter	Obligatoriskt	Type	Beskrivning
<number1>, <number2>, ...	Ja	Heltal, flyttal eller båda	Den uppsättning tal som du vill ha det högsta värdet från
[<number1>, <number2>, ...]	Ja	Matris – heltal, flyttal eller båda	Matrisen med tal som du vill ha det högsta värdet från

Returvärde	Typ	Beskrivning
<max-value>	Heltal eller flyttal	Det högsta värdet i den angivna matrisen eller uppsättningen med tal

Exempel

De här exemplen får det högsta värdet från uppsättningen tal och matrisen:

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

Och returnera det här resultatet: 3

min

Returnera det lägsta värdet från en uppsättning tal eller en matris.

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

Parameter	Obligatoriskt	Type	Beskrivning
<number1>, <number2>, ...	Ja	Heltal, flyttal eller båda	Den uppsättning tal som du vill ha det lägsta värdet från
[<number1>, <number2>, ...]	Ja	Matris – heltal, flyttal eller båda	Matrisen med tal som du vill ha det lägsta värdet från

Returvärde	Typ	Beskrivning
<min-value>	Heltal eller flyttal	Det lägsta värdet i den angivna uppsättningen tal eller angiven matris

Exempel

De här exemplen får det lägsta värdet i uppsättningen tal och matrisen:

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

Och returnera det här resultatet: 1

mod

Returnera resten från att dividera ett tal med ett annat tal. Information om heltalsdivision finns i div().

mod(<dividend>, <divisor>)

Parameter	Obligatoriskt	Type	Beskrivning
<utdelning>	Ja	Heltal eller flyttal	Talet som ska divideras med divisorn
<divisor>	Ja	Heltal eller flyttal	Talet som delar utdelningen. Ett divisorvärde på noll orsakar ett fel vid körning.

Returvärde	Typ	Beskrivning
<modulo-result>	Heltal eller flyttal	Resten från att dividera det första talet med det andra talet

Exempel

I det här exemplet beräknas resten när det första talet divideras med det andra talet:

mod(3, 2)

Och returnerar det här resultatet: 1

mul

Returnera produkten från att multiplicera två tal.

mul(<multiplicand1>, <multiplicand2>)

Parameter	Obligatoriskt	Type	Beskrivning
<multiplicand1>	Ja	Heltal eller flyttal	Talet som ska multipliceras med multiplicand2
<multiplicand2>	Ja	Heltal eller flyttal	Talet som multiplicerar multiplicand1

Returvärde	Typ	Beskrivning
<produktresultat>	Heltal eller flyttal	Produkten från att multiplicera det första talet med det andra talet

Exempel

De här exemplen multiplicerar det första talet med det andra talet:

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

Och returnera dessa resultat:

Första exemplet: 2
Andra exemplet 3

not

Kontrollera om ett uttryck är falskt. Returnera sant när uttrycket är falskt eller returnera falskt när det är sant.

not(<expression>)

Parameter	Obligatoriskt	Type	Beskrivning
<uttryck>	Ja	Booleskt	Uttrycket som ska kontrolleras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när uttrycket är falskt. Returnera false när uttrycket är sant.

Exempel 1

De här exemplen kontrollerar om de angivna uttrycken är falska:

not(false)
not(true)

Och returnera dessa resultat:

Första exemplet: Uttrycket är falskt, så funktionen returnerar true.
Andra exemplet: Uttrycket är sant, så funktionen returnerar false.

Exempel 2

De här exemplen kontrollerar om de angivna uttrycken är falska:

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

Och returnera dessa resultat:

Första exemplet: Uttrycket är falskt, så funktionen returnerar true.
Andra exemplet: Uttrycket är sant, så funktionen returnerar false.

eller

Kontrollera om minst ett uttryck är sant. Returnera sant när minst ett uttryck är sant eller returnerar falskt när båda är falska.

or(<expression1>, <expression2>)

Parameter	Obligatoriskt	Type	Beskrivning
<expression1>, <expression2>	Ja	Booleskt	De uttryck som ska kontrolleras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när minst ett uttryck är sant. Returnera false när båda uttrycken är falska.

Exempel 1

De här exemplen kontrollerar om minst ett uttryck är sant:

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

Och returnera dessa resultat:

Första exemplet: Minst ett uttryck är sant, så funktionen returnerar true.
Andra exemplet: Båda uttrycken är falska, så funktionen returnerar false.

Exempel 2

De här exemplen kontrollerar om minst ett uttryck är sant:

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

Och returnera dessa resultat:

Första exemplet: Minst ett uttryck är sant, så funktionen returnerar true.
Andra exemplet: Båda uttrycken är falska, så funktionen returnerar false.

Rand

Returnera ett slumpmässigt heltal från ett angivet intervall, som endast är inkluderande i startänden.

rand(<minValue>, <maxValue>)

Parameter	Obligatoriskt	Type	Beskrivning
<minValue>	Ja	Integer	Det lägsta heltalet i intervallet
<maxValue>	Ja	Integer	Det heltal som följer det högsta heltalet i intervallet som funktionen kan returnera

Returvärde	Typ	Beskrivning
<slumpmässigt resultat>	Integer	Det slumpmässiga heltal som returneras från det angivna intervallet. Observera att varje anrop av `rand()` ger ett unikt resultat, vilket innebär att det värde som du ser i utdataövervakningen kanske inte är detsamma vid faktisk körning.

Exempel

Det här exemplet hämtar ett slumpmässigt heltal från det angivna intervallet, exklusive det maximala värdet:

rand(1, 5)

Och returnerar ett av dessa tal som resultat: 1, 2, 3eller 4

intervall

Returnera en heltalsmatris som startar från ett angivet heltal.

range(<startIndex>, <count>)

Parameter	Obligatoriskt	Type	Beskrivning
<startIndex>	Ja	Integer	Ett heltalsvärde som startar matrisen som det första objektet
<antal>	Ja	Integer	Antalet heltal i matrisen

Returvärde	Typ	Beskrivning
[<intervallresultat>]	Matris	Matrisen med heltal från det angivna indexet

Exempel

Det här exemplet skapar en heltalsmatris som startar från det angivna indexet och har det angivna antalet heltal:

range(1, 4)

Och returnerar det här resultatet: [1, 2, 3, 4]

ersätt

Ersätt en delsträng med den angivna strängen och returnera resultatsträngen. Den här funktionen är skiftlägeskänslig.

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

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som har delsträngen att ersätta
<oldText>	Ja	String	Delsträngen som ska ersättas
<newText>	Ja	String	Ersättningssträngen

Returvärde	Typ	Beskrivning
<updated-text>	String	Den uppdaterade strängen efter att du har ersatt delsträngen Om delsträngen inte hittas returnerar du den ursprungliga strängen.

Exempel

Det här exemplet hittar den "gamla" delsträngen i "den gamla strängen" och ersätter "gammal" med "ny":

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

Och returnerar det här resultatet: "the new string"

hoppa över

Ta bort objekt från framsidan av en samling och returnera alla andra objekt.

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

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Matris	Samlingen vars objekt du vill ta bort
<antal>	Ja	Integer	Ett positivt heltal för antalet objekt att ta bort längst fram

Returvärde	Typ	Beskrivning
[<updated-collection>]	Matris	Den uppdaterade samlingen efter att de angivna objekten har tagits bort

Exempel

Det här exemplet tar bort ett objekt, talet 0, från den angivna matrisens framsida:

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

Och returnerar den här matrisen med de återstående objekten: [1,2,3]

dela

Dela en sträng vid varje förekomst av en angiven avgränsare och returnera de resulterande delsträngarna som element i en matris. En avgränsare är vanligtvis ett enda tecken, men avgränsare med flera tecken stöds.

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

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som ska delas upp i delsträngar
<avgränsare>	Ja	String	Strängen som ska användas som avgränsare

Returvärde	Typ	Beskrivning
[<substring1,substring2><>,...]	Matris	En matris som innehåller delsträngar av den ursprungliga strängen

Exempel

Det här exemplet returnerar en matris som innehåller delsträngar av strängen "a_b_c" baserat på avgränsaren "_":

split('a_b_c', '_')

Matrisen som returneras är: ["a","b","c"]

startOfDay

Returnera dagens start för en tidsstämpel.

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Den angivna tidsstämpeln men börjar med nolltimmesmarkeringen för dagen

Exempel

Det här exemplet hittar dagens start för den här tidsstämpeln:

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

Och returnerar det här resultatet: "2018-03-15T00:00:00.0000000Z"

startOfHour

Returnera timmens start för en tidsstämpel.

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Den angivna tidsstämpeln men börjar med nollminutersmarkeringen för timmen

Exempel

Det här exemplet hittar timmens början för den här tidsstämpeln:

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

Och returnerar det här resultatet: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Returnera början av månaden för en tidsstämpel.

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Den angivna tidsstämpeln men börjar den första dagen i månaden vid nolltimmesmarkeringen

Exempel

Det här exemplet returnerar början av månaden för den här tidsstämpeln:

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

Och returnerar det här resultatet: "2018-03-01T00:00:00.0000000Z"

startsWith

Kontrollera om en sträng börjar med en specifik delsträng. Returnera sant när delsträngen hittas eller returnera falskt när den inte hittas. Den här funktionen är inte skiftlägeskänslig.

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

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som ska kontrolleras
<searchText>	Ja	String	Den startsträng som ska hittas

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när startundersträngen hittas. Returnera falskt när det inte hittas.

Exempel 1

Det här exemplet kontrollerar om "hello world"-strängen börjar med understrängen "hello":

startsWith('hello world', 'hello')

Och returnerar det här resultatet: true

Exempel 2

Det här exemplet kontrollerar om "hello world"-strängen börjar med understrängen "greetings":

startsWith('hello world', 'greetings')

Och returnerar det här resultatet: false

sträng

Returnera strängversionen för ett värde.

string(<value>)

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Alla	Värdet som ska konverteras

Returvärde	Typ	Beskrivning
<string-value>	String	Strängversionen för det angivna värdet

Exempel 1

I det här exemplet skapas strängversionen för det här numret:

string(10)

Och returnerar det här resultatet: "10"

Exempel 2

Det här exemplet skapar en sträng för det angivna JSON-objektet och använder omvänt snedstreck (\) som ett escape-tecken för det dubbla citattecknet (").

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

Och returnerar det här resultatet: "{ \\"name\\": \\"Sophie Owen\\" }"

under

Returnera resultatet från att subtrahera ett tal från ett annat tal.

sub(<minuend>, <subtrahend>)

Parameter	Obligatoriskt	Type	Beskrivning
<minuend>	Ja	Heltal eller flyttal	Talet som subtrakten ska subtraheras från
<subtrahend>	Ja	Heltal eller flyttal	Talet som ska subtraheras från minuend

Returvärde	Typ	Description
<resultat>	Heltal eller flyttal	Resultatet från att subtrahera det andra talet från det första talet

Exempel

Det här exemplet subtraherar det andra talet från det första talet:

sub(10.3, .3)

Och returnerar det här resultatet: 10

Delsträng

Returnera tecken från en sträng, med början från den angivna positionen eller indexet. Indexvärden börjar med talet 0.

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

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen vars tecken du vill ha
<startIndex>	Ja	Integer	Ett positivt tal som är lika med eller större än 0 som du vill använda som startposition eller indexvärde
<length>	Ja	Integer	Ett positivt antal tecken som du vill använda i understrängen

Returvärde	Typ	Beskrivning
<substring-result>	String	En delsträng med det angivna antalet tecken, med början vid den angivna indexpositionen i källsträngen

Exempel

I det här exemplet skapas en delsträng med fem tecken från den angivna strängen, med början från indexvärdet 6:

substring('hello world', 6, 5)

Och returnerar det här resultatet: "world"

subtractFromTime

Subtrahera ett antal tidsenheter från en tidsstämpel. Se även getPastTime.

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

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<interval>	Ja	Integer	Antalet angivna tidsenheter som ska subtraheras
<timeUnit>	Ja	String	Den tidsenhet som ska användas med intervall: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Tidsstämpeln minus det angivna antalet tidsenheter

Exempel 1

Det här exemplet subtraherar en dag från den här tidsstämpeln:

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

Och returnerar det här resultatet: "2018-01-01T00:00:00:0000000Z"

Exempel 2

Det här exemplet subtraherar en dag från den här tidsstämpeln:

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

Och returnerar det här resultatet med det valfria D-formatet: "Monday, January, 1, 2018"

ta

Returnera objekt från framsidan av en samling.

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

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng eller matris	Samlingen vars objekt du vill ha
<antal>	Ja	Integer	Ett positivt heltal för det antal objekt som du vill använda framifrån

Returvärde	Typ	Beskrivning
<delmängd eller [<delmängd>]>	Sträng eller matris, respektive	En sträng eller matris som har det angivna antalet objekt som tagits framifrån den ursprungliga samlingen

Exempel

I de här exemplen hämtas det angivna antalet objekt längst fram i dessa samlingar:

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

Och returnera dessa resultat:

Första exemplet: "abc"
Andra exemplet: [0, 1, 2]

Fästingar

Returnera egenskapsvärdet ticks för en angiven tidsstämpel. En bock är ett intervall på 100 nanosekunder.

ticks('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen för en tidsstämpel

Returvärde	Typ	Beskrivning
<ticks-number>	Integer	Antalet fästingar som har förflutit sedan 12:00:00 midnatt, 1 januari 0001 i den gregorianska kalendern sedan tidsstämpeln för indata

toLower

Returnera en sträng i gemener. Om ett tecken i strängen inte har en gemen version förblir det tecknet oförändrat i den returnerade strängen.

toLower('<text>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som ska returneras i gemener

Returvärde	Typ	Beskrivning
<gemener-text>	String	Den ursprungliga strängen i gemener

Exempel

I det här exemplet konverteras strängen till gemener:

toLower('Hello World')

Och returnerar det här resultatet: "hello world"

toUpper

Returnera en sträng i versaler. Om ett tecken i strängen inte har en versalversion förblir det tecknet oförändrat i den returnerade strängen.

toUpper('<text>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som ska returneras i versaler

Returvärde	Typ	Beskrivning
<versaler-text>	String	Den ursprungliga strängen i versaler

Exempel

I det här exemplet konverteras strängen till versaler:

toUpper('Hello World')

Och returnerar det här resultatet: "HELLO WORLD"

trimma

Ta bort inledande och avslutande blanksteg från en sträng och returnera den uppdaterade strängen.

trim('<text>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som har det inledande och avslutande blanksteget att ta bort

Returvärde	Typ	Beskrivning
<updatedText>	String	En uppdaterad version för den ursprungliga strängen utan inledande eller avslutande blanksteg

Exempel

Det här exemplet tar bort det inledande och avslutande blanksteget från strängen " Hello World ":

trim(' Hello World  ')

Och returnerar det här resultatet: "Hello World"

union

Returnera en samling som innehåller alla objekt från de angivna samlingarna. För att visas i resultatet kan ett objekt visas i valfri samling som skickas till den här funktionen. Om ett eller flera objekt har samma namn visas det sista objektet med det namnet i resultatet.

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

Parameter	Obligatoriskt	Type	Beskrivning
<collection1>, <collection2>, ...	Ja	Matris eller objekt, men inte båda	Samlingarna där du vill ha alla objekt

Returvärde	Typ	Beskrivning
<updatedCollection>	Matris eller objekt, respektive	En samling med alla objekt från de angivna samlingarna – inga dubbletter

Exempel

Det här exemplet hämtar alla objekt från dessa samlingar:

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

Och returnerar det här resultatet: [1, 2, 3, 10, 101]

uriComponent

Returnera en URI-kodad version (uniform resource identifier) för en sträng genom att ersätta URL-osäkra tecken med escape-tecken. Använd den här funktionen i stället för encodeUriComponent(). Även om båda funktionerna fungerar på samma sätt uriComponent() är det att föredra.

uriComponent('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen som ska konverteras till URI-kodat format

Returvärde	Typ	Beskrivning
<encoded-uri>	String	Den URI-kodade strängen med escape-tecken

Exempel

Det här exemplet skapar en URI-kodad version för den här strängen:

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

Och returnerar det här resultatet: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Returnera den binära versionen för en URI-komponent (uniform resource identifier).

uriComponentToBinary('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Den URI-kodade strängen som ska konverteras

Returvärde	Typ	Beskrivning
<binary-for-encoded-uri>	String	Den binära versionen för den URI-kodade strängen. Det binära innehållet är base64-kodat och representeras av `$content`.

Exempel

Det här exemplet skapar binärversionen för den här URI-kodade strängen:

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

Och returnerar det här resultatet:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Returnera strängversionen för en URI-kodad sträng (uniform resource identifier) som effektivt avkodar den URI-kodade strängen.

uriComponentToString('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Den URI-kodade strängen som ska avkodas

Returvärde	Typ	Beskrivning
<decoded-uri>	String	Den avkodade versionen för den URI-kodade strängen

Exempel

I det här exemplet skapas den avkodade strängversionen för den här URI-kodade strängen:

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

Och returnerar det här resultatet: "https://contoso.com"

utcNow

Returnera den aktuella tidsstämpeln.

utcNow('<format>')

Du kan också ange ett annat format med formatparametern<>.

Parameter	Obligatoriskt	Type	Beskrivning
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.

Returvärde	Typ	Beskrivning
<current-timestamp>	String	Aktuellt datum och tid

Exempel 1

Anta att idag är den 15 april 2018 kl. 13:00:00. Det här exemplet hämtar den aktuella tidsstämpeln:

utcNow()

Och returnerar det här resultatet: "2018-04-15T13:00:00.0000000Z"

Exempel 2

Anta att idag är den 15 april 2018 kl. 13:00:00. Det här exemplet hämtar den aktuella tidsstämpeln med det valfria D-formatet:

utcNow('D')

Och returnerar det här resultatet: "Sunday, April 15, 2018"

xml

Returnera XML-versionen för en sträng som innehåller ett JSON-objekt.

xml('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen med JSON-objektet som ska konverteras JSON-objektet får bara ha en rotegenskap, som inte kan vara en matris. Använd omvänt snedstreck (\) som ett escape-tecken för det dubbla citattecknet (").

Returvärde	Typ	Beskrivning
<xml-version>	Objekt	Kodad XML för den angivna strängen eller JSON-objektet

Exempel 1

I det här exemplet skapas XML-versionen för den här strängen, som innehåller ett JSON-objekt:

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

Och returnerar den här resultat-XML:en:

<name>Sophia Owen</name>

Exempel 2

Anta att du har det här JSON-objektet:

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

I det här exemplet skapas XML för en sträng som innehåller det här JSON-objektet:

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

Och returnerar den här resultat-XML:en:

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

xpath

Kontrollera XML för noder eller värden som matchar ett XPath-uttryck (XML Path Language) och returnera matchande noder eller värden. Ett XPath-uttryck, eller bara "XPath", hjälper dig att navigera i en XML-dokumentstruktur så att du kan välja noder eller beräkningsvärden i XML-innehållet.

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

Parameter	Obligatoriskt	Type	Beskrivning
<xml>	Ja	Alla	XML-strängen för att söka efter noder eller värden som matchar ett XPath-uttrycksvärde
<xpath>	Ja	Alla	XPath-uttrycket som används för att hitta matchande XML-noder eller värden

Returvärde	Typ	Beskrivning
<xml-node>	XML	En XML-nod när endast en enskild nod matchar det angivna XPath-uttrycket
<värde>	Alla	Värdet från en XML-nod när endast ett enda värde matchar det angivna XPath-uttrycket
[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]	Matris	En matris med XML-noder eller värden som matchar det angivna XPath-uttrycket

Exempel 1

I exempel 1 hittar det här exemplet noder som matchar <count></count> noden och lägger till dessa nodvärden med sum() funktionen:

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

Och returnerar det här resultatet: 30

Exempel 2

I det här exemplet hittar båda uttrycken <location></location> noder som matchar noden i de angivna argumenten, som inkluderar XML med ett namnområde. Uttrycken använder omvänt snedstreck (\) som ett escape-tecken för det dubbla citattecknet (").

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

Här är argumenten:

Den här XML-koden, som innehåller XML-dokumentnamnområdet, xmlns="http://contoso.com":

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

Antingen XPath-uttryck här:
- /*[name()=\"file\"]/*[name()=\"location\"]
- /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

Här är resultatnoden som matchar <location></location> noden:

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

Exempel 3

I exempel 3 hittar det här exemplet värdet i <location></location> noden:

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

Och returnerar det här resultatet: "Paris"

Kommentar

Man kan lägga till kommentarer i dataflödesuttryck, men inte i pipelineuttryck.

En lista över systemvariabler som du kan använda i uttryck finns i Systemvariabler.

Dela via

Uttryck och funktioner i Azure Data Factory och Azure Synapse Analytics

Uttryck

Exempel

Exempel på komplext uttryck

Redigerare för dynamiskt innehåll

En datauppsättning med en parameter

En pipeline med en parameter

Ersätta specialtecken

Undfly enkelt citattecken

Självstudier

Funktioner

Datumfunktioner

Strängfunktioner

Insamlingsfunktioner

Logiska funktioner

Konverteringsfunktioner

Matematikfunktioner

Funktionsreferens

add

addDays

addHours

addMinutes

addSeconds

addToTime

och

matris

base64

base64ToBinary

base64ToString

binary

bool

sammansmälta

concat

innehåller

convertFromUtc

convertTimeZone

convertToUtc

createArray

dataUri

dataUriToBinary

dataUriToString

dayOfMonth

dayOfWeek

dayOfYear

avkodaBase64

decodeDataUri

decodeUriComponent

div

encodeUriComponent

empty

endsWith

equals

Första

flyttal

formatDateTime

getFutureTime

getPastTime

greater

greaterOrEquals

guid

if

indexOf

heltal

json

vägkorsning

anslut

senaste

lastIndexOf

längd

less

lessOrEquals

max

min

mod

mul

not

eller

Rand

intervall