Expressies en functies in Azure Data Factory en Azure Synapse Analytics

Artikel
05/17/2024

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"

"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.

Datum toevoegen aan een bestandsnaam: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
Datum/tijd toevoegen in de tijdzone van de klant: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
Triggertijd toevoegen: @concat('Test_', pipeline().TriggerTime)
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:

URL-codering op basis van de oorspronkelijke tekenreekswaarde
Vervang de tekenreeks met URL-codering, bijvoorbeeld regelfeed (%0A), regelterugloop (%0D), horizontaal tabblad (%09).
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 in pijplijnen gebruiken de enkele aanhalingstekens (') om parameters voor tekenreekswaarden te plaatsen. Gebruik twee opeenvolgende enkele aanhalingstekens in een pijplijntekenreeksexpressie om één aanhalingsteken op te nemen. Hier volgt een voorbeeld: de expressie @concat('Here is a double quote character: ". ', 'And here is a single quote character all within the same string: ''.') retourneert het volgende resultaat:

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

In expressies voor gegevensstromen wordt deze syntaxis echter niet ondersteund. In plaats daarvan kunnen expressies voor gegevensstromen tussen enkele of dubbele aanhalingstekens worden geplaatst. Plaats tekst tussen enkele aanhalingstekens binnen dubbele aanhalingstekens en tekst die dubbele aanhalingstekens binnen enkele aanhalingstekens vereist, binnen tekenreeksfuncties. Als u een tekenreeks met zowel enkele als dubbele aanhalingstekens nodig hebt, kunt u twee concat() subtekenreeksen samenvoegen die elk enkele aanhalingstekens of dubbele aanhalingstekens bevatten. Het gegevensstroomequivalent van het vorige voorbeeld van de pijplijnexpressie zou zijn concat('Here is a double quote character: ". ', "And here is a single quote character all within the same string: '."). In een gegevensstroom retourneert die expressie hetzelfde resultaat als het vorige voorbeeld voor pijplijnexpressies.

`Tutorial`

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.

Functies

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.
kruispunt	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.
binair	Retourneert de binaire versie voor een invoerwaarde.
bool	Retourneert de Boole-versie voor een invoerwaarde.
samensmelten	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.
drijven	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.
snaar	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"

`and`

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.

`array`

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"

`binary`

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

`coalesce`

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"

`contains`

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:

`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.

`first`

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

`float`

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
<uitdrukking>	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"
      } ]
   }
}

`intersection`

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"

`last`

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
<uitdrukking>	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

`string`

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

`substring`

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"

`subtractFromTime`

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]

`ticks`

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.

Delen via

Expressies en functies in Azure Data Factory en Azure Synapse Analytics

Expressies

Voorbeelden

Voorbeeld van complexe expressie

Dynamische inhoudseditor

Een gegevensset met een parameter

Een pijplijn met een parameter

Speciale tekens vervangen

Eén aanhalingsteken ontsnappen

Tutorial

Functies

Datumfuncties

Tekenreeksfuncties

Verzamelingsfuncties

Logische functies

Conversiefuncties

Wiskundige functies

Referentie voor functies

add

addDays

addHours

addMinutes

addSeconds

addToTime

and

array

base64

base64ToBinary

base64ToString

binary

bool

coalesce

concat

contains

convertFromUtc

convertTimeZone

convertToUtc

createArray

dataUri

dataUriToBinary

dataUriToString

dayOfMonth

dayOfWeek

dayOfYear

decoderenBase64

decodeDataUri

decodeUriComponent

div

encodeUriComponent

empty

endsWith

equals

first

float

formatDateTime

getFutureTime

getPastTime

greater

greaterOrEquals

guid

if

indexOf

int

json

intersection

join

last

lastIndexOf

length

less

lessOrEquals

max

min

mod

mul

not

or

rand

range

`Tutorial`

`add`

`addDays`

`addHours`

`addMinutes`

`addSeconds`

`addToTime`

`and`

`array`

`binary`

`bool`

`coalesce`

`concat`

`contains`

`convertFromUtc`

`convertTimeZone`

`convertToUtc`

`createArray`

`dataUri`

`dataUriToBinary`

`dataUriToString`

`dayOfMonth`

`dayOfWeek`

`dayOfYear`

`decodeDataUri`

`decodeUriComponent`

`div`

`encodeUriComponent`

`empty`

`endsWith`

`equals`

`first`

`float`

`formatDateTime`

`getFutureTime`

`getPastTime`

`greater`

`greaterOrEquals`

`guid`

`if`

`indexOf`

`int`

`json`

`intersection`

`join`

`last`

`lastIndexOf`

`length`

`less`

`lessOrEquals`

`max`

`min`

`mod`

`mul`

`not`

`or`

`rand`

`range`

`replace`

`skip`

`split`

`startOfDay`

`startOfHour`

`startOfMonth`

`startsWith`

`string`

`sub`

`substring`

`subtractFromTime`

`take`

`ticks`

`toLower`

`toUpper`

`trim`

`union`

`uriComponent`

`uriComponentToBinary`

`uriComponentToString`

`utcNow`

`xml`