Dela via


Uttryck och funktioner i Azure Data Factory och Azure Synapse Analytics

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.

  1. Lägg till datum i ett filnamn: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))

  2. Lägg till DateTime i kundens tidszon: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))

  3. Tilläggstid för utlösare: @concat('Test_', pipeline().TriggerTime)

  4. 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:

  1. URL-kodning mot det ursprungliga strängvärdet
  2. Ersätt URL-kodad sträng, till exempel radmatning (%0A), vagnretur (%0D), vågrät flik(%09).
  3. 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:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

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.