Expressies en functies in Azure Data Factory en Azure Synapse Analytics

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

Dit artikel bevat informatie over expressies en functies die worden ondersteund door Azure Data Factory en Azure Synapse Analytics.

Expressies

JSON-waarden in de definitie kunnen letterlijk zijn of expressies die tijdens runtime worden geëvalueerd. Voorbeeld:

"name": "value"

or

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

Expressies kunnen overal in een JSON-tekenreekswaarde worden weergegeven en resulteren altijd in een andere JSON-waarde. Als een JSON-waarde een expressie is, wordt de hoofdtekst van de expressie geëxtraheerd door het at-sign (@) te verwijderen. Als er een letterlijke tekenreeks nodig is die begint met @, moet deze worden ontsnapt met @@. In de volgende voorbeelden ziet u hoe expressies worden geëvalueerd.

JSON-waarde Resultaat
"parameters" De tekens parameters worden geretourneerd.
"parameters[1]" De tekens 'parameters[1]' worden geretourneerd.
"@@" Er wordt een tekenreeks van 1 tekenreeks met @geretourneerd.
" @" Er wordt een tekenreeks van 2 tekens geretourneerd die @bevat.

Expressies kunnen ook worden weergegeven in tekenreeksen, met behulp van een functie genaamd tekenreeksinterpolatie waarin expressies worden verpakt @{ ... }. Bijvoorbeeld: "name" : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Met behulp van tekenreeksinterpolatie is het resultaat altijd een tekenreeks. Stel dat ik heb gedefinieerd myNumber als 42 en myString als foo:

JSON-waarde Resultaat
"@pipeline().parameters.myString" Retourneert foo als een tekenreeks.
"@{pipeline().parameters.myString}" Retourneert foo als een tekenreeks.
"@pipeline().parameters.myNumber" Retourneert 42 als een getal.
"@{pipeline().parameters.myNumber}" Retourneert 42 als een tekenreeks.
"Antwoord is: @{pipeline().parameters.myNumber}" Retourneert de tekenreeks Answer is: 42.
"@concat('Answer is: ', string(pipeline().parameters.myNumber))' Retourneert de tekenreeks Answer is: 42
"Antwoord is: @@{pipeline().parameters.myNumber}" Retourneert de tekenreeks Answer is: @{pipeline().parameters.myNumber}.

In de controlestroomactiviteiten zoals ForEach-activiteit kunt u een matrix opgeven die moet worden herhaald voor de eigenschapsitems en kunt u deze gebruiken @item() om één opsomming in ForEach-activiteit te herhalen. Als items bijvoorbeeld een matrix is: [1, 2, 3], @item() retourneert 1 in de eerste iteratie, 2 in de tweede iteratie en 3 in de derde iteratie. U kunt ook een dergelijke expressie gebruiken @range(0,10) om tien keer te herhalen vanaf 0 eindigend op 9.

U kunt activiteitsnaam gebruiken @activity() om de uitvoer van de activiteit vast te leggen en beslissingen te nemen. Overweeg een webactiviteit met de naam Web1. Voor het plaatsen van de uitvoer van de eerste activiteit in de hoofdtekst van de tweede ziet de expressie er doorgaans als volgt uit: @activity('Web1').output of @activity('Web1').output.data of iets vergelijkbaars, afhankelijk van hoe de uitvoer van de eerste activiteit eruitziet.

Voorbeelden

Voorbeeld van complexe expressie

In het onderstaande voorbeeld ziet u een complex voorbeeld dat verwijst naar een diep subveld van de uitvoer van de activiteit. Als u wilt verwijzen naar een pijplijnparameter die naar een subveld evalueert, gebruikt u de syntaxis [] in plaats van dot(.) operator (zoals in het geval van subveld1 en subveld2), als onderdeel van een activiteitsuitvoer.

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

Het dynamisch maken van bestanden en het benoemen ervan is een gangbaar patroon. Laten we enkele voorbeelden van dynamische bestandsnamen verkennen.

  1. Datum toevoegen aan een bestandsnaam: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))

  2. Datum/tijd toevoegen in de tijdzone van de klant: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))

  3. Triggertijd toevoegen: @concat('Test_', pipeline().TriggerTime)

  4. Voer een aangepaste bestandsnaam uit in een toewijzings-Gegevensstroom bij uitvoer naar één bestand met datum:'Test_' + toString(currentDate()) + '.csv'

In bovenstaande gevallen worden 4 dynamische bestandsnamen gemaakt vanaf Test_.

Dynamische inhoudseditor

Dynamische inhoudseditor escapet automatisch tekens in uw inhoud wanneer u klaar bent met bewerken. De volgende inhoud in de inhoudseditor is bijvoorbeeld een tekenreeksinterpolatie met twee expressiefuncties.

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

Dynamische inhoudseditor converteert boven inhoud naar expressie "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}". Het resultaat van deze expressie is een tekenreeks voor JSON-indeling die hieronder wordt weergegeven.

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

Een gegevensset met een parameter

In het volgende voorbeeld gebruikt de BlobDataset een parameter met de naam van het pad. De waarde wordt gebruikt om een waarde in te stellen voor de eigenschap folderPath met behulp van de expressie: dataset().path.

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

Een pijplijn met een parameter

In het volgende voorbeeld gebruikt de pijplijn inputPath - en outputPath-parameters . Het pad voor de geparameteriseerde blobgegevensset wordt ingesteld met behulp van waarden van deze parameters. De syntaxis die hier wordt gebruikt, is: 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"
            }
        }
    }
}

Speciale tekens vervangen

Dynamische inhoudseditor escapet automatisch tekens zoals dubbele aanhalingstekens, backslash in uw inhoud wanneer u klaar bent met bewerken. Dit veroorzaakt problemen als u de regelfeed of tab wilt vervangen door de functie \n, \t in replace() te gebruiken. U kunt uw dynamische inhoud bewerken in de codeweergave om het extra \ in de expressie te verwijderen, of u kunt de onderstaande stappen volgen om speciale tekens te vervangen met behulp van de expressietaal:

  1. URL-codering op basis van de oorspronkelijke tekenreekswaarde
  2. Vervang de tekenreeks met URL-codering, bijvoorbeeld regelfeed (%0A), regelterugloop (%0D), horizontaal tabblad (%09).
  3. URL-decodering

Variabele companyName met een nieuw regelteken in de waarde @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) kan bijvoorbeeld het nieuwe regelteken verwijderen.

Contoso-
Corporation

Eén aanhalingsteken ontsnappen

Expressiefuncties gebruiken enkele aanhalingstekens voor parameters voor tekenreekswaarden. Gebruik twee enkele aanhalingstekens om een ' teken in tekenreeksfuncties te escapen. De expressie @concat('Baba', '''s ', 'book store') retourneert bijvoorbeeld het onderstaande resultaat.

Baba's book store

Zelfstudie

In deze zelfstudie leert u hoe u parameters doorgeeft tussen een pijplijn en activiteit en tussen de activiteiten. De zelfstudie demonstreert specifiek stappen voor een Azure Data Factory, hoewel de stappen voor een Synapse-werkruimte bijna gelijkwaardig zijn, maar met een iets andere gebruikersinterface.

Functions

U kunt functies aanroepen binnen expressies. De volgende secties bevatten informatie over de functies die kunnen worden gebruikt in een expressie.

Datumfuncties

Datum- of tijdfunctie Opdracht
addDays Voeg een aantal dagen toe aan een tijdstempel.
addHours Voeg een aantal uren toe aan een tijdstempel.
addMinutes Voeg een aantal minuten toe aan een tijdstempel.
addSeconds Voeg een aantal seconden toe aan een tijdstempel.
addToTime Voeg een aantal tijdseenheden toe aan een tijdstempel. Zie ook getFutureTime.
convertFromUtc Converteer een tijdstempel van Universal Time Coordinated (UTC) naar de doeltijdzone.
convertTimeZone Converteer een tijdstempel van de brontijdzone naar de doeltijdzone.
convertToUtc Converteer een tijdstempel van de brontijdzone naar Universal Time Coordinated (UTC).
dayOfMonth Retourneer de dag van het maandonderdeel uit een tijdstempel.
dayOfWeek Retourneert de dag van de weekcomponent uit een tijdstempel.
dayOfYear Retourneer de dag van het jaaronderdeel uit een tijdstempel.
formatDateTime Retourneert de tijdstempel als een tekenreeks in optionele notatie.
getFutureTime Retourneer de huidige tijdstempel plus de opgegeven tijdseenheden. Zie ook addToTime.
getPastTime Retourneert de huidige tijdstempel minus de opgegeven tijdseenheden. Zie ook aftrekkenVanTijd.
startOfDay Retourneer het begin van de dag voor een tijdstempel.
startOfHour Retourneert het begin van het uur voor een tijdstempel.
startOfMonth Retourneer het begin van de maand voor een tijdstempel.
aftrekkenFromTime Trek een aantal tijdseenheden af van een tijdstempel. Zie ook getPastTime.
Teken Retourneert de ticks eigenschapswaarde voor een opgegeven tijdstempel.
utcNow Retourneert de huidige tijdstempel als een tekenreeks.

Tekenreeksfuncties

Als u met tekenreeksen wilt werken, kunt u deze tekenreeksfuncties en ook enkele verzamelingsfuncties gebruiken. Tekenreeksfuncties werken alleen voor tekenreeksen.

Tekenreeksfunctie Opdracht
Concat Combineer twee of meer tekenreeksen en retourneer de gecombineerde tekenreeks.
endsWith Controleer of een tekenreeks eindigt met de opgegeven subtekenreeks.
Guid Genereer een GUID (Globally Unique Identifier) als een tekenreeks.
indexOf De beginpositie voor een subtekenreeks retourneren.
lastIndexOf Retourneert de beginpositie voor het laatste exemplaar van een subtekenreeks.
replace Vervang een subtekenreeks door de opgegeven tekenreeks en retourneer de bijgewerkte tekenreeks.
split Splits een tekenreeks op elk exemplaar van een opgegeven scheidingsteken en retourneert de resulterende subtekenreeksen als elementen van een matrix.
startsWith Controleer of een tekenreeks begint met een specifieke subtekenreeks.
Subtekenreeks Retourneert tekens uit een tekenreeks, beginnend vanaf de opgegeven positie.
toLower Retourneert een tekenreeks in kleine letters.
Toupper Retourneert een tekenreeks in hoofdletters.
trim Verwijder voorloop- en volgspaties uit een tekenreeks en retourneer de bijgewerkte tekenreeks.

Verzamelingsfuncties

Als u wilt werken met verzamelingen, over het algemeen matrices, tekenreeksen en soms woordenlijsten, kunt u deze verzamelingsfuncties gebruiken.

Verzamelingsfunctie Opdracht
Bevat Controleer of een verzameling een specifiek item heeft.
empty Controleer of een verzameling leeg is.
Eerste Retourneert het eerste item uit een verzameling.
Snijpunt Retourneert een verzameling met alleen de algemene items in de opgegeven verzamelingen.
join Hiermee wordt een tekenreeks geretourneerd die alle items uit een matrix bevat, gescheiden door het opgegeven teken.
Laatste Retourneer het laatste item uit een verzameling.
length Retourneert het aantal items in een tekenreeks of matrix.
skip Verwijder items aan de voorzijde van een verzameling en retourneer alle andere items.
Nemen Items retourneren van de voorzijde van een verzameling.
Unie Hiermee wordt een verzameling geretourneerd die alle items uit de opgegeven verzamelingen bevat.

Logische functies

Deze functies zijn handig binnen voorwaarden, ze kunnen worden gebruikt om elk type logica te evalueren.

Logische vergelijkingsfunctie Opdracht
and Controleer of alle expressies waar zijn.
is gelijk aan Controleer of beide waarden gelijkwaardig zijn.
greater Controleer of de eerste waarde groter is dan de tweede waarde.
greaterOrEquals Controleer of de eerste waarde groter is dan of gelijk is aan de tweede waarde.
if Controleer of een expressie waar of onwaar is. Op basis van het resultaat retourneert u een opgegeven waarde.
less Controleer of de eerste waarde kleiner is dan de tweede waarde.
lessOrEquals Controleer of de eerste waarde kleiner is dan of gelijk is aan de tweede waarde.
Niet Controleer of een expressie onwaar is.
or Controleer of ten minste één expressie waar is.

Conversiefuncties

Deze functies worden gebruikt om te converteren tussen elk van de systeemeigen typen in de taal:

  • tekenreeks
  • geheel getal
  • zwevend
  • boolean
  • Arrays
  • Woordenboeken
Conversiefunctie Opdracht
Array Retourneert een matrix van één opgegeven invoer. Zie CreateArray voor meerdere invoerwaarden.
base64 Retourneert de base64-gecodeerde versie voor een tekenreeks.
base64ToBinary Retourneert de binaire versie voor een met base64 gecodeerde tekenreeks.
base64ToString Retourneert de tekenreeksversie voor een met base64 gecodeerde tekenreeks.
Binaire Retourneert de binaire versie voor een invoerwaarde.
bool Retourneert de Boole-versie voor een invoerwaarde.
samenvoeging Retourneert de eerste niet-null-waarde van een of meer parameters.
createArray Retourneert een matrix van meerdere invoerwaarden.
dataUri Retourneert de gegevens-URI voor een invoerwaarde.
dataUriToBinary Retourneert de binaire versie voor een gegevens-URI.
dataUriToString Retourneert de tekenreeksversie voor een gegevens-URI.
decoderenBase64 Retourneert de tekenreeksversie voor een met base64 gecodeerde tekenreeks.
decodeDataUri Retourneert de binaire versie voor een gegevens-URI.
decodeUriComponent Retourneert een tekenreeks die escape-tekens vervangt door gedecodeerde versies.
encodeUriComponent Retourneert een tekenreeks die URL-onveilige tekens vervangt door escapetekens.
Float Retourneert een drijvende-kommanummer voor een invoerwaarde.
int Retourneert de gehele versie voor een tekenreeks.
json Retourneert de JSON-typewaarde (JavaScript Object Notation) of het object voor een tekenreeks of XML.
Tekenreeks Retourneert de tekenreeksversie voor een invoerwaarde.
uriComponent Retourneert de URI-gecodeerde versie voor een invoerwaarde door URL-onveilige tekens te vervangen door escapetekens.
uriComponentToBinary Retourneert de binaire versie voor een URI-gecodeerde tekenreeks.
uriComponentToString Retourneert de tekenreeksversie voor een URI-gecodeerde tekenreeks.
xml Retourneer de XML-versie voor een tekenreeks.
Xpath Controleer XML op knooppunten of waarden die overeenkomen met een XPath-expressie (XML Path Language) en retourneer de overeenkomende knooppunten of waarden.

Wiskundige functies

Deze functies kunnen worden gebruikt voor beide typen getallen: gehele getallen en floats.

Wiskundige functie Opdracht
add Retourneert het resultaat van het optellen van twee getallen.
div Retourneert het resultaat van het delen van één getal door een ander getal.
max Retourneert de hoogste waarde uit een set getallen of een matrix.
min Retourneert de laagste waarde uit een set getallen of een matrix.
Mod Retourneert de rest van het delen van één getal door een ander getal.
mul Retourneer het product van het vermenigvuldigen van twee getallen.
rand Retourneert een willekeurig geheel getal uit een opgegeven bereik.
range Retourneert een matrix met gehele getallen die begint met een opgegeven geheel getal.
sub Retourneer het resultaat van het aftrekken van één getal van een ander getal.

Referentie voor functies

In deze sectie worden alle beschikbare functies in alfabetische volgorde weergegeven.

add

Retourneert het resultaat van het optellen van twee getallen.

add(<summand_1>, <summand_2>)
Parameter Vereist Type Description
<>summand_1, <summand_2> Ja Geheel getal, float of gemengd De getallen die moeten worden toegevoegd
Retourwaarde Type Description
<result-sum> Geheel getal of float Het resultaat van het toevoegen van de opgegeven getallen

Voorbeeld

In dit voorbeeld worden de opgegeven getallen toegevoegd:

add(1, 1.5)

En retourneert dit resultaat: 2.5

addDays

Voeg een aantal dagen toe aan een tijdstempel.

addDays('<timestamp>', <days>, '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<Dagen> Ja Geheel getal Het positieve of negatieve aantal dagen dat moet worden toegevoegd
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<bijgewerkte tijdstempel> String Het tijdstempel plus het opgegeven aantal dagen

Voorbeeld 1

In dit voorbeeld wordt 10 dagen toegevoegd aan het opgegeven tijdstempel:

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

En retourneert dit resultaat: "2018-03-25T00:00:0000000Z"

Voorbeeld 2

In dit voorbeeld wordt vijf dagen afgetrokken van de opgegeven tijdstempel:

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

En retourneert dit resultaat: "2018-03-10T00:00:0000000Z"

addHours

Voeg een aantal uren toe aan een tijdstempel.

addHours('<timestamp>', <hours>, '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<hours> Ja Geheel getal Het positieve of negatieve aantal uren dat moet worden toegevoegd
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<bijgewerkte tijdstempel> String Het tijdstempel plus het opgegeven aantal uren

Voorbeeld 1

In dit voorbeeld wordt 10 uur toegevoegd aan de opgegeven tijdstempel:

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

En retourneert dit resultaat: "2018-03-15T10:00:0000000Z"

Voorbeeld 2

In dit voorbeeld wordt vijf uur afgetrokken van de opgegeven tijdstempel:

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

En retourneert dit resultaat: "2018-03-15T10:00:0000000Z"

addMinutes

Voeg een aantal minuten toe aan een tijdstempel.

addMinutes('<timestamp>', <minutes>, '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<minutes> Ja Geheel getal Het positieve of negatieve aantal minuten dat moet worden toegevoegd
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<bijgewerkte tijdstempel> String De tijdstempel plus het opgegeven aantal minuten

Voorbeeld 1

In dit voorbeeld wordt 10 minuten toegevoegd aan het opgegeven tijdstempel:

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

En retourneert dit resultaat: "2018-03-15T00:20:00.0000000Z"

Voorbeeld 2

In dit voorbeeld wordt vijf minuten afgetrokken van de opgegeven tijdstempel:

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

En retourneert dit resultaat: "2018-03-15T00:15:00.0000000Z"

addSeconds

Voeg een aantal seconden toe aan een tijdstempel.

addSeconds('<timestamp>', <seconds>, '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<Seconden> Ja Geheel getal Het positieve of negatieve aantal seconden dat moet worden toegevoegd
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<bijgewerkte tijdstempel> String De tijdstempel plus het opgegeven aantal seconden

Voorbeeld 1

In dit voorbeeld wordt 10 seconden toegevoegd aan de opgegeven tijdstempel:

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

En retourneert dit resultaat: "2018-03-15T00:00:10.0000000Z"

Voorbeeld 2

In dit voorbeeld wordt vijf seconden afgetrokken van de opgegeven tijdstempel:

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

En retourneert dit resultaat: "2018-03-15T00:00:25.0000000Z"

addToTime

Voeg een aantal tijdseenheden toe aan een tijdstempel. Zie ook getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<interval> Ja Geheel getal Het aantal opgegeven tijdseenheden dat moet worden toegevoegd
<timeUnit> Ja String De tijdseenheid die moet worden gebruikt met interval: 'Seconde', 'Minuut', 'Uur', 'Dag', 'Week', 'Maand', 'Jaar'
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<bijgewerkte tijdstempel> String Het tijdstempel plus het opgegeven aantal tijdseenheden

Voorbeeld 1

In dit voorbeeld wordt één dag toegevoegd aan de opgegeven tijdstempel:

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

En retourneert dit resultaat: "2018-01-02T00:00:00.0000000Z"

Voorbeeld 2

In dit voorbeeld wordt één dag toegevoegd aan de opgegeven tijdstempel:

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

En retourneert het resultaat met de optionele D-indeling: "Tuesday, January 2, 2018"

en

Controleer of beide expressies waar zijn. Retourneer waar als beide expressies waar zijn of als er ten minste één expressie onwaar is.

and(<expression1>, <expression2>)
Parameter Vereist Type Description
<expressie1>, <expressie2> Ja Booleaanse waarde De expressies die moeten worden gecontroleerd
Retourwaarde Type Description
waar of onwaar Booleaanse waarde Retourneert waar wanneer beide expressies waar zijn. Retourneer onwaar wanneer ten minste één expressie onwaar is.

Voorbeeld 1

Deze voorbeelden controleren of de opgegeven Booleaanse waarden beide waar zijn:

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

En retourneert deze resultaten:

  • Eerste voorbeeld: Beide expressies zijn waar, dus retourneert true.
  • Tweede voorbeeld: Een expressie is onwaar, dus retourneert false.
  • Derde voorbeeld: Beide expressies zijn onwaar, dus retourneert false.

Voorbeeld 2

In deze voorbeelden wordt gecontroleerd of de opgegeven expressies beide waar zijn:

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

En retourneert deze resultaten:

  • Eerste voorbeeld: Beide expressies zijn waar, dus retourneert true.
  • Tweede voorbeeld: Een expressie is onwaar, dus retourneert false.
  • Derde voorbeeld: Beide expressies zijn onwaar, dus retourneert false.

matrix

Retourneert een matrix van één opgegeven invoer. Zie createArray()voor meerdere invoerwaarden.

array('<value>')
Parameter Vereist Type Description
<value> Ja String De tekenreeks voor het maken van een matrix
Retourwaarde Type Description
[<waarde>] Matrix Een matrix die de enkele opgegeven invoer bevat

Voorbeeld

In dit voorbeeld wordt een matrix gemaakt op basis van de 'hallo'-tekenreeks:

array('hello')

En retourneert dit resultaat: ["hello"]

base64

Retourneert de base64-gecodeerde versie voor een tekenreeks.

base64('<value>')
Parameter Vereist Type Description
<value> Ja String De invoertekenreeks
Retourwaarde Type Description
<base64-string> String De base64-gecodeerde versie voor de invoertekenreeks

Voorbeeld

In dit voorbeeld wordt de 'hello'-tekenreeks geconverteerd naar een met base64 gecodeerde tekenreeks:

base64('hello')

En retourneert dit resultaat: "aGVsbG8="

base64ToBinary

Retourneert de binaire versie voor een met base64 gecodeerde tekenreeks.

base64ToBinary('<value>')
Parameter Vereist Type Description
<value> Ja String De met base64 gecodeerde tekenreeks die moet worden geconverteerd
Retourwaarde Type Description
<binary-for-base64-string> String De binaire versie voor de met base64 gecodeerde tekenreeks

Voorbeeld

In dit voorbeeld wordt de met base64 gecodeerde tekenreeks 'aGVsbG8=' geconverteerd naar een binaire tekenreeks:

base64ToBinary('aGVsbG8=')

En retourneert dit resultaat:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Retourneer de tekenreeksversie voor een base64-gecodeerde tekenreeks, waardoor de base64-tekenreeks effectief wordt gedecodeerd. Gebruik deze functie in plaats van decodeBase64(). Hoewel beide functies op dezelfde manier werken, base64ToString() heeft dit de voorkeur.

base64ToString('<value>')
Parameter Vereist Type Description
<value> Ja String De met base64 gecodeerde tekenreeks om te decoderen
Retourwaarde Type Description
<decoded-base64-string> String De tekenreeksversie voor een met base64 gecodeerde tekenreeks

Voorbeeld

In dit voorbeeld wordt de met base64 gecodeerde tekenreeks 'aGVsbG8=' geconverteerd naar alleen een tekenreeks:

base64ToString('aGVsbG8=')

En retourneert dit resultaat: "hello"

binair

Retourneert de binaire versie voor een tekenreeks.

binary('<value>')
Parameter Vereist Type Description
<value> Ja String De tekenreeks die moet worden geconverteerd
Retourwaarde Type Description
<binary-for-input-value> String De binaire versie voor de opgegeven tekenreeks

Voorbeeld

In dit voorbeeld wordt de 'hello'-tekenreeks geconverteerd naar een binaire tekenreeks:

binary('hello')

En retourneert dit resultaat:

"0110100001100101011011000110110001101111"

bool

Retourneert de Booleaanse versie voor een waarde.

bool(<value>)
Parameter Vereist Type Description
<value> Ja Alle De waarde die moet worden geconverteerd
Retourwaarde Type Description
waar of onwaar Booleaanse waarde De Booleaanse versie voor de opgegeven waarde

Voorbeeld

In deze voorbeelden worden de opgegeven waarden geconverteerd naar Booleaanse waarden:

bool(1)
bool(0)

En retourneert deze resultaten:

  • Eerste voorbeeld: true
  • Tweede voorbeeld: false

samenvoeging

Retourneert de eerste niet-null-waarde van een of meer parameters. Lege tekenreeksen, lege matrices en lege objecten zijn niet null.

coalesce(<object_1>, <object_2>, ...)
Parameter Vereist Type Description
<>object_1, <object_2>, ... Ja Elke, kan typen mixen Een of meer items om te controleren op null
Retourwaarde Type Description
<first-non-null-item> Alle Het eerste item of de eerste waarde die niet null is. Als alle parameters null zijn, retourneert deze functie null.

Voorbeeld

Deze voorbeelden retourneren de eerste niet-null-waarde van de opgegeven waarden of null wanneer alle waarden null zijn:

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

En retourneert deze resultaten:

  • Eerste voorbeeld: true
  • Tweede voorbeeld: "hello"
  • Derde voorbeeld: null

concat

Combineer twee of meer tekenreeksen en retourneer de gecombineerde tekenreeks.

concat('<text1>', '<text2>', ...)
Parameter Vereist Type Description
<tekst1>, <tekst2>, ... Ja String Ten minste twee tekenreeksen die moeten worden gecombineerd
Retourwaarde Type Description
<text1text2...> String De tekenreeks die is gemaakt op basis van de gecombineerde invoerreeksen

Voorbeeld

In dit voorbeeld worden de tekenreeksen 'Hallo' en 'Wereld' gecombineerd:

concat('Hello', 'World')

En retourneert dit resultaat: "HelloWorld"

bevat

Controleer of een verzameling een specifiek item heeft. Retourneer waar wanneer het item wordt gevonden of retourneer onwaar wanneer het niet is gevonden. Deze functie is hoofdlettergevoelig.

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

Deze functie werkt met name op deze verzamelingstypen:

  • Een tekenreeks om een subtekenreeks te vinden
  • Een matrix om een waarde te vinden
  • Een woordenlijst om een sleutel te vinden
Parameter Vereist Type Description
<Collectie> Ja Tekenreeks, matrix of woordenlijst De verzameling die moet worden gecontroleerd
<value> Ja Tekenreeks, matrix of woordenlijst, respectievelijk Het item dat moet worden gevonden
Retourwaarde Type Description
waar of onwaar Booleaanse waarde Retourneert waar wanneer het item wordt gevonden. Retourneer onwaar wanneer deze niet is gevonden.

Voorbeeld 1

In dit voorbeeld wordt de tekenreeks 'hallo wereld' gecontroleerd op de subtekenreeks 'wereld' en wordt waar geretourneerd:

contains('hello world', 'world')

Voorbeeld 2

In dit voorbeeld wordt de tekenreeks 'hallo wereld' gecontroleerd op de subtekenreeks 'universum' en wordt onwaar geretourneerd:

contains('hello world', 'universe')

convertFromUtc

Converteer een tijdstempel van Universal Time Coordinated (UTC) naar de doeltijdzone.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<destinationTimeZone> Ja String De naam voor de doeltijdzone. Zie Microsoft-tijdzonewaarden voor tijdzonenamen, maar mogelijk moet u interpunctie uit de tijdzonenaam verwijderen.
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<geconverteerde tijdstempel> String De tijdstempel geconverteerd naar de doeltijdzone

Voorbeeld 1

In dit voorbeeld wordt een tijdstempel geconverteerd naar de opgegeven tijdzone:

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

En retourneert dit resultaat: "2018-01-01T00:00:00Z"

Voorbeeld 2

In dit voorbeeld wordt een tijdstempel geconverteerd naar de opgegeven tijdzone en indeling:

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

En retourneert dit resultaat: "Monday, January 1, 2018"

convertTimeZone

Converteer een tijdstempel van de brontijdzone naar de doeltijdzone.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<sourceTimeZone> Ja String De naam voor de brontijdzone. Zie Microsoft-tijdzonewaarden voor tijdzonenamen, maar mogelijk moet u interpunctie uit de tijdzonenaam verwijderen.
<destinationTimeZone> Ja String De naam voor de doeltijdzone. Zie Microsoft-tijdzonewaarden voor tijdzonenamen, maar mogelijk moet u interpunctie uit de tijdzonenaam verwijderen.
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<geconverteerde tijdstempel> String De tijdstempel geconverteerd naar de doeltijdzone

Voorbeeld 1

In dit voorbeeld wordt de brontijdzone geconverteerd naar de doeltijdzone:

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

En retourneert dit resultaat: "2018-01-01T00:00:00.0000000"

Voorbeeld 2

In dit voorbeeld wordt een tijdzone geconverteerd naar de opgegeven tijdzone en indeling:

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

En retourneert dit resultaat: "Monday, January 1, 2018"

convertToUtc

Converteer een tijdstempel van de brontijdzone naar Universal Time Coordinated (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<sourceTimeZone> Ja String De naam voor de brontijdzone. Zie Microsoft-tijdzonewaarden voor tijdzonenamen, maar mogelijk moet u interpunctie uit de tijdzonenaam verwijderen.
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<geconverteerde tijdstempel> String De tijdstempel geconverteerd naar UTC

Voorbeeld 1

In dit voorbeeld wordt een tijdstempel geconverteerd naar UTC:

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

En retourneert dit resultaat: "2018-01-01T08:00:00.0000000Z"

Voorbeeld 2

In dit voorbeeld wordt een tijdstempel geconverteerd naar UTC:

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

En retourneert dit resultaat: "Monday, January 1, 2018"

createArray

Retourneert een matrix van meerdere invoerwaarden. Zie array()voor enkelvoudige invoermatrices.

createArray('<object1>', '<object2>', ...)
Parameter Vereist Type Description
<object1>, <object2>, ... Ja Alle, maar niet gemengd Ten minste twee items om de matrix te maken
Retourwaarde Type Description
[<object1>, <object2>, ...] Matrix De matrix die is gemaakt op basis van alle invoeritems

Voorbeeld

In dit voorbeeld wordt een matrix gemaakt van deze invoer:

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

En retourneert dit resultaat: ["h", "e", "l", "l", "o"]

dataUri

Retourneert een URI (Data Uniform Resource Identifier) voor een tekenreeks.

dataUri('<value>')
Parameter Vereist Type Description
<value> Ja String De tekenreeks die moet worden geconverteerd
Retourwaarde Type Description
<gegevens-URI> String De gegevens-URI voor de invoertekenreeks

Voorbeeld

In dit voorbeeld wordt een gegevens-URI gemaakt voor de 'hello'-tekenreeks:

dataUri('hello')

En retourneert dit resultaat: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Retourneert de binaire versie voor een gegevens uniform resource-id (URI). Gebruik deze functie in plaats van decodeDataUri(). Hoewel beide functies op dezelfde manier werken, dataUriBinary() heeft dit de voorkeur.

dataUriToBinary('<value>')
Parameter Vereist Type Description
<value> Ja String De gegevens-URI die moet worden geconverteerd
Retourwaarde Type Description
<binary-for-data-uri> String De binaire versie voor de gegevens-URI

Voorbeeld

In dit voorbeeld wordt een binaire versie voor deze gegevens-URI gemaakt:

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

En retourneert dit resultaat:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Retourneert de tekenreeksversie voor een URI (Data Uniform Resource Identifier).

dataUriToString('<value>')
Parameter Vereist Type Description
<value> Ja String De gegevens-URI die moet worden geconverteerd
Retourwaarde Type Description
<tekenreeks-voor-gegevens-URI> String De tekenreeksversie voor de gegevens-URI

Voorbeeld

In dit voorbeeld wordt een tekenreeks gemaakt voor deze gegevens-URI:

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

En retourneert dit resultaat: "hello"

dayOfMonth

Retourneer de dag van de maand uit een tijdstempel.

dayOfMonth('<timestamp>')
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
Retourwaarde Type Description
<dag van de maand> Geheel getal De dag van de maand op basis van de opgegeven tijdstempel

Voorbeeld

In dit voorbeeld wordt het getal voor de dag van de maand uit deze tijdstempel geretourneerd:

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

En retourneert dit resultaat: 15

dayOfWeek

Retourneer de dag van de week vanaf een tijdstempel.

dayOfWeek('<timestamp>')
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
Retourwaarde Type Description
<dag van de week> Geheel getal De dag van de week vanaf de opgegeven tijdstempel waar zondag 0 is, maandag is 1, enzovoort

Voorbeeld

In dit voorbeeld wordt het getal voor de dag van de week uit deze tijdstempel geretourneerd:

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

En retourneert dit resultaat: 3

dayOfYear

Retourneer de dag van het jaar uit een tijdstempel.

dayOfYear('<timestamp>')
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
Retourwaarde Type Description
<dag van het jaar> Geheel getal De dag van het jaar uit de opgegeven tijdstempel

Voorbeeld

In dit voorbeeld wordt het aantal dagen van het jaar uit deze tijdstempel geretourneerd:

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

En retourneert dit resultaat: 74

decoderenBase64

Retourneer de tekenreeksversie voor een base64-gecodeerde tekenreeks, waardoor de base64-tekenreeks effectief wordt gedecodeerd. Overweeg het gebruik van base64ToString() in plaats decodeBase64()van . Hoewel beide functies op dezelfde manier werken, base64ToString() heeft dit de voorkeur.

decodeBase64('<value>')
Parameter Vereist Type Description
<value> Ja String De met base64 gecodeerde tekenreeks om te decoderen
Retourwaarde Type Description
<decoded-base64-string> String De tekenreeksversie voor een met base64 gecodeerde tekenreeks

Voorbeeld

In dit voorbeeld wordt een tekenreeks gemaakt voor een met base64 gecodeerde tekenreeks:

decodeBase64('aGVsbG8=')

En retourneert dit resultaat: "hello"

decodeDataUri

Retourneert de binaire versie voor een gegevens uniform resource-id (URI). Overweeg het gebruik van dataUriToBinary(), in plaats decodeDataUri()van . Hoewel beide functies op dezelfde manier werken, dataUriToBinary() heeft dit de voorkeur.

decodeDataUri('<value>')
Parameter Vereist Type Description
<value> Ja String De gegevens-URI-tekenreeks om te decoderen
Retourwaarde Type Description
<binary-for-data-uri> String De binaire versie voor een gegevens-URI-tekenreeks

Voorbeeld

In dit voorbeeld wordt de binaire versie voor deze gegevens-URI geretourneerd:

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

En retourneert dit resultaat:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Retourneert een tekenreeks die escape-tekens vervangt door gedecodeerde versies.

decodeUriComponent('<value>')
Parameter Vereist Type Description
<value> Ja String De tekenreeks met de escapetekens om te decoderen
Retourwaarde Type Description
<decoderen-URI> String De bijgewerkte tekenreeks met de gedecodeerde escape-tekens

Voorbeeld

In dit voorbeeld worden de escape-tekens in deze tekenreeks vervangen door gedecodeerde versies:

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

En retourneert dit resultaat: "https://contoso.com"

div

Retourneert het resultaat van het delen van één getal door een ander getal.

div(<dividend>, <divisor>)

Het exacte retourtype van de functie is afhankelijk van de typen parameters. Zie voorbeelden voor meer informatie.

Parameter Vereist Type Description
<Dividend> Ja Geheel getal of float Het getal dat moet worden gedeeld door de deler
<Deler> Ja Geheel getal of float Het getal dat het dividend deelt. Een delerwaarde van nul veroorzaakt een fout tijdens runtime.
Retourwaarde Type Description
<quotient-result> Geheel getal of float Het resultaat van het delen van het eerste getal door het tweede getal

Voorbeeld 1

Deze voorbeelden delen het getal 9 door 2:

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

En dit resultaat wordt allemaal geretourneerd: 4.5

Voorbeeld 2

In dit voorbeeld wordt ook het getal 9 door 2 gedeeld, maar omdat beide parameters gehele getallen zijn, wordt de rest genegeerd (gehele getallen delen):

div(9, 2)

De expressie retourneert het resultaat 4. Gebruik de functie mod() om de waarde van het restgetal te verkrijgen.

encodeUriComponent

Retourneert een URI-gecodeerde versie (Uniform Resource Identifier) voor een tekenreeks door URL-onveilige tekens te vervangen door escapetekens. Overweeg het gebruik van uriComponent(), in plaats encodeUriComponent()van . Hoewel beide functies op dezelfde manier werken, uriComponent() heeft dit de voorkeur.

encodeUriComponent('<value>')
Parameter Vereist Type Description
<value> Ja String De tekenreeks die moet worden geconverteerd naar een URI-gecodeerde indeling
Retourwaarde Type Description
<gecodeerde-URI> String De tekenreeks met URI-codering met escapetekens

Voorbeeld

In dit voorbeeld wordt een URI-gecodeerde versie voor deze tekenreeks gemaakt:

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

En retourneert dit resultaat: "http%3A%2F%2Fcontoso.com"

empty

Controleer of een verzameling leeg is. Retourneer waar wanneer de verzameling leeg is of retourneer onwaar als deze niet leeg is.

empty('<collection>')
empty([<collection>])
Parameter Vereist Type Description
<Collectie> Ja Tekenreeks, matrix of object De verzameling die moet worden gecontroleerd
Retourwaarde Type Description
waar of onwaar Booleaanse waarde Retourneert waar wanneer de verzameling leeg is. Retourneer onwaar als deze niet leeg is.

Voorbeeld

In deze voorbeelden wordt gecontroleerd of de opgegeven verzamelingen leeg zijn:

empty('')
empty('abc')

En retourneert deze resultaten:

  • Eerste voorbeeld: Geeft een lege tekenreeks door, zodat de functie retourneert true.
  • Tweede voorbeeld: geeft de tekenreeks 'abc' door, zodat de functie retourneert false.

endsWith

Controleer of een tekenreeks eindigt met een specifieke subtekenreeks. Retourneer waar wanneer de subtekenreeks wordt gevonden of retourneer onwaar wanneer deze niet is gevonden. Deze functie is niet hoofdlettergevoelig.

endsWith('<text>', '<searchText>')
Parameter Vereist Type Beschrijving
<tekst> Ja String De tekenreeks die moet worden gecontroleerd
<searchText> Ja String De eindsubtekenreeks om te zoeken
Retourwaarde Type Description
waar of onwaar Booleaanse waarde Retourneer waar wanneer de eindsubtekenreeks wordt gevonden. Retourneer onwaar wanneer deze niet is gevonden.

Voorbeeld 1

In dit voorbeeld wordt gecontroleerd of de tekenreeks 'hallo wereld' eindigt op de tekenreeks 'wereld':

endsWith('hello world', 'world')

En retourneert dit resultaat: true

Voorbeeld 2

In dit voorbeeld wordt gecontroleerd of de tekenreeks 'hallo wereld' eindigt op de tekenreeks 'universum':

endsWith('hello world', 'universe')

En retourneert dit resultaat: false

equals

Controleer of beide waarden, expressies of objecten gelijkwaardig zijn. Retourneer waar wanneer beide gelijkwaardig zijn of retourneer onwaar als ze niet gelijkwaardig zijn.

equals('<object1>', '<object2>')
Parameter Vereist Type Description
<object1>, <object2> Ja Diverse De waarden, expressies of objecten die moeten worden vergeleken
Retourwaarde Type Description
waar of onwaar Booleaanse waarde Retourneer waar als beide gelijkwaardig zijn. Retourneer onwaar als dit niet gelijk is.

Voorbeeld

Deze voorbeelden controleren of de opgegeven invoer gelijkwaardig is.

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

En retourneert deze resultaten:

  • Eerste voorbeeld: Beide waarden zijn equivalent, dus de functie retourneert true.
  • Tweede voorbeeld: Beide waarden zijn niet gelijkwaardig, dus de functie retourneert false.

Eerste

Retourneert het eerste item uit een tekenreeks of matrix.

first('<collection>')
first([<collection>])
Parameter Vereist Type Description
<Collectie> Ja Tekenreeks of matrix De verzameling waar het eerste item moet worden gevonden
Retourwaarde Type Description
<first-collection-item> Alle Het eerste item in de verzameling

Voorbeeld

In deze voorbeelden vindt u het eerste item in deze verzamelingen:

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

En retourneer deze resultaten:

  • Eerste voorbeeld: "h"
  • Tweede voorbeeld: 0

zwevend

Converteer een tekenreeksversie voor een drijvendekommagetal naar een werkelijk drijvendekommagetal.

float('<value>')
Parameter Vereist Type Description
<value> Ja String De tekenreeks met een geldig drijvende-kommanummer dat moet worden geconverteerd
Retourwaarde Type Description
<float-value> Float Het drijvendekommagetal voor de opgegeven tekenreeks

Voorbeeld

In dit voorbeeld wordt een tekenreeksversie gemaakt voor dit drijvendekommagetal:

float('10.333')

En retourneert dit resultaat: 10.333

formatDateTime

Retourneert een tijdstempel in de opgegeven indeling.

formatDateTime('<timestamp>', '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<opnieuw opgemaakte tijdstempel> String De bijgewerkte tijdstempel in de opgegeven indeling

Voorbeeld

In dit voorbeeld wordt een tijdstempel geconverteerd naar de opgegeven indeling:

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

En retourneert dit resultaat: "2018-03-15T12:00:00"

getFutureTime

Retourneer de huidige tijdstempel plus de opgegeven tijdseenheden.

getFutureTime(<interval>, <timeUnit>, <format>?)
Parameter Vereist Type Description
<interval> Ja Geheel getal Het aantal opgegeven tijdseenheden dat moet worden toegevoegd
<timeUnit> Ja String De tijdseenheid die moet worden gebruikt met interval: 'Seconde', 'Minuut', 'Uur', 'Dag', 'Week', 'Maand', 'Jaar'
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<bijgewerkte tijdstempel> String Het huidige tijdstempel plus het opgegeven aantal tijdseenheden

Voorbeeld 1

Stel dat de huidige tijdstempel 2018-03-01T00:00:00.0000000Z is. In dit voorbeeld worden vijf dagen aan die tijdstempel toegevoegd:

getFutureTime(5, 'Day')

En retourneert dit resultaat: "2018-03-06T00:00:00.0000000Z"

Voorbeeld 2

Stel dat de huidige tijdstempel 2018-03-01T00:00:00.0000000Z is. In dit voorbeeld worden vijf dagen toegevoegd en wordt het resultaat geconverteerd naar de indeling D:

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

En retourneert dit resultaat: "Tuesday, March 6, 2018"

getPastTime

Retourneert de huidige tijdstempel minus de opgegeven tijdseenheden.

getPastTime(<interval>, <timeUnit>, <format>?)
Parameter Vereist Type Description
<interval> Ja Geheel getal Het aantal opgegeven tijdseenheden dat moet worden afgetrokken
<timeUnit> Ja String De tijdseenheid die moet worden gebruikt met interval: 'Seconde', 'Minuut', 'Uur', 'Dag', 'Week', 'Maand', 'Jaar'
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<bijgewerkte tijdstempel> String De huidige tijdstempel minus het opgegeven aantal tijdseenheden

Voorbeeld 1

Stel dat de huidige tijdstempel 2018-02-01T00:00:00.0000000Z is. In dit voorbeeld wordt vijf dagen afgetrokken van die tijdstempel:

getPastTime(5, 'Day')

En retourneert dit resultaat: "2018-01-27T00:00:00.0000000Z"

Voorbeeld 2

Stel dat de huidige tijdstempel 2018-02-01T00:00:00.0000000Z is. In dit voorbeeld wordt vijf dagen afgetrokken en wordt het resultaat geconverteerd naar de indeling D:

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

En retourneert dit resultaat: "Saturday, January 27, 2018"

greater

Controleer of de eerste waarde groter is dan de tweede waarde. Retourneert waar wanneer de eerste waarde meer is of onwaar retourneert als deze kleiner is.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parameter Vereist Type Description
<value> Ja Geheel getal, float of tekenreeks De eerste waarde om te controleren of deze groter is dan de tweede waarde
<Compareto> Ja Geheel getal, float of tekenreeks, respectievelijk De vergelijkingswaarde
Retourwaarde Type Description
waar of onwaar Booleaanse waarde Retourneer waar wanneer de eerste waarde groter is dan de tweede waarde. Retourneer onwaar wanneer de eerste waarde gelijk is aan of kleiner is dan de tweede waarde.

Voorbeeld

In deze voorbeelden wordt gecontroleerd of de eerste waarde groter is dan de tweede waarde:

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

En retourneer deze resultaten:

  • Eerste voorbeeld: true
  • Tweede voorbeeld: false

greaterOrEquals

Controleer of de eerste waarde groter is dan of gelijk is aan de tweede waarde. Retourneer true wanneer de eerste waarde groter of gelijk is aan, of retourneer onwaar wanneer de eerste waarde kleiner is.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parameter Vereist Type Description
<value> Ja Geheel getal, float of tekenreeks De eerste waarde om te controleren of deze groter is dan of gelijk is aan de tweede waarde
<Compareto> Ja Geheel getal, float of tekenreeks, respectievelijk De vergelijkingswaarde
Retourwaarde Type Description
waar of onwaar Booleaanse waarde Retourneer waar wanneer de eerste waarde groter is dan of gelijk is aan de tweede waarde. Retourneer onwaar wanneer de eerste waarde kleiner is dan de tweede waarde.

Voorbeeld

In deze voorbeelden wordt gecontroleerd of de eerste waarde groter of gelijk is aan de tweede waarde:

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

En retourneer deze resultaten:

  • Eerste voorbeeld: true
  • Tweede voorbeeld: false

guid

Genereer een GUID (Globally Unique Identifier) als een tekenreeks, bijvoorbeeld 'c2ecc88d-88c8-4096-912c-d6f2e2b138ce':

guid()

U kunt ook een andere indeling opgeven voor de GUID dan de standaardindeling D. Dit zijn 32 cijfers gescheiden door afbreekstreepjes.

guid('<format>')
Parameter Vereist Type Description
<format> Nee String Eén indelingsaanduiding voor de geretourneerde GUID. De indeling is standaard 'D', maar u kunt 'N', 'D', 'B', 'P' of 'X' gebruiken.
Retourwaarde Type Description
<GUID-waarde> String Een willekeurig gegenereerde GUID

Voorbeeld

In dit voorbeeld wordt dezelfde GUID gegenereerd, maar als 32 cijfers, gescheiden door afbreekstreepjes en tussen haakjes:

guid('P')

En retourneert dit resultaat: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

Controleer of een expressie waar of onwaar is. Op basis van het resultaat retourneert u een opgegeven waarde.

if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parameter Vereist Type Description
<Expressie> Ja Booleaanse waarde De expressie die moet worden gecontroleerd
<waardeIndienWaar> Ja Alle De waarde die moet worden geretourneerd wanneer de expressie waar is
<waardeIndienOnwaar> Ja Alle De waarde die moet worden geretourneerd wanneer de expressie onwaar is
Retourwaarde Type Description
<opgegeven-retourwaarde> Alle De opgegeven waarde die wordt geretourneerd op basis van of de expressie waar of onwaar is

Voorbeeld

Dit voorbeeld retourneert omdat de opgegeven expressie waar retourneert "yes" . Anders retourneert "no"het voorbeeld:

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

indexOf

Retourneert de beginpositie of indexwaarde voor een subtekenreeks. Deze functie is niet hoofdlettergevoelig en indexen beginnen met het getal 0.

indexOf('<text>', '<searchText>')
Parameter Vereist Type Beschrijving
<tekst> Ja String De tekenreeks met de subtekenreeks die moet worden gevonden
<searchText> Ja String De subtekenreeks om te zoeken
Retourwaarde Type Description
<indexwaarde> Geheel getal De beginpositie of indexwaarde voor de opgegeven subtekenreeks.

Als de tekenreeks niet wordt gevonden, geeft u het getal -1 als resultaat.

Voorbeeld

In dit voorbeeld wordt de beginindexwaarde voor de subtekenreeks 'wereld' gevonden in de tekenreeks 'hallo wereld':

indexOf('hello world', 'world')

En retourneert dit resultaat: 6

int

Retourneert de gehele versie voor een tekenreeks.

int('<value>')
Parameter Vereist Type Description
<value> Ja String De tekenreeks die moet worden geconverteerd
Retourwaarde Type Description
<resultaat geheel getal> Geheel getal De versie van het gehele getal voor de opgegeven tekenreeks

Voorbeeld

In dit voorbeeld wordt een geheel getal gemaakt voor de tekenreeks 10:

int('10')

En retourneert dit resultaat: 10

json

Retourneert de JSON-typewaarde (JavaScript Object Notation) of het object voor een tekenreeks of XML.

json('<value>')
Parameter Vereist Type Description
<value> Ja Tekenreeks of XML De tekenreeks of XML die moet worden geconverteerd
Retourwaarde Type Description
<JSON-result> Systeemeigen JSON-type of -object De systeemeigen JSON-typewaarde of -object voor de opgegeven tekenreeks of XML. Als de tekenreeks null is, retourneert de functie een leeg object.

Voorbeeld 1

In dit voorbeeld wordt deze tekenreeks geconverteerd naar de JSON-waarde:

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

En retourneert dit resultaat: [1, 2, 3]

Voorbeeld 2

In dit voorbeeld wordt deze tekenreeks geconverteerd naar JSON:

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

En retourneert dit resultaat:

{
  "fullName": "Sophia Owen"
}

Voorbeeld 3

In dit voorbeeld wordt deze XML geconverteerd naar JSON:

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

En retourneert dit resultaat:

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

Snijpunt

Retourneert een verzameling met alleen de algemene items in de opgegeven verzamelingen. Als u het resultaat wilt weergeven, moet een item worden weergegeven in alle verzamelingen die aan deze functie zijn doorgegeven. Als een of meer items dezelfde naam hebben, wordt het laatste item met die naam weergegeven in het resultaat.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parameter Vereist Type Description
<collection1>, <collection2>, ... Ja Matrix of object, maar niet beide De verzamelingen van waaruit u alleen de algemene items wilt
Retourwaarde Type Description
<common-items> Matrix of object, respectievelijk Een verzameling met alleen de algemene items in de opgegeven verzamelingen

Voorbeeld

In dit voorbeeld worden de algemene items in deze matrices gevonden:

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

En retourneert een matrix met alleen deze items: [1, 2]

join

Retourneert een tekenreeks met alle items uit een matrix en heeft elk teken gescheiden door een scheidingsteken.

join([<collection>], '<delimiter>')
Parameter Vereist Type Description
<Collectie> Ja Matrix De matrix waaraan de items moeten worden gekoppeld
<scheidingsteken> Ja String Het scheidingsteken dat tussen elk teken in de resulterende tekenreeks wordt weergegeven
Retourwaarde Type Description
<char1><scheidingsteken teken2><scheidingsteken...><> String De resulterende tekenreeks die is gemaakt op basis van alle items in de opgegeven matrix

Voorbeeld

In dit voorbeeld wordt een tekenreeks gemaakt van alle items in deze matrix met het opgegeven teken als scheidingsteken:

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

En retourneert dit resultaat: "a.b.c"

Laatste

Retourneer het laatste item uit een verzameling.

last('<collection>')
last([<collection>])
Parameter Vereist Type Description
<Collectie> Ja Tekenreeks of matrix De verzameling waar het laatste item moet worden gevonden
Retourwaarde Type Description
<last-collection-item> Tekenreeks of matrix, respectievelijk Het laatste item in de verzameling

Voorbeeld

In deze voorbeelden vindt u het laatste item in deze verzamelingen:

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

En retourneert deze resultaten:

  • Eerste voorbeeld: "d"
  • Tweede voorbeeld: 3

lastIndexOf

Retourneert de beginpositie of indexwaarde voor het laatste exemplaar van een subtekenreeks. Deze functie is niet hoofdlettergevoelig en indexen beginnen met het getal 0.

lastIndexOf('<text>', '<searchText>')
Parameter Vereist Type Beschrijving
<tekst> Ja String De tekenreeks met de subtekenreeks die moet worden gevonden
<searchText> Ja String De subtekenreeks om te zoeken
Retourwaarde Type Description
<end-index-value> Geheel getal De beginpositie of indexwaarde voor het laatste exemplaar van de opgegeven subtekenreeks.

Als de tekenreeks niet wordt gevonden, geeft u het getal -1 als resultaat.

Voorbeeld

In dit voorbeeld wordt de beginindexwaarde gevonden voor het laatste exemplaar van de subtekenreeks 'wereld' in de tekenreeks 'hallo wereld':

lastIndexOf('hello world', 'world')

En retourneert dit resultaat: 6

length

Retourneert het aantal items in een verzameling.

length('<collection>')
length([<collection>])
Parameter Vereist Type Description
<Collectie> Ja Tekenreeks of matrix De verzameling met de items die moeten worden geteld
Retourwaarde Type Description
<lengte of aantal> Geheel getal Het aantal items in de verzameling

Voorbeeld

In deze voorbeelden wordt het aantal items in deze verzamelingen geteld:

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

En retourneer dit resultaat: 4

less

Controleer of de eerste waarde kleiner is dan de tweede waarde. Retourneer waar wanneer de eerste waarde kleiner is of retourneer onwaar wanneer de eerste waarde meer is.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parameter Vereist Type Description
<value> Ja Geheel getal, float of tekenreeks De eerste waarde om te controleren of kleiner is dan de tweede waarde
<Compareto> Ja Geheel getal, float of tekenreeks, respectievelijk Het vergelijkingsitem
Retourwaarde Type Description
waar of onwaar Booleaanse waarde Retourneert true wanneer de eerste waarde kleiner is dan de tweede waarde. Retourneer onwaar wanneer de eerste waarde gelijk is aan of groter is dan de tweede waarde.

Voorbeeld

In deze voorbeelden wordt gecontroleerd of de eerste waarde kleiner is dan de tweede waarde.

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

En retourneer deze resultaten:

  • Eerste voorbeeld: true
  • Tweede voorbeeld: false

lessOrEquals

Controleer of de eerste waarde kleiner is dan of gelijk is aan de tweede waarde. Retourneer waar als de eerste waarde kleiner is dan of gelijk is aan, of retourneer onwaar wanneer de eerste waarde meer is.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parameter Vereist Type Description
<value> Ja Geheel getal, float of tekenreeks De eerste waarde om te controleren of kleiner dan of gelijk is aan de tweede waarde
<Compareto> Ja Geheel getal, float of tekenreeks, respectievelijk Het vergelijkingsitem
Retourwaarde Type Description
waar of onwaar Booleaanse waarde Retourneer waar als de eerste waarde kleiner is dan of gelijk is aan de tweede waarde. Retourneer onwaar wanneer de eerste waarde groter is dan de tweede waarde.

Voorbeeld

In deze voorbeelden wordt gecontroleerd of de eerste waarde kleiner of gelijk is aan de tweede waarde.

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

En retourneer deze resultaten:

  • Eerste voorbeeld: true
  • Tweede voorbeeld: false

max

Retourneert de hoogste waarde uit een lijst of matrix met getallen die aan beide uiteinden inclusief zijn.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parameter Vereist Type Description
<getal1>, <getal2>, ... Ja Geheel getal, float of beide De set getallen waarvan u de hoogste waarde wilt berekenen
[<getal1>, <getal2>, ...] Ja Matrix: geheel getal, float of beide De matrix met getallen waaruit u de hoogste waarde wilt berekenen
Retourwaarde Type Description
<max-value> Geheel getal of float De hoogste waarde in de opgegeven matrix of set getallen

Voorbeeld

In deze voorbeelden wordt de hoogste waarde opgehaald uit de set getallen en de matrix:

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

En retourneer dit resultaat: 3

min.

Retourneert de laagste waarde uit een set getallen of een matrix.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parameter Vereist Type Description
<getal1>, <getal2>, ... Ja Geheel getal, float of beide De set getallen waaruit u de laagste waarde wilt berekenen
[<getal1>, <getal2>, ...] Ja Matrix: geheel getal, float of beide De matrix met getallen waaruit u de laagste waarde wilt berekenen
Retourwaarde Type Description
<min-waarde> Geheel getal of float De laagste waarde in de opgegeven set getallen of opgegeven matrix

Voorbeeld

Deze voorbeelden krijgen de laagste waarde in de set getallen en de matrix:

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

En retourneer dit resultaat: 1

mod

Retourneert de rest van het delen van één getal door een ander getal. Zie div()voor gehele getallen.

mod(<dividend>, <divisor>)
Parameter Vereist Type Description
<Dividend> Ja Geheel getal of float Het getal dat moet worden gedeeld door de deler
<Deler> Ja Geheel getal of float Het getal dat het dividend deelt. Een delerwaarde van nul veroorzaakt een fout tijdens runtime.
Retourwaarde Type Description
<modulo-result> Geheel getal of float Het restgetal van het delen van het eerste getal door het tweede getal

Voorbeeld

In dit voorbeeld wordt de rest berekend wanneer het eerste getal wordt gedeeld door het tweede getal:

mod(3, 2)

En retourneert dit resultaat: 1

mul

Retourneer het product van het vermenigvuldigen van twee getallen.

mul(<multiplicand1>, <multiplicand2>)
Parameter Vereist Type Description
<vermenigvuldigd1> Ja Geheel getal of float Het getal dat moet worden vermenigvuldigd met vermenigvuldiging2
<vermenigvuldigd2> Ja Geheel getal of float Het getal dat vermenigvuldigt met vermenigvuldiging1
Retourwaarde Type Description
<productresultaat> Geheel getal of float Het product van het vermenigvuldigen van het eerste getal met het tweede getal

Voorbeeld

In deze voorbeelden wordt het eerste getal vermenigvuldigd met het tweede getal:

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

En retourneer deze resultaten:

  • Eerste voorbeeld: 2
  • Tweede voorbeeld 3

not

Controleer of een expressie onwaar is. Retourneer waar wanneer de expressie onwaar is of retourneer onwaar als waar.

not(<expression>)
Parameter Vereist Type Description
<Expressie> Ja Booleaanse waarde De expressie die moet worden gecontroleerd
Retourwaarde Type Description
waar of onwaar Booleaanse waarde Retourneer waar wanneer de expressie onwaar is. Retourneer onwaar wanneer de expressie waar is.

Voorbeeld 1

Deze voorbeelden controleren of de opgegeven expressies onwaar zijn:

not(false)
not(true)

En retourneer deze resultaten:

  • Eerste voorbeeld: De expressie is onwaar, dus de functie retourneert true.
  • Tweede voorbeeld: De expressie is waar, dus de functie retourneert false.

Voorbeeld 2

Deze voorbeelden controleren of de opgegeven expressies onwaar zijn:

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

En retourneer deze resultaten:

  • Eerste voorbeeld: De expressie is onwaar, dus de functie retourneert true.
  • Tweede voorbeeld: De expressie is waar, dus de functie retourneert false.

or

Controleer of ten minste één expressie waar is. Retourneer waar wanneer ten minste één expressie waar is of retourneer onwaar als beide onwaar zijn.

or(<expression1>, <expression2>)
Parameter Vereist Type Description
<expressie1>, <expressie2> Ja Booleaanse waarde De expressies die moeten worden gecontroleerd
Retourwaarde Type Description
waar of onwaar Booleaanse waarde Retourneert waar wanneer ten minste één expressie waar is. Retourneer onwaar wanneer beide expressies onwaar zijn.

Voorbeeld 1

In deze voorbeelden wordt gecontroleerd of ten minste één expressie waar is:

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

En retourneer deze resultaten:

  • Eerste voorbeeld: Ten minste één expressie is waar, dus de functie retourneert true.
  • Tweede voorbeeld: Beide expressies zijn onwaar, dus de functie retourneert false.

Voorbeeld 2

In deze voorbeelden wordt gecontroleerd of ten minste één expressie waar is:

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

En retourneer deze resultaten:

  • Eerste voorbeeld: Ten minste één expressie is waar, dus de functie retourneert true.
  • Tweede voorbeeld: Beide expressies zijn onwaar, dus de functie retourneert false.

rand

Retourneert een willekeurig geheel getal uit een opgegeven bereik. Dit is alleen inclusief aan het begineinde.

rand(<minValue>, <maxValue>)
Parameter Vereist Type Description
<minValue> Ja Geheel getal Het laagste gehele getal in het bereik
<maxValue> Ja Geheel getal Het gehele getal dat volgt op het hoogste gehele getal in het bereik dat door de functie kan worden geretourneerd
Retourwaarde Type Description
<willekeurig resultaat> Geheel getal Het willekeurige gehele getal dat wordt geretourneerd uit het opgegeven bereik. Houd er rekening mee dat elke aanroep van rand() een uniek resultaat resulteert, wat betekent dat de waarde die u in de uitvoerbewaking ziet, mogelijk niet hetzelfde is tijdens de werkelijke uitvoeringstijd.

Voorbeeld

In dit voorbeeld wordt een willekeurig geheel getal opgehaald uit het opgegeven bereik, met uitzondering van de maximumwaarde:

rand(1, 5)

En retourneert een van deze getallen als resultaat: 1, 2, of 34

range

Retourneert een matrix met gehele getallen die begint met een opgegeven geheel getal.

range(<startIndex>, <count>)
Parameter Vereist Type Description
<Startindex> Ja Geheel getal Een geheel getal dat de matrix start als het eerste item
<count> Ja Geheel getal Het aantal gehele getallen in de matrix
Retourwaarde Type Description
[<bereikresultaat>] Matrix De matrix met gehele getallen die beginnen met de opgegeven index

Voorbeeld

In dit voorbeeld wordt een matrix met gehele getallen gemaakt die begint met de opgegeven index en het opgegeven aantal gehele getallen heeft:

range(1, 4)

En retourneert dit resultaat: [1, 2, 3, 4]

replace

Vervang een subtekenreeks door de opgegeven tekenreeks en retourneer de resultaattekenreeks. Deze functie is hoofdlettergevoelig.

replace('<text>', '<oldText>', '<newText>')
Parameter Vereist Type Beschrijving
<tekst> Ja String De tekenreeks met de subtekenreeks die moet worden vervangen
<oldText> Ja String De subtekenreeks die moet worden vervangen
<newText> Ja String De vervangende tekenreeks
Retourwaarde Type Description
<bijgewerkte tekst> String De bijgewerkte tekenreeks na het vervangen van de subtekenreeks

Als de subtekenreeks niet wordt gevonden, retourneert u de oorspronkelijke tekenreeks.

Voorbeeld

In dit voorbeeld wordt de subtekenreeks 'oud' in 'de oude tekenreeks' gevonden en wordt 'oud' vervangen door 'nieuw':

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

En retourneert dit resultaat: "the new string"

skip

Verwijder items aan de voorzijde van een verzameling en retourneer alle andere items.

skip([<collection>], <count>)
Parameter Vereist Type Description
<Collectie> Ja Matrix De verzameling waarvan u de items wilt verwijderen
<count> Ja Geheel getal Een positief geheel getal voor het aantal items dat aan de voorzijde moet worden verwijderd
Retourwaarde Type Description
[<bijgewerkte verzameling>] Matrix De bijgewerkte verzameling na het verwijderen van de opgegeven items

Voorbeeld

In dit voorbeeld wordt één item, het getal 0, verwijderd van de voorzijde van de opgegeven matrix:

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

En retourneert deze matrix met de resterende items: [1,2,3]

split

Splits een tekenreeks op elk exemplaar van een opgegeven scheidingsteken en retourneert de resulterende subtekenreeksen als elementen van een matrix. Een scheidingsteken is meestal één teken, maar scheidingstekens met meerdere tekens worden ondersteund.

split('<text>', '<delimiter>')
Parameter Vereist Type Beschrijving
<tekst> Ja String De tekenreeks die moet worden gescheiden in subtekenreeksen
<scheidingsteken> Ja String De tekenreeks die moet worden gebruikt als scheidingsteken
Retourwaarde Type Description
[<subtekenreeks1,subtekenreeks2><>,...] Matrix Een matrix die subtekenreeksen van de oorspronkelijke tekenreeks bevat

Voorbeeld

In dit voorbeeld wordt een matrix geretourneerd met subtekenreeksen van de tekenreeks 'a_b_c' op basis van het scheidingsteken '_':

split('a_b_c', '_')

De geretourneerde matrix is: ["a","b","c"]

startOfDay

Retourneer het begin van de dag voor een tijdstempel.

startOfDay('<timestamp>', '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<bijgewerkte tijdstempel> String De opgegeven tijdstempel, maar beginnend bij de nuluurmarkering voor de dag

Voorbeeld

In dit voorbeeld wordt het begin van de dag voor deze tijdstempel gevonden:

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

En retourneert dit resultaat: "2018-03-15T00:00:00.0000000Z"

startOfHour

Retourneert het begin van het uur voor een tijdstempel.

startOfHour('<timestamp>', '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<bijgewerkte tijdstempel> String De opgegeven tijdstempel, maar beginnend bij de nulminutenmarkering voor het uur

Voorbeeld

In dit voorbeeld wordt het begin van het uur voor deze tijdstempel gevonden:

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

En retourneert dit resultaat: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Retourneer het begin van de maand voor een tijdstempel.

startOfMonth('<timestamp>', '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<bijgewerkte tijdstempel> String De opgegeven tijdstempel, maar beginnend op de eerste dag van de maand op het nuluurmarkering

Voorbeeld

In dit voorbeeld wordt het begin van de maand voor deze tijdstempel geretourneerd:

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

En retourneert dit resultaat: "2018-03-01T00:00:00.0000000Z"

startsWith

Controleer of een tekenreeks begint met een specifieke subtekenreeks. Retourneer waar wanneer de subtekenreeks wordt gevonden of retourneer onwaar wanneer deze niet is gevonden. Deze functie is niet hoofdlettergevoelig.

startsWith('<text>', '<searchText>')
Parameter Vereist Type Beschrijving
<tekst> Ja String De tekenreeks die moet worden gecontroleerd
<searchText> Ja String De begintekenreeks die moet worden gevonden
Retourwaarde Type Description
waar of onwaar Booleaanse waarde Retourneert waar wanneer de beginsubtekenreeks wordt gevonden. Retourneer onwaar wanneer deze niet is gevonden.

Voorbeeld 1

In dit voorbeeld wordt gecontroleerd of de tekenreeks 'hallo wereld' begint met de subtekenreeks 'hallo':

startsWith('hello world', 'hello')

En retourneert dit resultaat: true

Voorbeeld 2

In dit voorbeeld wordt gecontroleerd of de tekenreeks 'hallo wereld' begint met de subtekenreeks 'begroetingen':

startsWith('hello world', 'greetings')

En retourneert dit resultaat: false

tekenreeks

Retourneert de tekenreeksversie voor een waarde.

string(<value>)
Parameter Vereist Type Description
<value> Ja Alle De waarde die moet worden geconverteerd
Retourwaarde Type Description
<tekenreekswaarde> String De tekenreeksversie voor de opgegeven waarde

Voorbeeld 1

In dit voorbeeld wordt de tekenreeksversie voor dit getal gemaakt:

string(10)

En retourneert dit resultaat: "10"

Voorbeeld 2

In dit voorbeeld wordt een tekenreeks gemaakt voor het opgegeven JSON-object en wordt het backslash-teken (\) gebruikt als een escape-teken voor het dubbele aanhalingsteken (").

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

En retourneert dit resultaat: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

Retourneer het resultaat van het aftrekken van één getal van een ander getal.

sub(<minuend>, <subtrahend>)
Parameter Vereist Type Description
<minuend> Ja Geheel getal of float Het getal van waaruit het aftrekken moet worden afgetrokken
<aftrekken> Ja Geheel getal of float Het getal dat moet worden afgetrokken van de minuend
Retourwaarde Type Omschrijving
<Resultaat> Geheel getal of float Het resultaat van het aftrekken van het tweede getal van het eerste getal

Voorbeeld

In dit voorbeeld wordt het tweede getal afgetrokken van het eerste getal:

sub(10.3, .3)

En retourneert dit resultaat: 10

Subtekenreeks

Retourneert tekens uit een tekenreeks, beginnend vanaf de opgegeven positie of index. Indexwaarden beginnen met het getal 0.

substring('<text>', <startIndex>, <length>)
Parameter Vereist Type Beschrijving
<tekst> Ja String De tekenreeks waarvan u de tekens wilt
<Startindex> Ja Geheel getal Een positief getal dat gelijk is aan of groter is dan 0 dat u wilt gebruiken als de beginpositie of indexwaarde
<length> Ja Geheel getal Een positief aantal tekens dat u in de subtekenreeks wilt opnemen
Retourwaarde Type Description
<subtekenreeksresultaat> String Een subtekenreeks met het opgegeven aantal tekens, beginnend bij de opgegeven indexpositie in de brontekenreeks

Voorbeeld

In dit voorbeeld wordt een subtekenreeks van vijf tekens gemaakt op basis van de opgegeven tekenreeks, te beginnen met de indexwaarde 6:

substring('hello world', 6, 5)

En retourneert dit resultaat: "world"

aftrekkenFromTime

Trek een aantal tijdseenheden af van een tijdstempel. Zie ook getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks die de tijdstempel bevat
<interval> Ja Geheel getal Het aantal opgegeven tijdseenheden dat moet worden afgetrokken
<timeUnit> Ja String De tijdseenheid die moet worden gebruikt met interval: 'Seconde', 'Minuut', 'Uur', 'Dag', 'Week', 'Maand', 'Jaar'
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<bijgewerkte tijdstempel> String Het tijdstempel minus het opgegeven aantal tijdseenheden

Voorbeeld 1

In dit voorbeeld wordt één dag afgetrokken van deze tijdstempel:

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

En retourneert dit resultaat: "2018-01-01T00:00:00:0000000Z"

Voorbeeld 2

In dit voorbeeld wordt één dag afgetrokken van deze tijdstempel:

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

En retourneert dit resultaat met de optionele D-indeling: "Monday, January, 1, 2018"

take

Items retourneren van de voorzijde van een verzameling.

take('<collection>', <count>)
take([<collection>], <count>)
Parameter Vereist Type Description
<Collectie> Ja Tekenreeks of matrix De verzameling waarvan u de gewenste items wilt
<count> Ja Geheel getal Een positief geheel getal voor het gewenste aantal items aan de voorzijde
Retourwaarde Type Description
<subset> of [<subset>] Tekenreeks of matrix, respectievelijk Een tekenreeks of matrix met het opgegeven aantal items dat afkomstig is van de voorzijde van de oorspronkelijke verzameling

Voorbeeld

In deze voorbeelden ziet u het opgegeven aantal items aan de voorzijde van deze verzamelingen:

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

En retourneer deze resultaten:

  • Eerste voorbeeld: "abc"
  • Tweede voorbeeld: [0, 1, 2]

Teken

Retourneert de ticks eigenschapswaarde voor een opgegeven tijdstempel. Een maatstreepje is een interval van 100 nanoseconden.

ticks('<timestamp>')
Parameter Vereist Type Description
<Tijdstempel> Ja String De tekenreeks voor een tijdstempel
Retourwaarde Type Description
<maatstreepjes-getal> Geheel getal Het aantal tikken dat is verstreken sinds 12:00:00 middernacht, 1 januari 0001 in de Gregoriaanse kalender sinds de tijdstempel van invoer

toLower

Retourneert een tekenreeks in kleine letters. Als een teken in de tekenreeks geen kleine letterversie heeft, blijft dat teken ongewijzigd in de geretourneerde tekenreeks.

toLower('<text>')
Parameter Vereist Type Beschrijving
<tekst> Ja String De tekenreeks die moet worden geretourneerd in kleine letters
Retourwaarde Type Description
<kleine letters> String De oorspronkelijke tekenreeks in kleine letters

Voorbeeld

In dit voorbeeld wordt deze tekenreeks geconverteerd naar kleine letters:

toLower('Hello World')

En retourneert dit resultaat: "hello world"

Toupper

Retourneert een tekenreeks in hoofdletters. Als een teken in de tekenreeks geen hoofdletterversie heeft, blijft dat teken ongewijzigd in de geretourneerde tekenreeks.

toUpper('<text>')
Parameter Vereist Type Beschrijving
<tekst> Ja String De tekenreeks die moet worden geretourneerd in hoofdletters
Retourwaarde Type Description
<hoofdletters/tekst> String De oorspronkelijke tekenreeks in hoofdletters

Voorbeeld

In dit voorbeeld wordt deze tekenreeks geconverteerd naar hoofdletters:

toUpper('Hello World')

En retourneert dit resultaat: "HELLO WORLD"

trim

Verwijder voorloop- en volgspaties uit een tekenreeks en retourneer de bijgewerkte tekenreeks.

trim('<text>')
Parameter Vereist Type Beschrijving
<tekst> Ja String De tekenreeks met de voorloop- en volgspaties die u wilt verwijderen
Retourwaarde Type Description
<updatedText> String Een bijgewerkte versie voor de oorspronkelijke tekenreeks zonder voorloop- of volgspaties

Voorbeeld

In dit voorbeeld wordt de voorloop- en volgspaties verwijderd uit de tekenreeks " Hallo wereld ":

trim(' Hello World  ')

En retourneert dit resultaat: "Hello World"

union

Hiermee wordt een verzameling geretourneerd die alle items uit de opgegeven verzamelingen bevat. Als u het resultaat wilt weergeven, kan een item worden weergegeven in elke verzameling die aan deze functie is doorgegeven. Als een of meer items dezelfde naam hebben, wordt het laatste item met die naam weergegeven in het resultaat.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parameter Vereist Type Description
<collection1>, <collection2>, ... Ja Matrix of object, maar niet beide De verzamelingen van waaruit u alle items wilt
Retourwaarde Type Description
<updatedCollection> Matrix of object, respectievelijk Een verzameling met alle items uit de opgegeven verzamelingen - geen duplicaten

Voorbeeld

In dit voorbeeld worden alle items uit deze verzamelingen opgehaald:

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

En retourneert dit resultaat: [1, 2, 3, 10, 101]

uriComponent

Retourneert een URI-gecodeerde versie (Uniform Resource Identifier) voor een tekenreeks door URL-onveilige tekens te vervangen door escapetekens. Gebruik deze functie in plaats van encodeUriComponent(). Hoewel beide functies op dezelfde manier werken, uriComponent() heeft dit de voorkeur.

uriComponent('<value>')
Parameter Vereist Type Description
<value> Ja String De tekenreeks die moet worden geconverteerd naar een URI-gecodeerde indeling
Retourwaarde Type Description
<gecodeerde-URI> String De tekenreeks met URI-codering met escapetekens

Voorbeeld

In dit voorbeeld wordt een URI-gecodeerde versie voor deze tekenreeks gemaakt:

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

En retourneert dit resultaat: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Retourneert de binaire versie voor een URI-onderdeel (Uniform Resource Identifier).

uriComponentToBinary('<value>')
Parameter Vereist Type Description
<value> Ja String De URI-gecodeerde tekenreeks die moet worden geconverteerd
Retourwaarde Type Description
<binary-for-encoded-uri> String De binaire versie voor de URI-gecodeerde tekenreeks. De binaire inhoud is base64-gecodeerd en vertegenwoordigd door $content.

Voorbeeld

In dit voorbeeld wordt de binaire versie voor deze URI-gecodeerde tekenreeks gemaakt:

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

En retourneert dit resultaat:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Retourneert de tekenreeksversie voor een URI-gecodeerde tekenreeks (Uniform Resource Identifier), waardoor de URI-gecodeerde tekenreeks effectief wordt gedecodeerd.

uriComponentToString('<value>')
Parameter Vereist Type Description
<value> Ja String De tekenreeks met URI-codering om te decoderen
Retourwaarde Type Description
<decoderen-URI> String De gedecodeerde versie voor de URI-gecodeerde tekenreeks

Voorbeeld

In dit voorbeeld wordt de gedecodeerde tekenreeksversie gemaakt voor deze URI-gecodeerde tekenreeks:

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

En retourneert dit resultaat: "https://contoso.com"

utcNow

Retourneer de huidige tijdstempel.

utcNow('<format>')

U kunt desgewenst een andere indeling opgeven met de <notatieparameter>.

Parameter Vereist Type Description
<format> Nee String Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
Retourwaarde Type Description
<current-timestamp> String De huidige datum en tijd

Voorbeeld 1

Stel dat vandaag 15 april 2018 om 13:00:00 uur is. In dit voorbeeld wordt de huidige tijdstempel opgehaald:

utcNow()

En retourneert dit resultaat: "2018-04-15T13:00:00.0000000Z"

Voorbeeld 2

Stel dat vandaag 15 april 2018 om 13:00:00 uur is. In dit voorbeeld wordt de huidige tijdstempel opgehaald met behulp van de optionele D-indeling:

utcNow('D')

En retourneert dit resultaat: "Sunday, April 15, 2018"

xml

Retourneert de XML-versie voor een tekenreeks die een JSON-object bevat.

xml('<value>')
Parameter Vereist Type Description
<value> Ja String De tekenreeks met het JSON-object dat moet worden geconverteerd

Het JSON-object mag slechts één hoofdeigenschap hebben. Dit kan geen matrix zijn.
Gebruik het backslashteken (\) als escapeteken voor het dubbele aanhalingsteken (").

Retourwaarde Type Description
<xml-version> Object De gecodeerde XML voor de opgegeven tekenreeks of JSON-object

Voorbeeld 1

In dit voorbeeld wordt de XML-versie voor deze tekenreeks gemaakt, die een JSON-object bevat:

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

En retourneert dit resultaat-XML:

<name>Sophia Owen</name>

Voorbeeld 2

Stel dat u dit JSON-object hebt:

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

In dit voorbeeld wordt XML gemaakt voor een tekenreeks die dit JSON-object bevat:

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

En retourneert dit resultaat-XML:

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

Xpath

Controleer XML op knooppunten of waarden die overeenkomen met een XPath-expressie (XML Path Language) en retourneer de overeenkomende knooppunten of waarden. Met een XPath-expressie of alleen XPath kunt u navigeren in een XML-documentstructuur, zodat u knooppunten of rekenwaarden in de XML-inhoud kunt selecteren.

xpath('<xml>', '<xpath>')
Parameter Vereist Type Description
<xml> Ja Alle De XML-tekenreeks om te zoeken naar knooppunten of waarden die overeenkomen met een XPath-expressiewaarde
<Xpath> Ja Alle De XPath-expressie die wordt gebruikt om overeenkomende XML-knooppunten of -waarden te vinden
Retourwaarde Type Description
<xml-node> XML Een XML-knooppunt wanneer slechts één knooppunt overeenkomt met de opgegeven XPath-expressie
<value> Alle De waarde van een XML-knooppunt wanneer slechts één waarde overeenkomt met de opgegeven XPath-expressie
[<xml-node1>, <xml-node2>, ...]
-or-
[<waarde1>, <waarde2>, ...]
Matrix Een matrix met XML-knooppunten of -waarden die overeenkomen met de opgegeven XPath-expressie

Voorbeeld 1

Hieronder vindt u in voorbeeld 1 knooppunten die overeenkomen met het <count></count> knooppunt en voegt u deze knooppuntwaarden toe met de sum() functie:

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

En retourneert dit resultaat: 30

Voorbeeld 2

Voor dit voorbeeld zoeken beide expressies knooppunten die overeenkomen met het <location></location> knooppunt, in de opgegeven argumenten, waaronder XML met een naamruimte. De expressies gebruiken het backslashteken (\) als escapeteken voor het dubbele aanhalingsteken (").

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

Dit zijn de argumenten:

  • Deze XML, die de XML-documentnaamruimte bevat, xmlns="http://contoso.com":

    <?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>
    
  • Hier kunt u een XPath-expressie gebruiken:

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

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

Dit is het resultaatknooppunt dat overeenkomt met het <location></location> knooppunt:

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

Voorbeeld 3

Hieronder vindt u in voorbeeld 3 in dit voorbeeld de waarde in het <location></location> knooppunt:

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

En retourneert dit resultaat: "Paris"

Notitie

U kunt opmerkingen toevoegen aan expressies voor gegevensstromen, maar niet in pijplijnexpressies.

Zie Systeemvariabelen voor een lijst met systeemvariabelen die u in expressies kunt gebruiken.