Freigeben über


Ausdrücke und Funktionen in Azure Data Factory und Azure Synapse Analytics

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

Dieser Artikel enthält Informationen zu Ausdrücken und Funktionen, die in Azure Data Factory und Azure Synapse Analytics unterstützt werden.

Ausdrücke

Bei den JSON-Werten in der Definition kann es sich um Literalwerte oder um Ausdrücke handeln, die zur Laufzeit ausgewertet werden. Beispiel:

"name": "value"

oder

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

Ausdrücke können an beliebiger Stelle in einem JSON-Zeichenfolgenwert verwendet werden und ergeben immer einen anderen JSON-Wert. Wenn ein JSON-Wert ein Ausdruck ist, wird der Text des Ausdrucks durch Entfernen des @-Zeichens extrahiert. Falls Sie ein Zeichenfolgenliteral benötigen, das mit @ beginnt, muss es wie folgt mit einem Escapezeichen versehen werden: @@. Die folgenden Beispiele veranschaulichen die Auswertung von Ausdrücken.

JSON-Wert Ergebnis
"parameters" Die Zeichenfolge „parameters“ wird zurückgegeben.
"parameters[1]" Die Zeichenfolge „parameters[1]“ wird zurückgegeben.
"@@" Eine Zeichenfolge, die \„\@\“ enthält, wird zurückgegeben (einzelnes Zeichen).
" @" Eine Zeichenfolge, die \„ \@ \“ enthält, wird zurückgegeben (zwei Zeichen).

Mit der Zeichenfolgeninterpolation können Ausdrücke auch innerhalb von Zeichenfolgen verwendet werden. Dabei werden die Ausdrücke in @{ ... } eingeschlossen. Beispiel: "name" : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Bei der Verwendung einer Zeichenfolgeninterpolation ist das Ergebnis immer eine Zeichenfolge. Angenommen, ich habe myNumber als 42 und myString als foo definiert:

JSON-Wert Ergebnis
"@pipeline().parameters.myString" Gibt foo als Zeichenfolge zurück.
"@{pipeline().parameters.myString}" Gibt foo als Zeichenfolge zurück.
"@pipeline().parameters.myNumber" Gibt 42 als Zahl zurück.
"@{pipeline().parameters.myNumber}" Gibt 42 als Zeichenfolge zurück.
"Answer is: @{pipeline().parameters.myNumber}" Gibt die Zeichenfolge Answer is: 42 zurück.
"@concat('Answer is: ', string(pipeline().parameters.myNumber))" Gibt die Zeichenfolge Answer is: 42 zurück.
"Answer is: @@{pipeline().parameters.myNumber}" Gibt die Zeichenfolge Answer is: @{pipeline().parameters.myNumber} zurück.

In Ablaufsteuerungsaktivitäten wie der ForEach-Aktivität können Sie ein Array angeben, das für die Eigenschaftselemente durchlaufen werden soll. Darüber hinaus können Sie @item() verwenden, um eine einzelne Enumeration in der ForEach-Aktivität zu durchlaufen. Beispiel: Wenn items ein Array wie [1, 2, 3] ist, gibt @item() in der ersten Iteration 1 zurück, in der zweiten Iteration 2 und in der dritten Iteration 3. Sie können @range(0,10) den auch „Gefällt mir“ Ausdruck verwenden, um zehnmal zu iterieren, beginnend mit 0 bis 9.

Mit @activity(('Name_der_Aktivität') können Sie die Ausgabe der Aktivität erfassen und Entscheidungen treffen. Betrachten wir als Beispiel eine Webaktivität namens Web1. Um die Ausgabe der ersten Aktivität im Text der zweiten zu platzieren, sieht der Ausdruck im Allgemeinen so aus: „@activity(('Web1').output“ oder „@activity(('Web1').output.data“. Der tatsächliche Ausdruck richtet sich hierbei nach der Ausgabe der ersten Aktivität.

Beispiele

Beispiel für komplexen Ausdruck

Das folgende Beispiel zeigt einen komplexen Ausdruck, der auf ein tiefes Unterfeld der Aktivitätsausgabe verweist. Wenn Sie auf einen Pipelineparameter verweisen möchten, der als untergeordnetes Feld ausgewertet wird, verwenden Sie als Teil der Aktivitätsausgabe anstelle des Operators „dot(.)“ die []-Syntax (wie bei „subfield1“ und „subfield2“).

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

Das dynamische Erstellen und Benennen von Dateien ist ein gängiges Muster. Sehen wir uns einige Beispiele für die dynamische Dateibenennung an.

  1. Anfügen des Datums an einen Dateinamen: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))

  2. Anfügen eines DateTime-Werts in der Zeitzone des Kunden: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))

  3. Anfügen eines TriggerTime-Werts: @concat('Test_', pipeline().TriggerTime)

  4. Ausgabe eines benutzerdefinierten Dateinamens in einem Zuordnungsdatenfluss bei Ausgabe einer Einzeldatei mit Datum: 'Test_' + toString(currentDate()) + '.csv'

In den obigen Fällen werden vier dynamische Dateinamen erstellt, die mit „Test_“ beginnen.

Editor für dynamische Inhalte

Der Editor für dynamische Inhalte versieht automatisch Zeichen in ihrem Inhalt mit Escapezeichen, wenn die Bearbeitung abgeschlossen ist. Der folgende Inhalt im Inhalts-Editor ist z. B. eine Zeichenfolgeninterpolation mit zwei Ausdrucksfunktionen.

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

Der Editor für dynamische Inhalte konvertiert oben Inhalt in einen Ausdruck "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}". Das Ergebnis dieses Ausdrucks ist eine Zeichenfolge im JSON-Format, die unten gezeigt wird.

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

Ein Dataset mit einem Parameter

Im folgenden Beispiel nutzt „BlobDataset“ einen Parameter namens path. Der Wert wird unter Verwendung des folgenden Ausdrucks zum Festlegen eines Werts für die Eigenschaft folderPath verwendet: dataset().path.

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

Eine Pipeline mit einem Parameter

Im folgenden Beispiel nutzt die Pipeline die Parameter inputPath und outputPath. Der Parameter path für das parametrisierte Blobdataset wird mithilfe der Werte dieser Parameter festgelegt. Die hier verwendete Syntax lautet 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"
            }
        }
    }
}

Ersetzen von Sonderzeichen

Nach der Bearbeitung versieht der Editor für dynamische Inhalte Zeichen wie doppelte Anführungszeichen und umgekehrte Schrägstriche in Ihrem Inhalt automatisch mit Escapezeichen. Dies führt zu Problemen, wenn Sie einen Zeilenvorschub oder Tabulator mithilfe von \n bzw. \t in der replace()-Funktion ersetzen möchten. Sie können Ihren dynamischen Inhalt in der Codeansicht bearbeiten, um das zusätzliche \-Zeichen im Ausdruck zu entfernen, oder die folgenden Schritte ausführen, um Sonderzeichen mithilfe der Ausdruckssprache zu ersetzen:

  1. URL-Codierung für den ursprünglichen Zeichenfolgenwert
  2. Ersetzen der URL-codierten Zeichenfolge, z. B. Zeilenvorschub (%0A), Wagenrücklauf (%0D), horizontaler Tabulator (%09)
  3. URL-Decodierung

Beispielsweise kann bei der Variablen companyName mit einem Zeilenumbruchzeichen im Wert mithilfe des Ausdrucks @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) das Zeilenumbruchzeichen entfernt werden.

Contoso-
Corporation

Versehen eines einfachen Anführungszeichens mit Escapezeichen

Ausdrucksfunktionen in Pipelines verwenden das einfache Anführungszeichen ('), um Zeichenfolgenwertparameter einzuschließen. Verwenden Sie zwei aufeinander folgende einfache Anführungszeichen in einem Pipelinezeichenfolgenausdruck, um ein einzelnes Anführungszeichen einzuschließen. Nachfolgend sehen Sie ein Beispiel: Der Ausdruck @concat('Here is a double quote character: ". ', 'And here is a single quote character all within the same string: ''.') gibt das folgende Ergebnis zurück:

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

In Datenflussausdrücken wird diese Syntax jedoch nicht unterstützt. Stattdessen können Datenflussausdrücke von einfachen oder doppelten Anführungszeichen umgeben werden. Schließen Sie Text ein, der einfache Anführungszeichen in doppelte Anführungszeichen erfordert, und Text, der doppelte Anführungszeichen innerhalb einzelner Anführungszeichen innerhalb von Zeichenfolgenfunktionen erfordert. Wenn Sie eine Zeichenfolge mit einfachen und doppelten Anführungszeichen benötigen, können concat() Sie zwei Teilzeichenfolgen zusammenführen, die jeweils einzelne Anführungszeichen oder doppelte Anführungszeichen enthalten. Das Datenflussäquivalent des vorherigen Pipelineausdrucksbeispiels wäre concat('Here is a double quote character: ". ', "And here is a single quote character all within the same string: '."). In einem Datenfluss gibt dieser Ausdruck dasselbe Ergebnis wie das vorherige Beispiel für Pipelineausdrücke zurück.

Tutorial

In diesem Tutorial erfahren Sie, wie Sie Parameter zwischen einer Pipeline und einer Aktivität sowie zwischen den Aktivitäten übergeben können. Das Tutorial zeigt insbesondere die Schritte für Azure Data Factory, obwohl die Schritte für einen Synapse-Arbeitsbereich fast gleich sind, jedoch mit einer etwas anderen Benutzeroberfläche.

Functions

Sie können Funktionen innerhalb von Ausdrücken aufrufen. Die folgenden Abschnitte enthalten Informationen zu den Funktionen, die in einem Ausdruck verwendet werden können.

Datumsfunktionen

Datums- oder Zeitfunktion Aufgabe
addDays Fügt eine Anzahl von Tagen zu einem Zeitstempel hinzu.
addHours Fügt eine Anzahl von Stunden zu einem Zeitstempel hinzu.
addMinutes Fügt eine Anzahl von Minuten zu einem Zeitstempel hinzu.
addSeconds Fügt eine Anzahl von Sekunden zu einem Zeitstempel hinzu.
addToTime Fügt eine Anzahl von Zeiteinheiten zu einem Zeitstempel hinzu. Siehe auch getFutureTime.
convertFromUtc Konvertiert einen Zeitstempel von der UTC-Zeitzone (UTC = Universal Time, Coordinated) in die Zielzeitzone.
convertTimeZone Konvertiert einen Zeitstempel von der Quellzeitzone in die Zielzeitzone.
convertToUtc Konvertiert einen Zeitstempel von der Quellzeitzone in die UTC-Zeitzone (UTC = Universal Time, Coordinated).
dayOfMonth Gibt den Tag der Monatskomponente eines Zeitstempels zurück.
dayOfWeek Gibt den Tag der Wochenkomponente eines Zeitstempels zurück.
dayOfYear Gibt den Tag der Jahreskomponente eines Zeitstempels zurück.
formatDateTime Gibt den Zeitstempel als Zeichenfolge in optionalem Format zurück.
getFutureTime Gibt den aktuellen Zeitstempel plus der angegebenen Zeiteinheiten zurück. Siehe auch addToTime.
getPastTime Gibt den aktuellen Zeitstempel abzüglich der angegebenen Zeiteinheiten zurück. Siehe auch subtractFromTime.
startOfDay Gibt den Beginn des Tages für einen Zeitstempel zurück.
startOfHour Gibt den Beginn der Stunde für einen Zeitstempel zurück.
startOfMonth Gibt den Beginn des Monats für einen Zeitstempel zurück.
subtractFromTime Subtrahiert eine Anzahl von Zeiteinheiten von einem Zeitstempel. Siehe auch getPastTime.
ticks Gibt den Eigenschaftswert ticks für einen angegebenen Zeitstempel zurück.
utcNow Gibt den aktuellen Zeitstempel als Zeichenfolge zurück.

Zeichenfolgenfunktionen

Für die Arbeit mit Zeichenfolgen können Sie folgende Zeichenfolgenfunktionen und auch einige Sammlungsfunktionen verwenden. Zeichenfolgenfunktionen können nur in Zeichenfolgen verwendet werden.

Zeichenfolgenfunktion Aufgabe
concat Kombiniert mindestens zwei Zeichenfolgen miteinander und gibt die kombinierte Zeichenfolge zurück.
endsWith Überprüft, ob eine Zeichenfolge mit der angegebenen Teilzeichenfolge endet.
guid Generiert einen global eindeutigen Bezeichner (Globally Unique Identifier, GUID) als Zeichenfolge.
indexOf Gibt die Anfangsposition für eine Teilzeichenfolge zurück.
lastIndexOf Gibt die Anfangsposition des letzten Vorkommens einer Teilzeichenfolge zurück.
replace Ersetzt eine Teilzeichenfolge durch die angegebene Zeichenfolge und gibt die aktualisierte Zeichenfolge zurück.
split Teilt eine Zeichenfolge bei jedem Vorkommen eines angegebenen Trennzeichens, wobei die resultierenden Teilzeichenfolgen als Elemente eines Arrays zurückgegeben werden.
startsWith Überprüft, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge beginnt.
substring Gibt Zeichen aus einer Zeichenfolge zurück, beginnend mit der angegebenen Position.
toLower Gibt eine Zeichenfolge in Kleinbuchstaben zurück.
toUpper Gibt eine Zeichenfolge in Großbuchstaben zurück.
trim Entfernt führende und nachfolgende Leerzeichen aus einer Zeichenfolge und gibt die aktualisierte Zeichenfolge zurück.

Auflistungsfunktionen

Für die Arbeit mit Sammlungen (in der Regel Arrays, Zeichenfolgen und manchmal auch Bibliotheken) können Sie folgende Sammlungsfunktionen verwenden.

Sammlungsfunktion Aufgabe
contains Überprüft, ob eine Sammlung ein bestimmtes Element enthält.
empty Überprüft, ob eine Sammlung leer ist.
first Gibt das erste Element aus einer Sammlung zurück.
intersection Gibt eine Sammlung zurück, die nur die gängigen Elemente aus den angegebenen Sammlungen enthält.
join Gibt eine Zeichenfolge zurück, die alle Elemente aus einem Array enthält, getrennt durch das angegebene Zeichen.
last Gibt das letzte Element aus einer Sammlung zurück.
length Gibt die Anzahl der Elemente in einer Zeichenfolge oder einem Array zurück.
skip Entfernt Elemente vom Anfang einer Sammlung und gibt alle anderen Elemente zurück.
take Gibt Elemente vom Anfang einer Sammlung zurück.
union Gibt eine Sammlung zurück, die sämtliche Elemente aus den angegebenen Sammlungen enthält.

Logische Funktionen

Diese Funktionen können innerhalb von Bedingungen zur Auswertung einer beliebigen Art von Logik verwendet werden.

Logische Vergleichsfunktion Aufgabe
und Überprüft, ob für sämtliche Ausdrücke der Wert „TRUE“ festgelegt ist.
equals Überprüft, ob beide Werte identisch sind.
greater Überprüft, ob der erste Wert größer als der zweite ist.
greaterOrEquals Überprüft, ob der erste Wert größer als oder gleich dem zweiten ist.
if Überprüft, ob ein Ausdruck gleich „true“ oder „false“ ist. Gibt abhängig vom Ergebnis einen angegebenen Wert zurück.
less Überprüft, ob der erste Wert kleiner als der zweite ist.
lessOrEquals Überprüft, ob der erste Wert kleiner als oder gleich dem zweiten ist.
not Überprüft, ob ein Ausdruck gleich „false“ ist.
or Überprüft, ob mindestens ein Ausdruck gleich „true“ ist.

Konvertierungsfunktionen

Diese Funktionen dienen zum Konvertieren zwischen den einzelnen nativen Typen in der Sprache:

  • Zeichenfolge
  • integer
  • float
  • boolean
  • Arrays
  • Wörterbücher
Konvertierungsfunktion Aufgabe
array Gibt ein Array aus einer einzelnen angegebenen Eingabe zurück. Für mehrere Eingaben siehe createArray.
base64 Gibt die base64-codierte Version für eine Zeichenfolge zurück.
base64ToBinary Gibt die Binärversion für eine base64-codierte Zeichenfolge zurück.
base64ToString Gibt die Zeichenfolgenversion für eine base64-codierte Zeichenfolge zurück.
binary Gibt die Binärversion für einen Eingabewert zurück.
bool Gibt die Version des booleschen Werts für einen Eingabewert zurück.
coalesce Gibt den ersten Wert ungleich NULL aus mindestens einem Parameter zurück.
createArray Gibt ein Array aus mehreren Eingaben zurück.
dataUri Gibt den Daten-URI für einen Eingabewert zurück.
dataUriToBinary Gibt die Binärversion für einen Daten-URI zurück.
dataUriToString Gibt die Zeichenfolgenversion für einen Daten-URI zurück.
decodeBase64 Gibt die Zeichenfolgenversion für eine base64-codierte Zeichenfolge zurück.
decodeDataUri Gibt die Binärversion für einen Daten-URI zurück.
decodeUriComponent Gibt eine Zeichenfolge zurück, in der Escapezeichen durch decodierte Versionen ersetzt sind.
encodeUriComponent Gibt eine Zeichenfolge zurück, die URL-unsichere Zeichen durch Escapezeichen ersetzt.
float Gibt eine Gleitkommazahl für einen Eingabewert zurück.
int Gibt die Ganzzahlversion für eine Zeichenfolge zurück.
json Gibt den JSON-Typwert oder das JSON-Objekt (JSON = JavaScript Object Notation) für eine Zeichenfolge oder XML zurück.
string Gibt die Zeichenfolgenversion für einen Eingabewert zurück.
uriComponent Gibt die URI-codierte Version für einen Eingabewert zurück, indem URL-unsichere Zeichen durch Escapezeichen ersetzt werden.
uriComponentToBinary Gibt die Binärversion für eine URI-codierte Zeichenfolge zurück.
uriComponentToString Gibt die Zeichenfolgenversion für eine URI-codierte Zeichenfolge zurück.
xml Gibt die XML-Version für eine Zeichenfolge zurück.
xpath Überprüft die XML auf Knoten oder Werte, die mit einem XPath-Ausdruck (XML Path Language) übereinstimmen, und gibt die übereinstimmenden Knoten oder Werte zurück.

Mathematische Funktionen

Diese Funktionen können für folgende Arten von Zahlen verwendet werden: ganze Zahlen und Gleitkommazahlen.

Mathematische Funktion Aufgabe
add Gibt das Ergebnis der Addition zweier Zahlen zurück.
div Gibt das Ergebnis der Division einer Zahl durch eine andere Zahl zurück.
max Gibt den höchsten Wert aus einer Reihe von Zahlen oder einem Array zurück.
min Gibt den niedrigsten Wert aus einer Reihe von Zahlen oder einem Array zurück.
mod Gibt den Rest der Division einer Zahl durch eine andere Zahl zurück.
mul Gibt das Produkt aus der Multiplikation zweier Zahlen zurück.
rand Gibt eine beliebige ganze Zahl aus einem angegebenen Bereich zurück.
range Gibt ein Array mit ganzen Zahlen zurück, das mit einer angegebenen ganzen Zahl beginnt.
sub Gibt das Ergebnis der Subtraktion einer Zahl von einer anderen Zahl zurück.

Funktionsreferenz

In diesem Abschnitt werden alle verfügbaren Funktionen in alphabetischer Reihenfolge aufgelistet.

add

Gibt das Ergebnis der Addition zweier Zahlen zurück.

add(<summand_1>, <summand_2>)
Parameter Erforderlich Type Beschreibung
<summand_1>, <summand_2> Ja Integer, Float oder kombiniert Die zu addierenden Zahlen
Rückgabewert type BESCHREIBUNG
<result-sum> Integer oder Float Das Ergebnis der Addition der angegebenen Zahlen

Beispiel

In diesem Beispiel werden die angegebenen Zahlen addiert:

add(1, 1.5)

Dies ist das zurückgegebene Ergebnis: 2.5

addDays

Fügt eine Anzahl von Tagen zu einem Zeitstempel hinzu.

addDays('<timestamp>', <days>, '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<days> Ja Integer Die positive oder negative Anzahl von Tagen, die hinzugefügt werden sollen
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<updated-timestamp> String Der Zeitstempel plus der angegebenen Anzahl von Tagen

Beispiel 1

In diesem Beispiel werden 10 Tage zu dem angegebenen Zeitstempel addiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-03-25T00:00:0000000Z"

Beispiel 2

In diesem Beispiel werden 10 Tage vom angegebenen Zeitstempel subtrahiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-03-10T00:00:0000000Z"

addHours

Fügt eine Anzahl von Stunden zu einem Zeitstempel hinzu.

addHours('<timestamp>', <hours>, '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<hours> Ja Integer Die positive oder negative Anzahl von Stunden, die hinzugefügt werden sollen
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<updated-timestamp> String Der Zeitstempel plus der angegebenen Anzahl von Stunden

Beispiel 1

In diesem Beispiel werden 10 Stunden zu dem angegebenen Zeitstempel addiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-03-15T10:00:0000000Z"

Beispiel 2

In diesem Beispiel werden 10 Stunden vom angegebenen Zeitstempel subtrahiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-03-15T10:00:0000000Z"

addMinutes

Fügt eine Anzahl von Minuten zu einem Zeitstempel hinzu.

addMinutes('<timestamp>', <minutes>, '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<minutes> Ja Integer Die positive oder negative Anzahl von Minuten, die hinzugefügt werden sollen
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<updated-timestamp> String Der Zeitstempel plus der angegebenen Anzahl von Minuten

Beispiel 1

In diesem Beispiel werden 10 Minuten zu dem angegebenen Zeitstempel addiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-03-15T00:20:00.0000000Z"

Beispiel 2

In diesem Beispiel werden fünf Minuten vom angegebenen Zeitstempel subtrahiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-03-15T00:15:00.0000000Z"

addSeconds

Fügt eine Anzahl von Sekunden zu einem Zeitstempel hinzu.

addSeconds('<timestamp>', <seconds>, '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<seconds> Ja Integer Die positive oder negative Anzahl von Sekunden, die hinzugefügt werden sollen
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<updated-timestamp> String Der Zeitstempel plus der angegebenen Anzahl von Sekunden

Beispiel 1

In diesem Beispiel werden 10 Sekunden zu dem angegebenen Zeitstempel addiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-03-15T00:00:10.0000000Z"

Beispiel 2

In diesem Beispiel werden fünf Sekunden vom angegebenen Zeitstempel subtrahiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-03-15T00:00:25.0000000Z"

addToTime

Fügt eine Anzahl von Zeiteinheiten zu einem Zeitstempel hinzu. Siehe auch getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<interval> Ja Integer Die Anzahl der angegebenen Zeiteinheiten, die hinzugefügt werden sollen
<timeUnit> Ja String Die mit interval zu verwendende Zeiteinheit: Second, Minute, Hour, Day, Week, Month, Year
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<updated-timestamp> String Der Zeitstempel plus der angegebenen Anzahl von Zeiteinheiten

Beispiel 1

In diesem Beispiel wird ein Tag zu dem angegebenen Zeitstempel addiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-01-02T00:00:00.0000000Z"

Beispiel 2

In diesem Beispiel wird ein Tag zu dem angegebenen Zeitstempel addiert:

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

Dies ist das zurückgegebene Ergebnis mit dem optionalen „D“-Format: "Tuesday, January 2, 2018"

and

Überprüft, ob für beide Ausdrücke der Wert „true“ festgelegt ist. Gibt „true“ zurück, wenn beide Ausdrücke gleich „true“ sind, oder gibt „false“ zurück, wenn mindestens ein Ausdruck gleich „false“ ist.

and(<expression1>, <expression2>)
Parameter Erforderlich Type Beschreibung
<expression1>, <expression2> Ja Boolean Die Ausdrücke, die überprüft werden sollen
Rückgabewert type BESCHREIBUNG
true oder false Boolean Gibt „true“ zurück, wenn beide Ausdrücke gleich „true“ sind. Gibt „false“ zurück, wenn mindestens ein Ausdruck gleich „false“ ist.

Beispiel 1

In diesen Beispielen wird überprüft, ob beide angegebenen booleschen Werte gleich „true“ sind:

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: Beide Ausdrücke sind gleich „true“, daher wird true zurückgegeben.
  • Zweites Beispiel: Ein Ausdruck ist gleich „false“, daher wird false zurückgegeben.
  • Drittes Beispiel: Beide Ausdrücke sind gleich „false“, daher wird false zurückgegeben.

Beispiel 2

In diesen Beispielen wird überprüft, ob beide angegebenen Ausdrücke gleich „true“ sind:

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: Beide Ausdrücke sind gleich „true“, daher wird true zurückgegeben.
  • Zweites Beispiel: Ein Ausdruck ist gleich „false“, daher wird false zurückgegeben.
  • Drittes Beispiel: Beide Ausdrücke sind gleich „false“, daher wird false zurückgegeben.

array

Gibt ein Array aus einer einzelnen angegebenen Eingabe zurück. Informationen hinsichtlich mehrerer Eingaben finden Sie unter createArray().

array('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die Zeichenfolge zum Erstellen eines Arrays
Rückgabewert type Beschreibung
[<value>] Array Ein Array, das die einzelne angegebene Eingabe enthält

Beispiel

In diesem Beispiel wird ein Array aus der Zeichenfolge „hello“ erstellt:

array('hello')

Dies ist das zurückgegebene Ergebnis: ["hello"]

base64

Gibt die base64-codierte Version für eine Zeichenfolge zurück.

base64('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die eingegebene Zeichenfolge
Rückgabewert type BESCHREIBUNG
<base64-string> String Die base64-codierte Version für die eingegebene Zeichenfolge

Beispiel

In diesem Beispiel wird die Zeichenfolge „hello“ in eine base64-codierte Zeichenfolge konvertiert:

base64('hello')

Dies ist das zurückgegebene Ergebnis: "aGVsbG8="

base64ToBinary

Gibt die Binärversion für eine base64-codierte Zeichenfolge zurück.

base64ToBinary('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die base64-codierte Zeichenfolge, die konvertiert werden soll
Rückgabewert type BESCHREIBUNG
<binary-for-base64-string> String Die Binärversion für die base64-codierte Zeichenfolge

Beispiel

In diesem Beispiel wird die base64-codierte Zeichenfolge „aGVsbG8“ in eine Binärzeichenfolge konvertiert:

base64ToBinary('aGVsbG8=')

Dies ist das zurückgegebene Ergebnis:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Gibt die Zeichenfolgenversion einer base64-codierten Zeichenfolge zurück, d. h., die base64-Zeichenfolge wird decodiert. Sie sollten diese Funktion anstelle von decodeBase64() verwenden. Obwohl beide Funktionen in gleicher Weise funktionieren, wird base64ToString() bevorzugt.

base64ToString('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die base64-codierte Zeichenfolge, die decodiert werden soll
Rückgabewert type BESCHREIBUNG
<decoded-base64-string> String Die Zeichenfolgenversion für eine base64-codierte Zeichenfolge

Beispiel

In diesem Beispiel wird die base64-codierte Zeichenfolge „aGVsbG8“ in eine einfache Zeichenfolge konvertiert:

base64ToString('aGVsbG8=')

Dies ist das zurückgegebene Ergebnis: "hello"

BINARY

Gibt die Binärversion für eine Zeichenfolge zurück.

binary('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die Zeichenfolge, die konvertiert werden soll
Rückgabewert type BESCHREIBUNG
<binary-for-input-value> String Die Binärversion für die angegebene Zeichenfolge

Beispiel

In diesem Beispiel wird die Zeichenfolge „hello“ in eine Binärzeichenfolge konvertiert:

binary('hello')

Dies ist das zurückgegebene Ergebnis:

"0110100001100101011011000110110001101111"

bool

Gibt die boolesche Version eines Werts zurück.

bool(<value>)
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja Any Der zu konvertierende Wert
Rückgabewert type BESCHREIBUNG
true oder false Boolean Die booleschen Version des angegebenen Werts

Beispiel

In diesen Beispielen werden die angegebenen Werte in boolesche Werte konvertieren:

bool(1)
bool(0)

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: true
  • Zweites Beispiel: false

coalesce

Gibt den ersten Wert ungleich NULL aus mindestens einem Parameter zurück. Leere Zeichenfolgen, leere Arrays und leere Objekte sind nicht NULL.

coalesce(<object_1>, <object_2>, ...)
Parameter Erforderlich Type Beschreibung
<object_1>, <object_2>, ... Ja Beliebig, Typen können kombiniert sein Ein oder mehrere Elemente, die auf NULL geprüft werden sollen
Rückgabewert type BESCHREIBUNG
<first-non-null-item> Any Das erste Element oder der erste Wert, das oder der ungleich NULL ist. Sind alle Parameter gleich NULL, gibt diese Funktion NULL zurück.

Beispiel

In diesen Beispielen wird für die angegebenen Werte der erste Wert ungleich NULL oder NULL zurückgegeben, wenn alle Werte gleich NULL sind:

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: true
  • Zweites Beispiel: "hello"
  • Drittes Beispiel: null

concat

Kombiniert mindestens zwei Zeichenfolgen miteinander und gibt die kombinierte Zeichenfolge zurück.

concat('<text1>', '<text2>', ...)
Parameter Erforderlich Type Beschreibung
<text1>, <text2>, ... Ja String Mindestens zwei Zeichenfolgen, die kombiniert werden sollen
Rückgabewert type BESCHREIBUNG
<text1text2...> String Die Zeichenfolge, die aus den kombinierten Eingabezeichenfolgen erstellt wurde

Beispiel

In diesem Beispiel werden die Zeichenfolgen „Hello“ und „World“ kombiniert:

concat('Hello', 'World')

Dies ist das zurückgegebene Ergebnis: "HelloWorld"

contains

Überprüft, ob eine Sammlung ein bestimmtes Element enthält. Gibt „true“ zurück, wenn das Element gefunden wurde, gibt andernfalls „false“ zurück. Für diese Funktion wird die Groß-/Kleinschreibung beachtet.

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

Diese Funktion ist insbesondere für diese Sammlungstypen vorgesehen:

  • Eine Zeichenfolge, in der nach einer Teilzeichenfolge gesucht werden soll
  • Ein Array, in dem nach einem Wert gesucht werden soll
  • Ein Wörterbuch, in dem nach einem Schlüssel gesucht werden soll
Parameter Erforderlich Type BESCHREIBUNG
<collection> Ja Zeichenfolge, Array oder Wörterbuch Die Sammlung, die überprüft werden soll
<value> Ja Zeichenfolge, Array bzw. Wörterbuch Das Element, nach dem gesucht werden soll
Rückgabewert type BESCHREIBUNG
true oder false Boolean Gibt „true“, wenn das Element gefunden wurde. Gibt „false“ zurück, wenn sie nicht gefunden wurde.

Beispiel 1

In diesem Beispiel wird die Zeichenfolge „hello world“ auf die Teilzeichenfolge „world“ geprüft und „true“ zurückgegeben:

contains('hello world', 'world')

Beispiel 2

In diesem Beispiel wird die Zeichenfolge „hello world“ auf die Teilzeichenfolge „universed“ geprüft und „false“ zurückgegeben:

contains('hello world', 'universe')

convertFromUtc

Konvertiert einen Zeitstempel von der UTC-Zeitzone (UTC = Universal Time, Coordinated) in die Zielzeitzone.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<destinationTimeZone> Ja String Der Name für die Zielzeitzone. Informationen zu Zeitzonennamen finden Sie unter Werte der Microsoft-Zeitzonen. Möglicherweise müssen Sie aber alle Satzzeichen aus dem Zeitzonennamen entfernen.
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<converted-timestamp> String Der in das Format der Zielzeitzone konvertierte Zeitstempel

Beispiel 1

In diesem Beispiel wird ein Zeitstempel in das Format der angegebenen Zeitzone konvertiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-01-01T00:00:00Z"

Beispiel 2

In diesem Beispiel wird ein Zeitstempel in das Format der angegebenen Zeitzone konvertiert und formatiert:

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

Dies ist das zurückgegebene Ergebnis: "Monday, January 1, 2018"

convertTimeZone

Konvertiert einen Zeitstempel von der Quellzeitzone in die Zielzeitzone.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<sourceTimeZone> Ja String Der Name für die Quellzeitzone. Informationen zu Zeitzonennamen finden Sie unter Werte der Microsoft-Zeitzonen. Möglicherweise müssen Sie aber alle Satzzeichen aus dem Zeitzonennamen entfernen.
<destinationTimeZone> Ja String Der Name für die Zielzeitzone. Informationen zu Zeitzonennamen finden Sie unter Werte der Microsoft-Zeitzonen. Möglicherweise müssen Sie aber alle Satzzeichen aus dem Zeitzonennamen entfernen.
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<converted-timestamp> String Der in das Format der Zielzeitzone konvertierte Zeitstempel

Beispiel 1

In diesem Beispiel wird ein Zeitstempel von der Quellzeitzone in die Zielzeitzone konvertiert.

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

Dies ist das zurückgegebene Ergebnis: "2018-01-01T00:00:00.0000000"

Beispiel 2

In diesem Beispiel wird eine Zeitzone in die angegebene Zeitzone konvertiert und formatiert:

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

Dies ist das zurückgegebene Ergebnis: "Monday, January 1, 2018"

convertToUtc

Konvertiert einen Zeitstempel von der Quellzeitzone in die UTC-Zeitzone (UTC = Universal Time, Coordinated).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<sourceTimeZone> Ja String Der Name für die Quellzeitzone. Informationen zu Zeitzonennamen finden Sie unter Werte der Microsoft-Zeitzonen. Möglicherweise müssen Sie aber alle Satzzeichen aus dem Zeitzonennamen entfernen.
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<converted-timestamp> String Der Zeitstempel, der in UTC konvertiert wurde

Beispiel 1

In diesem Beispiel wird ein Zeitstempel in UTC konvertiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-01-01T08:00:00.0000000Z"

Beispiel 2

In diesem Beispiel wird ein Zeitstempel in UTC konvertiert:

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

Dies ist das zurückgegebene Ergebnis: "Monday, January 1, 2018"

createArray

Gibt ein Array aus mehreren Eingaben zurück. Informationen zu Arrays mit einzelner Eingabe finden Sie unter array().

createArray('<object1>', '<object2>', ...)
Parameter Erforderlich Type Beschreibung
<object1>, <object2>, ... Ja Beliebig, aber nicht kombiniert Mindestens zwei Elemente, mit denen das Array erstellt wird
Rückgabewert type Beschreibung
[<object1>, <object2>, ...] Array Das Array, das aus allen Eingabeelemente erstellt wurde

Beispiel

In diesem Beispiel wird ein Array aus diesen Eingaben erstellt:

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

Dies ist das zurückgegebene Ergebnis: ["h", "e", "l", "l", "o"]

dataUri

Gibt einen Daten-URI (Uniform Resource Identifier) für eine Zeichenfolge zurück.

dataUri('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die Zeichenfolge, die konvertiert werden soll
Rückgabewert type BESCHREIBUNG
<data-uri> String Der Daten-URI für die Eingabezeichenfolge

Beispiel

In diesem Beispiel wird ein Daten-URI für die Zeichenfolge „hello“ erstellt:

dataUri('hello')

Dies ist das zurückgegebene Ergebnis: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Gibt die binäre Version eines Daten-URIs (Uniform Resource Identifier) zurück. Verwenden Sie diese Funktion anstelle von decodeDataUri(). Obwohl beide Funktionen in gleicher Weise funktionieren, wird dataUriBinary() bevorzugt.

dataUriToBinary('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Der Daten-URI, der konvertiert werden soll
Rückgabewert type BESCHREIBUNG
<binary-for-data-uri> String Die binäre Version für den Daten-URI

Beispiel

In diesem Beispiel wird eine binäre Version für diesen Daten-URI erstellt:

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

Dies ist das zurückgegebene Ergebnis:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Gibt die Zeichenfolgenversion für einen Daten-URI (Uniform Resource Identifier) zurück.

dataUriToString('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Der Daten-URI, der konvertiert werden soll
Rückgabewert type BESCHREIBUNG
<string-for-data-uri> String Die Zeichenfolgenversion des Daten-URIs

Beispiel

In diesem Beispiel wird eine Zeichenfolge für diesen Daten-URI erstellt:

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

Dies ist das zurückgegebene Ergebnis: "hello"

dayOfMonth

Gibt den Tag des Monats aus einem Zeitstempel zurück.

dayOfMonth('<timestamp>')
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
Rückgabewert type BESCHREIBUNG
<day-of-month> Integer Der Tag des Monats aus dem angegebenen Zeitstempel

Beispiel

In diesem Beispiel wird die Zahl für den Tag des Monats aus diesem Zeitstempel zurückgegeben:

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

Dies ist das zurückgegebene Ergebnis: 15

dayOfWeek

Gibt den Wochentag aus einem Zeitstempel zurück.

dayOfWeek('<timestamp>')
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
Rückgabewert type BESCHREIBUNG
<day-of-week> Integer Der Wochentag aus dem angegebenen Zeitstempel, wobei Folgendes gilt: Sonntag = 0, Montag = 1 usw.

Beispiel

In diesem Beispiel wird die Zahl für den Wochentag aus diesem Zeitstempel zurückgegeben:

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

Dies ist das zurückgegebene Ergebnis: 3

dayOfYear

Gibt den Tag des Jahres aus einem Zeitstempel zurück.

dayOfYear('<timestamp>')
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
Rückgabewert type BESCHREIBUNG
<day-of-year> Integer Der Tag des Jahres aus dem angegebenen Zeitstempel

Beispiel

In diesem Beispiel wird die Zahl für den Tag des Jahres aus diesem Zeitstempel zurückgegeben:

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

Dies ist das zurückgegebene Ergebnis: 74

decodeBase64

Gibt die Zeichenfolgenversion einer base64-codierten Zeichenfolge zurück, d. h., die base64-Zeichenfolge wird decodiert. Sie sollten base64ToString() anstelle von decodeBase64() verwenden. Obwohl beide Funktionen in gleicher Weise funktionieren, wird base64ToString() bevorzugt.

decodeBase64('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die base64-codierte Zeichenfolge, die decodiert werden soll
Rückgabewert type BESCHREIBUNG
<decoded-base64-string> String Die Zeichenfolgenversion für eine base64-codierte Zeichenfolge

Beispiel

In diesem Beispiel wird eine Zeichenfolge für eine base64-codierte Zeichenfolge erstellt:

decodeBase64('aGVsbG8=')

Dies ist das zurückgegebene Ergebnis: "hello"

decodeDataUri

Gibt die binäre Version eines Daten-URIs (Uniform Resource Identifier) zurück. Sie sollten dataUriToBinary() anstelle von decodeDataUri() verwenden. Obwohl beide Funktionen in gleicher Weise funktionieren, wird dataUriToBinary() bevorzugt.

decodeDataUri('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die Daten-URI-Zeichenfolge, die decodiert werden soll
Rückgabewert type BESCHREIBUNG
<binary-for-data-uri> String Die Binärversion für eine Daten-URI-Zeichenfolge

Beispiel

In diesem Beispiel wird die binäre Version für diesen Daten-URI zurückgegeben:

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

Dies ist das zurückgegebene Ergebnis:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Gibt eine Zeichenfolge zurück, in der Escapezeichen durch decodierte Versionen ersetzt sind.

decodeUriComponent('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die Zeichenfolge mit den Escapezeichen, die decodiert werden sollen
Rückgabewert type BESCHREIBUNG
<decoded-uri> String Die aktualisierte Zeichenfolge mit den decodierten Escapezeichen

Beispiel

In diesem Beispiel werden die Escapezeichen in dieser Zeichenfolge durch decodierte-Versionen ersetzt:

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

Dies ist das zurückgegebene Ergebnis: "https://contoso.com"

div

Gibt das Ergebnis der Division einer Zahl durch eine andere Zahl zurück.

div(<dividend>, <divisor>)

Der genaue Rückgabetyp der Funktion hängt von den Typen seiner Parameter ab. Die Beispiele zeigen Details.

Parameter Erforderlich Type BESCHREIBUNG
<dividend> Ja Integer oder Float Die Zahl, die durch den Divisor dividiert werden soll.
<divisor> Ja Integer oder Float Die Zahl, durch die der Dividend geteilt wird. Ein Divisor-Wert von Null verursacht zur Ausführungszeit einen Fehler.
Rückgabewert type BESCHREIBUNG
<quotient-result> Integer oder Float Das Ergebnis aus der Division der ersten Zahl durch die zweite Zahl.

Beispiel 1

In diesen Beispielen wird die Zahl 9 durch 2 dividiert:

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

Dies ist das zurückgegebene Ergebnis: 4.5

Beispiel 2

In diesem Beispiel wird ebenfalls die Zahl 9 durch 2 dividiert, aber da beide Parameter ganze Zahlen sind, wird der Rest verworfen (ganzzahlige Division):

div(9, 2)

Dieser Ausdruck gibt das Ergebnis 4 zurück. Um den Wert des Rests abzurufen, verwenden Sie die Funktion mod().

encodeUriComponent

Gibt eine URI-codierte (Uniform Resource Identifier) Version für eine Zeichenfolge zurück, indem URL-unsichere Zeichen durch Escapezeichen ersetzt werden. Sie sollten uriComponent() anstelle von encodeUriComponent() verwenden. Obwohl beide Funktionen in gleicher Weise funktionieren, wird uriComponent() bevorzugt.

encodeUriComponent('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die Zeichenfolge, die in das URI-codierte Format konvertiert werden soll
Rückgabewert type BESCHREIBUNG
<encoded-uri> String Die URI-codierte Zeichenfolge mit Escapezeichen

Beispiel

In diesem Beispiel wird eine URI-codierte Version für diese Zeichenfolge erstellt:

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

Dies ist das zurückgegebene Ergebnis: "http%3A%2F%2Fcontoso.com"

empty

Überprüft, ob eine Sammlung leer ist. Gibt „true“ zurück, wenn die Sammlung leer ist, oder gibt „false“ zurück, wenn sie nicht leer ist.

empty('<collection>')
empty([<collection>])
Parameter Erforderlich Type BESCHREIBUNG
<collection> Ja Zeichenfolge, Array oder Objekt Die Sammlung, die überprüft werden soll
Rückgabewert type BESCHREIBUNG
true oder false Boolean Gibt „true“ zurück, wenn die Sammlung leer ist. Gibt „false“ zurück, wenn sie nicht leer ist.

Beispiel

In diesen Beispielen wird überprüft, ob die angegebenen Sammlungen leer sind:

empty('')
empty('abc')

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: Es wird eine leere Zeichenfolge übergeben, weshalb die Funktion true zurückgibt.
  • Zweites Beispiel: Es wird die Zeichenfolge „abc“ übergeben, weshalb die Funktion false zurückgibt.

endsWith

Überprüft, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge endet. Gibt „true“ zurück, wenn die Teilzeichenfolge gefunden wurde, gibt andernfalls „false“ zurück. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet.

endsWith('<text>', '<searchText>')
Parameter Erforderlich Type BESCHREIBUNG
<text> Ja String Die Zeichenfolge, die überprüft werden soll
<searchText> Ja String Die beendende Teilzeichenfolge, nach der gesucht werden soll
Rückgabewert type BESCHREIBUNG
true oder false Boolean Gibt „true“ zurück, wenn die beendende Teilzeichenfolge gefunden wurde. Gibt „false“ zurück, wenn sie nicht gefunden wurde.

Beispiel 1

In diesem Beispiel wird überprüft, ob die Zeichenfolge „hello world“ mit der Zeichenfolge „world“ endet:

endsWith('hello world', 'world')

Dies ist das zurückgegebene Ergebnis: true

Beispiel 2

In diesem Beispiel wird überprüft, ob die Zeichenfolge „hello world“ mit der Zeichenfolge „universe“ endet:

endsWith('hello world', 'universe')

Dies ist das zurückgegebene Ergebnis: false

equals

Überprüft, ob beide Werte, Ausdrücke oder Objekte gleichwertig sind. Gibt „true“ zurück, wenn beide gleichwertig sind, gibt andernfalls „false“ zurück.

equals('<object1>', '<object2>')
Parameter Erforderlich Type Beschreibung
<object1>, <object2> Ja Verschiedene Die Werte, Ausdrücke oder Objekte, die verglichen werden sollen
Rückgabewert type BESCHREIBUNG
true oder false Boolean Gibt „true“ zurück, wenn beide gleichwertig sind. Gibt „false“ zurück, wenn sie nicht gleichwertig sind.

Beispiel

In diesen Beispielen wird überprüft, ob die angegebenen Eingaben gleichwertig sind:

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: Beide Werte sind gleichwertig, weshalb die Funktion true zurückgibt.
  • Zweites Beispiel: Beide Werte sind nicht gleichwertig, weshalb die Funktion false zurückgibt.

first

Gibt das erste Element aus einer Zeichenfolge oder einem Array zurück.

first('<collection>')
first([<collection>])
Parameter Erforderlich Type BESCHREIBUNG
<collection> Ja Zeichenfolge oder Array Die Sammlung, aus der das erste Element abgerufen werden soll
Rückgabewert type BESCHREIBUNG
<first-collection-item> Any Das erste Element in der Sammlung

Beispiel

In diesen Beispielen wird jeweils das erste Element aus diesen Sammlungen abgerufen:

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: "h"
  • Zweites Beispiel: 0

float

Konvertiert die Zeichenfolgenversion einer Gleitkommazahl in eine tatsächliche Gleitkommazahl.

float('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die Zeichenfolge, die die gültige Gleitkommazahl angibt, die konvertiert werden soll
Rückgabewert type BESCHREIBUNG
<float-value> Float Die Gleitkommazahl für die angegebene Zeichenfolge

Beispiel

In diesem Beispiel wird eine Zeichenfolgenversion für diese Gleitkommazahl erstellt:

float('10.333')

Dies ist das zurückgegebene Ergebnis: 10.333

formatDateTime

Gibt einen Zeitstempel im angegebenen Format zurück.

formatDateTime('<timestamp>', '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<reformatted-timestamp> String Der aktualisierte Zeitstempel im angegebenen Format

Beispiel

In diesem Beispiel wird ein Zeitstempel in das angegebene Format konvertiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-03-15T12:00:00"

getFutureTime

Gibt den aktuellen Zeitstempel plus der angegebenen Zeiteinheiten zurück.

getFutureTime(<interval>, <timeUnit>, <format>?)
Parameter Erforderlich Type BESCHREIBUNG
<interval> Ja Integer Die Anzahl der angegebenen Zeiteinheiten, die hinzugefügt werden sollen
<timeUnit> Ja String Die mit interval zu verwendende Zeiteinheit: Second, Minute, Hour, Day, Week, Month, Year
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<updated-timestamp> String Der aktuelle Zeitstempel plus der angegebenen Anzahl von Zeiteinheiten

Beispiel 1

Angenommen, der aktuelle Zeitstempel lautet „2018-03-01T00:00:00.0000000Z“. In diesem Beispiel werden diesem Zeitstempel fünf Tage hinzugefügt:

getFutureTime(5, 'Day')

Dies ist das zurückgegebene Ergebnis: "2018-03-06T00:00:00.0000000Z"

Beispiel 2

Angenommen, der aktuelle Zeitstempel lautet „2018-03-01T00:00:00.0000000Z“. In diesem Beispiel werden fünf Tage hinzugefügt, und das Ergebnis wird in das „D“-Format konvertiert:

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

Dies ist das zurückgegebene Ergebnis: "Tuesday, March 6, 2018"

getPastTime

Gibt den aktuellen Zeitstempel abzüglich der angegebenen Zeiteinheiten zurück.

getPastTime(<interval>, <timeUnit>, <format>?)
Parameter Erforderlich Type BESCHREIBUNG
<interval> Ja Integer Die Anzahl der angegebenen Zeiteinheiten, die subtrahiert werden sollen
<timeUnit> Ja String Die mit interval zu verwendende Zeiteinheit: Second, Minute, Hour, Day, Week, Month, Year
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<updated-timestamp> String Der aktuelle Zeitstempel abzüglich der angegebenen Anzahl von Zeiteinheiten

Beispiel 1

Angenommen, der aktuelle Zeitstempel lautet „2018-02-01T00:00:00.0000000Z“. In diesem Beispiel werden fünf Tage von diesem Zeitstempel subtrahiert:

getPastTime(5, 'Day')

Dies ist das zurückgegebene Ergebnis: "2018-01-27T00:00:00.0000000Z"

Beispiel 2

Angenommen, der aktuelle Zeitstempel lautet „2018-02-01T00:00:00.0000000Z“. In diesem Beispiel werden fünf Tage subtrahiert, und das Ergebnis wird in das „D“-Format konvertiert:

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

Dies ist das zurückgegebene Ergebnis: "Saturday, January 27, 2018"

greater

Überprüft, ob der erste Wert größer als der zweite ist. Gibt „true“ zurück, wenn der erste Wert größer ist, gibt andernfalls „false“ zurück.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja Integer, Float oder Zeichenfolge Der Wert (erster Wert), für den überprüft wird, ob er größer ist als der zweite Wert.
<compareTo> Ja Integer, Float bzw. Zeichenfolge Der Vergleichswert
Rückgabewert type BESCHREIBUNG
true oder false Boolean Gibt „true“ zurück, wenn der erste Wert größer ist als der zweite Wert. Gibt „false“ zurück, wenn der erste Wert kleiner gleich dem zweiten Wert ist.

Beispiel

In diesen Beispiel wird überprüft, ob der erste Wert größer ist als der zweite Wert.

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: true
  • Zweites Beispiel: false

greaterOrEquals

Überprüft, ob der erste Wert größer als oder gleich dem zweiten ist. Gibt „true“ zurück, wenn der erste Wert größer gleich dem zweiten Wert ist, gibt andernfalls „false“ zurück.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja Integer, Float oder Zeichenfolge Der Wert (erster Wert), für den überprüft werden soll, ob er größer gleich dem zweiten Wert ist.
<compareTo> Ja Integer, Float bzw. Zeichenfolge Der Vergleichswert
Rückgabewert type BESCHREIBUNG
true oder false Boolean Gibt „true“ zurück, wenn der erste Wert größer gleich dem zweiten Wert ist. Gibt „false“ zurück, wenn der erste Wert kleiner ist als der zweite Wert.

Beispiel

In diesen Beispiel wird überprüft, ob der erste Wert größer gleich dem zweiten Wert ist:

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: true
  • Zweites Beispiel: false

guid

Generiert einen global eindeutigen Bezeichner (Globally Unique Identifier, GUID) als Zeichenfolge, z. B. „c2ecc88d-88c8-4096-912c-d6f2e2b138ce“:

guid()

Außerdem können Sie für den GUID ein anderes Format angeben, das vom Standardformat „D“ abweicht, das aus 32 durch Bindestriche getrennten Ziffern besteht.

guid('<format>')
Parameter Erforderlich Type BESCHREIBUNG
<format> Nein String Ein einzelner Formatbezeichner für den zurückgegebenen GUID. Das Standardformat ist „D“, Sie können aber „N“, „D“, „B“, „P“ oder „X“ verwenden.
Rückgabewert type BESCHREIBUNG
<GUID-value> String Ein zufällig generierter GUID

Beispiel

In diesem Beispiel wird derselbe GUID generiert, jedoch mit 32 Ziffern, die durch Bindestriche getrennt sind und in Klammern stehen:

guid('P')

Dies ist das zurückgegebene Ergebnis: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

Überprüft, ob ein Ausdruck gleich „true“ oder „false“ ist. Gibt abhängig vom Ergebnis einen angegebenen Wert zurück.

if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parameter Erforderlich Type BESCHREIBUNG
<expression> Ja Boolean Der zu überprüfende Ausdruck
<valueIfTrue> Ja Any Der Wert, der zurückgegeben werden soll, wenn der Ausdruck gleich „true“ ist
<valueIfFalse> Ja Any Der Wert, der zurückgegeben werden soll, wenn der Ausdruck gleich „false“ ist
Rückgabewert type BESCHREIBUNG
<specified-return-value> Any Der angegebene Wert, der abhängig davon zurückgegeben wird, ob der Ausdruck gleich „true“ oder „false“ ist.

Beispiel

In diesem Beispiel wird "yes" zurückgegeben, weil für den angegebenen Ausdruck „true“ zurückgegeben wird. Andernfalls wird in dem Beispiel "no" zurückgegeben:

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

indexOf

Gibt die Anfangsposition oder den Anfangsindexwert für eine Teilzeichenfolge zurück. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet, und Indizes beginnen mit der Zahl 0.

indexOf('<text>', '<searchText>')
Parameter Erforderlich Type BESCHREIBUNG
<text> Ja String Die Zeichenfolge, die die Teilzeichenfolge enthält, nach der gesucht werden soll
<searchText> Ja String Die Teilzeichenfolge, nach der gesucht werden soll
Rückgabewert type BESCHREIBUNG
<index-value> Integer Die Anfangsposition oder der Anfangsindexwert für die angegebene Teilzeichenfolge.

Wird die Zeichenfolge nicht gefunden, wird „-1“ zurückgegeben.

Beispiel

In diesem Beispiel wird für die Teilzeichenfolge „world“ nach dem Anfangsindexwert gesucht, den sie in der Zeichenfolge „hello world“ hat:

indexOf('hello world', 'world')

Dies ist das zurückgegebene Ergebnis: 6

INT

Gibt die Ganzzahlversion für eine Zeichenfolge zurück.

int('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die Zeichenfolge, die konvertiert werden soll
Rückgabewert type BESCHREIBUNG
<integer-result> Integer Die Ganzzahlversion für die angegebene Zeichenfolge

Beispiel

In diesem Beispiel wird die Ganzzahlversion für die Zeichenfolge „10“ erstellt:

int('10')

Dies ist das zurückgegebene Ergebnis: 10

json

Gibt den JSON-Typwert oder das JSON-Objekt (JSON = JavaScript Object Notation) für eine Zeichenfolge oder XML zurück.

json('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja Zeichenfolge oder XML Die Zeichenfolge oder das XML-Objekt, die oder das konvertiert werden soll
Rückgabewert type BESCHREIBUNG
<JSON-result> Nativer JSON-Typ oder natives JSON-Objekt Der Wert des nativen JSON-Typs oder das native JSON-Objekt für die angegebene Zeichenfolge oder das angegebene XML-Objekt. Hat die Zeichenfolge den Nullwert (NULL), gibt die Funktion ein leeres Objekt zurück.

Beispiel 1

In diesem Beispiel wird diese Zeichenfolge in den JSON-Wert konvertiert:

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

Dies ist das zurückgegebene Ergebnis: [1, 2, 3]

Beispiel 2

In diesem Beispiel wird diese Zeichenfolge in JSON konvertiert:

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

Dies ist das zurückgegebene Ergebnis:

{
  "fullName": "Sophia Owen"
}

Beispiel 3

In diesem Beispiel wird dieses XML-Objekt in JSON konvertiert:

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

Dies ist das zurückgegebene Ergebnis:

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

Schnittmenge

Gibt eine Sammlung zurück, die nur die gängigen Elemente aus den angegebenen Sammlungen enthält. Damit ein Element im Ergebnis enthalten ist, muss es in allen Sammlungen enthalten sein, die an diese Funktion übergeben werden. Haben mehrere Elemente denselben Namen, enthält das Ergebnis das letzte Element mit diesem Namen.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parameter Erforderlich Type Beschreibung
<collection1>, <collection2>, ... Ja Array oder Objekt, aber nicht beide Die Sammlungen, aus denen Sie nur die gemeinsame Elemente wünschen
Rückgabewert type BESCHREIBUNG
<common-items> Array bzw. Objekt Eine Sammlung, die nur die Elemente enthält, die in jeder der angegebenen Sammlungen enthalten sind.

Beispiel

In diesem Beispiel wird nach den Elementen gesucht, die in jedem dieser Arrays enthalten sind:

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

Es wird ein Array zurückgegeben, das nur diese Elemente enthält: [1, 2]

join

Gibt eine Zeichenfolge zurück, die alle Elemente aus einem Array enthält und in der je zwei Elemente durch ein Trennzeichen getrennt sind.

join([<collection>], '<delimiter>')
Parameter Erforderlich Type BESCHREIBUNG
<collection> Ja Array Das Array, das die Elemente enthält, die verknüpft werden sollen
<delimiter> Ja String Das Trennzeichen, das zwischen den einzelnen Elementen in der Ergebniszeichenfolge steht.
Rückgabewert type Beschreibung
<char1><delimiter><char2><delimiter>... String Die resultierende Zeichenfolge, die aus allen Elementen im angegebenen Array erstellt wurde

Beispiel

In diesem Beispiel wird eine Zeichenfolge erstellt, die aus allen Elementen in diesem Array und dem angegebenen Zeichen als Trennzeichen besteht:

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

Dies ist das zurückgegebene Ergebnis: "a.b.c"

last

Gibt das letzte Element aus einer Sammlung zurück.

last('<collection>')
last([<collection>])
Parameter Erforderlich Type BESCHREIBUNG
<collection> Ja Zeichenfolge oder Array Die Sammlung, aus der das letzte Element abgerufen werden soll
Rückgabewert type BESCHREIBUNG
<last-collection-item> Zeichenfolge bzw. Array Das letzte Element in der Sammlung

Beispiel

In diesen Beispielen wird jeweils das letzte Element aus diesen Sammlungen abgerufen:

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: "d"
  • Zweites Beispiel: 3

lastIndexOf

Gibt die Anfangsposition oder den Indexwert des letzten Vorkommens einer Teilzeichenfolge zurück. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet, und Indizes beginnen mit der Zahl 0.

lastIndexOf('<text>', '<searchText>')
Parameter Erforderlich Type BESCHREIBUNG
<text> Ja String Die Zeichenfolge, die die Teilzeichenfolge enthält, nach der gesucht werden soll
<searchText> Ja String Die Teilzeichenfolge, nach der gesucht werden soll
Rückgabewert type BESCHREIBUNG
<ending-index-value> Integer Die Anfangsposition oder der Indexwert des letzten Vorkommens der angegebenen Teilzeichenfolge.

Wird die Zeichenfolge nicht gefunden, wird „-1“ zurückgegeben.

Beispiel

In diesem Beispiel wird für die Teilzeichenfolge „world“ nach dem Anfangsindexwert des letzten Vorkommens gesucht, den sie in der Zeichenfolge „hello world“ hat:

lastIndexOf('hello world', 'world')

Dies ist das zurückgegebene Ergebnis: 6

length

Gibt Anzahl von Elementen einer Sammlung zurück

length('<collection>')
length([<collection>])
Parameter Erforderlich Type BESCHREIBUNG
<collection> Ja Zeichenfolge oder Array Die Sammlung mit den Elementen, die gezählt werden sollen
Rückgabewert type BESCHREIBUNG
<length-or-count> Integer Die Anzahl von Elementen in der Sammlung

Beispiel

In diesen Beispielen wird die Anzahl von Elementen in diesen Sammlungen gezählt:

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

Dies ist das zurückgegebene Ergebnis: 4

less

Überprüft, ob der erste Wert kleiner als der zweite ist. Gibt „true“ zurück, wenn der erste Wert kleiner ist, gibt andernfalls „false“ zurück.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja Integer, Float oder Zeichenfolge Der Wert (erster Wert), für den überprüft werden soll, ob er kleiner ist als der zweite Wert
<compareTo> Ja Integer, Float bzw. Zeichenfolge Das Vergleichselement
Rückgabewert type BESCHREIBUNG
true oder false Boolean Gibt „true“ zurück, wenn der erste Wert kleiner ist als der zweite Wert. Gibt „false“ zurück, wenn der erste Wert größer gleich dem zweiten Wert ist.

Beispiel

In diesen Beispiel wird überprüft, ob der erste Wert kleiner ist als der zweite Wert.

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: true
  • Zweites Beispiel: false

lessOrEquals

Überprüft, ob der erste Wert kleiner als oder gleich dem zweiten ist. Gibt „true“ zurück, wenn der erste Wert kleiner gleich dem zweiten Wert ist, gibt andernfalls „false“ zurück.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja Integer, Float oder Zeichenfolge Der Wert (erster Wert), für den überprüft werden soll, ob er kleiner gleich dem zweiten Wert ist.
<compareTo> Ja Integer, Float bzw. Zeichenfolge Das Vergleichselement
Rückgabewert type BESCHREIBUNG
true oder false Boolean Gibt „true“ zurück, wenn der erste Wert kleiner gleich dem zweiten Wert ist. Gibt „false“ zurück, wenn der erste Wert größer ist als der zweite Wert.

Beispiel

In diesen Beispiel wird überprüft, ob der erste Wert kleiner gleich dem zweiten Wert ist.

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: true
  • Zweites Beispiel: false

max

Gibt den größten Wert aus einer Liste oder einem Array mit Zahlen zurück, mit dem Wert an beiden Enden inklusive.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parameter Erforderlich Type Beschreibung
<number1>, <number2>, ... Ja Integer, Float oder beide Die Menge der Zahlen, aus denen Sie den größten Wert abrufen möchten
[<number1>, <number2>, ...] Ja Array: Integer, Float oder beide Das Array mit den Zahlen, aus denen Sie den größten Wert abrufen möchten
Rückgabewert type BESCHREIBUNG
<max-value> Integer oder Float Der größte Wert in dem angegebenen Array oder in der angegebenen Menge von Zahlen

Beispiel

In diesen Beispielen wird der größte Wert aus der Menge von Zahlen und aus dem Array abgerufen:

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

Dies ist das zurückgegebene Ergebnis: 3

Min

Gibt den niedrigsten Wert aus einer Reihe von Zahlen oder einem Array zurück.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parameter Erforderlich Type Beschreibung
<number1>, <number2>, ... Ja Integer, Float oder beide Die Menge der Zahlen, aus denen Sie den kleinsten Wert abrufen möchten
[<number1>, <number2>, ...] Ja Array: Integer, Float oder beide Das Array mit den Zahlen, aus denen Sie den kleinsten Wert abrufen möchten
Rückgabewert type BESCHREIBUNG
<min-value> Integer oder Float Der kleinste Wert in der angegebenen Menge von Zahlen oder in dem angegebenen Array

Beispiel

In diesen Beispielen wird der kleinste Wert aus der Menge von Zahlen und aus dem Array abgerufen:

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

Dies ist das zurückgegebene Ergebnis: 1

mod

Gibt den Rest der Division einer Zahl durch eine andere Zahl zurück. Eine ganzzahlige Division finden Sie unter div().

mod(<dividend>, <divisor>)
Parameter Erforderlich Type BESCHREIBUNG
<dividend> Ja Integer oder Float Die Zahl, die durch den Divisor dividiert werden soll.
<divisor> Ja Integer oder Float Die Zahl, durch die der Dividend geteilt wird. Ein Divisor-Wert von Null verursacht zur Ausführungszeit einen Fehler.
Rückgabewert type BESCHREIBUNG
<modulo-result> Integer oder Float Der Rest aus der Division der ersten Zahl durch die zweite Zahl

Beispiel

Dieses Beispiel berechnet den Rest aus der Division der ersten Zahl durch die zweite Zahl:

mod(3, 2)

Dies ist das zurückgegebene Ergebnis: 1

mul

Gibt das Produkt aus der Multiplikation zweier Zahlen zurück.

mul(<multiplicand1>, <multiplicand2>)
Parameter Erforderlich Type BESCHREIBUNG
<multiplicand1> Ja Integer oder Float Die Zahl, mit der multiplicand2 multipliziert werden soll.
<multiplicand2> Ja Integer oder Float Die Zahl, mit der multiplicand1 multipliziert werden soll
Rückgabewert type BESCHREIBUNG
<product-result> Integer oder Float Das Produkt aus der Multiplikation der ersten Zahl mit der zweiten Zahl

Beispiel

In diesen Beispielen wird die erste Zahl mit der zweiten Zahl multipliziert:

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: 2
  • Zweites Beispiel: 3

not

Überprüft, ob ein Ausdruck gleich „false“ ist. Gibt „true“ zurück, wenn der Ausdruck gleich „false“ ist, oder gibt „false“ zurück, wenn er gleich „true“ ist.

not(<expression>)
Parameter Erforderlich Type BESCHREIBUNG
<expression> Ja Boolean Der zu überprüfende Ausdruck
Rückgabewert type BESCHREIBUNG
true oder false Boolean Gibt „true“ zurück, wenn der Ausdruck gleich „false“ ist. Gibt „false“ zurück, wenn der Ausdruck gleich „true“ ist.

Beispiel 1

In diesen Beispielen wird überprüft, ob die angegebenen Ausdrücke gleich „false“ sind:

not(false)
not(true)

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: Der Ausdruck ist gleich „false“, weshalb die Funktion true zurückgibt.
  • Zweites Beispiel: Der Ausdruck ist gleich „true“, weshalb die Funktion false zurückgibt.

Beispiel 2

In diesen Beispielen wird überprüft, ob die angegebenen Ausdrücke gleich „false“ sind:

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: Der Ausdruck ist gleich „false“, weshalb die Funktion true zurückgibt.
  • Zweites Beispiel: Der Ausdruck ist gleich „true“, weshalb die Funktion false zurückgibt.

oder

Überprüft, ob mindestens ein Ausdruck gleich „true“ ist. Gibt „true“ zurück, wenn mindestens ein Ausdruck gleich „true“ ist, oder gibt „false“ zurück, wenn beide Ausdrücke gleich „false“ sind.

or(<expression1>, <expression2>)
Parameter Erforderlich Type Beschreibung
<expression1>, <expression2> Ja Boolean Die Ausdrücke, die überprüft werden sollen
Rückgabewert type BESCHREIBUNG
true oder false Boolean Gibt „true“ zurück, wenn mindestens ein Ausdruck gleich „true“ ist. Gibt „false“ zurück, wenn beide Ausdrücke gleich „false“ sind.

Beispiel 1

In diesen Beispielen wird überprüft, ob mindestens ein Ausdruck gleich „true“ ist:

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: Mindestens ein Ausdruck ist gleich „true“, weshalb die Funktion true zurückgibt.
  • Zweites Beispiel: Beide Ausdrücke sind gleich „false“, weshalb die Funktion false zurückgibt.

Beispiel 2

In diesen Beispielen wird überprüft, ob mindestens ein Ausdruck gleich „true“ ist:

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: Mindestens ein Ausdruck ist gleich „true“, weshalb die Funktion true zurückgibt.
  • Zweites Beispiel: Beide Ausdrücke sind gleich „false“, weshalb die Funktion false zurückgibt.

rand

Gibt eine zufällige Ganzzahl aus einem angegebenen Bereich zurück, wobei nur der Anfangswert inklusive ist.

rand(<minValue>, <maxValue>)
Parameter Erforderlich Type BESCHREIBUNG
<minValue> Ja Integer Die kleinste ganze Zahl im Bereich
<maxValue> Ja Integer Die ganze Zahl, die im Bereich auf die größte Zahl folgt, die die Funktion zurückgeben kann
Rückgabewert type BESCHREIBUNG
<random-result> Integer Die zufällige ganze Zahl, die aus dem angegebenen Bereich zurückgegeben wird. Beachten Sie, dass jeder Aufruf von rand() zu einem eindeutigen Ergebnis führt, was bedeutet, dass der Wert, den Sie in der Ausgabeüberwachung beobachten, möglicherweise nicht mit der tatsächlichen Laufzeit identisch ist.

Beispiel

In diesem Beispiel wird eine Zufallsganzzahl aus dem angegebenen Bereich abgerufen, wobei der größte Wert ausgeschlossen ist:

rand(1, 5)

Eine dieser Zahlen wird als Ergebnis zurückgegeben: 1, 2, 3 oder 4

range

Gibt ein Array mit ganzen Zahlen zurück, das mit einer angegebenen ganzen Zahl beginnt.

range(<startIndex>, <count>)
Parameter Erforderlich Type BESCHREIBUNG
<startIndex> Ja Integer Ein ganzzahliger Wert, der das erste Element im Array ist
<count> Ja Integer Die Anzahl von ganzen Zahlen im Array
Rückgabewert type Beschreibung
[<range-result>] Array Das Array mit ganzen Zahlen ab dem angegebenen Index

Beispiel

In diesem Beispiel wird ein Array aus ganzen Zahlen erstellt, das mit angegebenen Index beginnt und die angegebene Anzahl von ganzen Zahlen hat:

range(1, 4)

Dies ist das zurückgegebene Ergebnis: [1, 2, 3, 4]

replace

Ersetzt eine Teilzeichenfolge durch die angegebene Zeichenfolge und gibt die resultierende Zeichenfolge zurück. Für diese Funktion wird die Groß-/Kleinschreibung beachtet.

replace('<text>', '<oldText>', '<newText>')
Parameter Erforderlich Type BESCHREIBUNG
<text> Ja String Die Zeichenfolge, die die Teilzeichenfolge enthält, die ersetzt werden soll
<oldText> Ja String Die Teilzeichenfolge, die ersetzt werden soll
<newText> Ja String Die Ersatzzeichenfolge
Rückgabewert type BESCHREIBUNG
<updated-text> String Die aktualisierte Zeichenfolge, nachdem die Teilzeichenfolge ersetzt wurde.

Wenn die Teilzeichenfolge nicht gefunden wird, wird die ursprüngliche Zeichenfolge zurückgegeben.

Beispiel

In diesem Beispiel wird in „the old string“ nach der Teilzeichenfolge „old“ gesucht und „old“ durch „new“ ersetzt:

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

Dies ist das zurückgegebene Ergebnis: "the new string"

skip

Entfernt Elemente vom Anfang einer Sammlung und gibt alle anderen Elemente zurück.

skip([<collection>], <count>)
Parameter Erforderlich Type BESCHREIBUNG
<collection> Ja Array Die Sammlung, aus der Sie Elemente entfernen möchten
<count> Ja Integer Eine positive ganze Zahl für die Anzahl von Elementen, die am Anfang entfernt werden sollen
Rückgabewert type Beschreibung
[<updated-collection>] Array Die aktualisierte Auflistung, nachdem die angegebenen Elemente entfernt wurden

Beispiel

In diesem Beispiel wird ein Element, die Zahl 0, am Anfang des angegebenen Arrays entfernt:

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

Es wird dieses Array mit den restlichen Elementen zurückgegeben: [1,2,3]

split

Teilt eine Zeichenfolge bei jedem Vorkommen eines angegebenen Trennzeichens, wobei die resultierenden Teilzeichenfolgen als Elemente eines Arrays zurückgegeben werden. Ein Trennzeichen ist in der Regel ein einzelnes Zeichen, aber mehrere Zeichen umfassende Trenner werden unterstützt.

split('<text>', '<delimiter>')
Parameter Erforderlich Type BESCHREIBUNG
<text> Ja String Die Zeichenfolge, die in Teilzeichenfolgen getrennt werden soll
<delimiter> Ja String Die Zeichenfolge, die als Trennzeichen verwendet wird
Rückgabewert type Beschreibung
[<substring1>,<substring2>,...] Array Ein Array mit Teilzeichenfolgen aus der ursprünglichen Zeichenfolge

Beispiel

In diesem Beispiel wird ein Array zurückgegeben, das Teilzeichenfolgen der Zeichenfolge „a_b_c“ basierend auf dem Trennzeichen „_“ enthält:

split('a_b_c', '_')

Das zurückgegebene Array lautet: ["a","b","c"]

startOfDay

Gibt den Beginn des Tages für einen Zeitstempel zurück.

startOfDay('<timestamp>', '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<updated-timestamp> String Der angegebene Zeitstempel, der jedoch bei null Uhr für den Tag beginnt

Beispiel

In diesem Beispiel wird der Beginn des Tags für diesen Zeitstempel ermittelt:

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

Dies ist das zurückgegebene Ergebnis: "2018-03-15T00:00:00.0000000Z"

startOfHour

Gibt den Beginn der Stunde für einen Zeitstempel zurück.

startOfHour('<timestamp>', '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<updated-timestamp> String Der angegebene Zeitstempel, der jedoch bei null Minuten für die Stunde beginnt

Beispiel

In diesem Beispiel wird der Beginn der Stunde für diesen Zeitstempel ermittelt:

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

Dies ist das zurückgegebene Ergebnis: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Gibt den Beginn des Monats für einen Zeitstempel zurück.

startOfMonth('<timestamp>', '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<updated-timestamp> String Der angegebene Zeitstempel, der jedoch am ersten Tag des Monats um null Uhr beginnt

Beispiel

In diesem Beispiel wird der Beginn des Monats für diesen Zeitstempel zurückgegeben:

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

Dies ist das zurückgegebene Ergebnis: "2018-03-01T00:00:00.0000000Z"

startsWith

Überprüft, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge beginnt. Gibt „true“ zurück, wenn die Teilzeichenfolge gefunden wurde, gibt andernfalls „false“ zurück. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet.

startsWith('<text>', '<searchText>')
Parameter Erforderlich Type BESCHREIBUNG
<text> Ja String Die Zeichenfolge, die überprüft werden soll
<searchText> Ja String Die beginnende Zeichenfolge, nach der gesucht werden soll
Rückgabewert type BESCHREIBUNG
true oder false Boolean Gibt „true“ zurück, wenn die beginnende Teilzeichenfolge gefunden wurde. Gibt „false“ zurück, wenn sie nicht gefunden wurde.

Beispiel 1

In diesem Beispiel wird überprüft, ob die Zeichenfolge „hello world“ mit der Teilzeichenfolge „world“ beginnt:

startsWith('hello world', 'hello')

Dies ist das zurückgegebene Ergebnis: true

Beispiel 2

In diesem Beispiel wird überprüft, ob die Zeichenfolge „hello world“ mit der Teilzeichenfolge „greetings“ beginnt:

startsWith('hello world', 'greetings')

Dies ist das zurückgegebene Ergebnis: false

Zeichenfolge

Gibt die Zeichenfolgenversion für einen Wert zurück.

string(<value>)
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja Any Der zu konvertierende Wert
Rückgabewert type BESCHREIBUNG
<string-value> String Die Zeichenfolgenversion des angegebenen Werts

Beispiel 1

In diesem Beispiel wird die Zeichenfolgenversion dieser Zahl erstellt:

string(10)

Dies ist das zurückgegebene Ergebnis: "10"

Beispiel 2

In diesem Beispiel wird eine Zeichenfolge für das angegebene JSON-Objekt erstellt, und der umgekehrte Schrägstrich (\) wird als Escapezeichen für die doppelten Anführungszeichen (") verwendet.

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

Dies ist das zurückgegebene Ergebnis: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

Gibt das Ergebnis der Subtraktion einer Zahl von einer anderen Zahl zurück.

sub(<minuend>, <subtrahend>)
Parameter Erforderlich Type BESCHREIBUNG
<minuend> Ja Integer oder Float Die Zahl, von der subtrahend subtrahiert werden soll
<subtrahend> Ja Integer oder Float Die Zahl, die von minuend subtrahiert werden soll
Rückgabewert type Beschreibung des Dataflows
<result> Integer oder Float Das Ergebnis aus der Subtraktion der zweiten Zahl von der ersten Zahl

Beispiel

In diesem Beispiel wird die zweite Zahl von der ersten Zahl subtrahiert:

sub(10.3, .3)

Dies ist das zurückgegebene Ergebnis: 10

substring

Gibt Zeichen aus einer Zeichenfolge zurück, beginnend mit dem angegebenen Indexwert (Position). Indexwerte beginnen bei 0.

substring('<text>', <startIndex>, <length>)
Parameter Erforderlich Type BESCHREIBUNG
<text> Ja String Die Zeichenfolge, aus der die Zeichen zurückgegeben werden sollen
<startIndex> Ja Integer Eine positive Zahl gleich oder größer als 0, die Sie als Ausgangswert oder Indexwert verwenden können.
<length> Ja Integer Eine positive Anzahl von Zeichen, die in der Teilzeichenfolge enthalten sein sollen
Rückgabewert type BESCHREIBUNG
<substring-result> String Eine Teilzeichenfolge, die die angegebene Anzahl von Zeichen enthält und in der Quellzeichenfolge an der angegebenen Indexposition beginnt

Beispiel

In diesem Beispiel wird aus der angegebenen Zeichenfolge ab dem Indexwert 6 eine Teilzeichenfolge mit fünf Zeichen erstellt:

substring('hello world', 6, 5)

Dies ist das zurückgegebene Ergebnis: "world"

subtractFromTime

Subtrahiert eine Anzahl von Zeiteinheiten von einem Zeitstempel. Siehe auch getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge, die den Zeitstempel enthält
<interval> Ja Integer Die Anzahl der angegebenen Zeiteinheiten, die subtrahiert werden sollen
<timeUnit> Ja String Die mit interval zu verwendende Zeiteinheit: Second, Minute, Hour, Day, Week, Month, Year
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<updated-timestamp> String Der Zeitstempel abzüglich der angegebenen Anzahl von Zeiteinheiten

Beispiel 1

In diesem Beispiel wird ein Tag von diesem Zeitstempel subtrahiert:

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

Dies ist das zurückgegebene Ergebnis: "2018-01-01T00:00:00:0000000Z"

Beispiel 2

In diesem Beispiel wird ein Tag von diesem Zeitstempel subtrahiert:

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

Dies ist das zurückgegebene Ergebnis mit dem optionalen „D“-Format: "Monday, January, 1, 2018"

take

Gibt Elemente vom Anfang einer Sammlung zurück.

take('<collection>', <count>)
take([<collection>], <count>)
Parameter Erforderlich Type BESCHREIBUNG
<collection> Ja Zeichenfolge oder Array Die Sammlung, aus der Sie Elemente abrufen möchten
<count> Ja Integer Eine positive ganze Zahl für die Anzahl von Elementen, die ab dem Anfang abgerufen werden sollen
Rückgabewert type Beschreibung
<subset> oder [<subset>] Zeichenfolge bzw. Array Eine Zeichenfolge oder ein Array, die oder das die angegebene Anzahl von Elementen ab dem Anfang der ursprünglichen Sammlung enthält

Beispiel

In diesen Beispielen wird die angegebene Anzahl von Elementen ab dem Anfang dieser Sammlungen abgerufen:

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

Dies sind die zurückgegebenen Ergebnisse:

  • Erstes Beispiel: "abc"
  • Zweites Beispiel: [0, 1, 2]

ticks

Gibt den Eigenschaftswert ticks für einen angegebenen Zeitstempel zurück. Ein tick ist eine Zeitspanne von 100 Nanosekunden.

ticks('<timestamp>')
Parameter Erforderlich Type BESCHREIBUNG
<timestamp> Ja String Die Zeichenfolge für einen Zeitstempel
Rückgabewert type BESCHREIBUNG
<ticks-number> Integer Die Anzahl der Ticks, die seit 00:00:00 Uhr, 1. Januar 0001 im gregorianischen Kalender seit dem Eingabezeitstempel vergangen sind

toLower

Gibt eine Zeichenfolge in Kleinbuchstaben zurück. Gibt es für ein Zeichen in der Zeichenfolge keine Kleinschreibungsversion, verbleibt dieses Zeichen unverändert in der zurückgegebenen Zeichenfolge.

toLower('<text>')
Parameter Erforderlich Type BESCHREIBUNG
<text> Ja String Die Zeichenfolge, die in Kleinbuchstaben zurückgegeben werden soll
Rückgabewert type BESCHREIBUNG
<lowercase-text> String Die ursprüngliche Zeichenfolge in Kleinbuchstaben

Beispiel

In diesem Beispiel wird diese Zeichenfolge in Kleinbuchstaben konvertiert:

toLower('Hello World')

Dies ist das zurückgegebene Ergebnis: "hello world"

toUpper

Gibt eine Zeichenfolge in Großbuchstaben zurück. Gibt es für ein Zeichen in der Zeichenfolge keine Großschreibungsversion, verbleibt dieses Zeichen unverändert in der zurückgegebenen Zeichenfolge.

toUpper('<text>')
Parameter Erforderlich Type BESCHREIBUNG
<text> Ja String Die Zeichenfolge, die in Großbuchstaben zurückgegeben werden soll
Rückgabewert type BESCHREIBUNG
<uppercase-text> String Die ursprüngliche Zeichenfolge in Großbuchstaben

Beispiel

In diesem Beispiel wird diese Zeichenfolge in Großbuchstaben konvertiert:

toUpper('Hello World')

Dies ist das zurückgegebene Ergebnis: "HELLO WORLD"

trim

Entfernt führende und nachfolgende Leerzeichen aus einer Zeichenfolge und gibt die aktualisierte Zeichenfolge zurück.

trim('<text>')
Parameter Erforderlich Type BESCHREIBUNG
<text> Ja String Die Zeichenfolge, in der sich die führenden und nachfolgende Leerzeichen befinden, die entfernt werden sollen
Rückgabewert type BESCHREIBUNG
<updatedText> String Eine aktualisierte Version der ursprünglichen Zeichenfolge ohne führende oder nachfolgende Leerzeichen

Beispiel

In diesem Beispiel werden das führende und das nachgestellte Leerzeichen aus der Zeichenfolge „ Hello World “ entfernt:

trim(' Hello World  ')

Dies ist das zurückgegebene Ergebnis: "Hello World"

union

Gibt eine Sammlung zurück, die sämtliche Elemente aus den angegebenen Sammlungen enthält. Damit ein Element im Ergebnis enthalten ist, kann es in irgendeiner der Sammlungen enthalten sein, die an diese Funktion übergeben werden. Haben mehrere Elemente denselben Namen, enthält das Ergebnis das letzte Element mit diesem Namen.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parameter Erforderlich Type Beschreibung
<collection1>, <collection2>, ... Ja Array oder Objekt, aber nicht beide Die Sammlungen, aus denen Sie alle Elemente wünschen
Rückgabewert type BESCHREIBUNG
<updatedCollection> Array bzw. Objekt Eine Sammlung mit allen Elementen aus den angegebenen Sammlungen – keine Duplikate

Beispiel

In diesem Beispiel werden alle Elemente aus diesen Auflistungen abgerufen:

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

Dies ist das zurückgegebene Ergebnis: [1, 2, 3, 10, 101]

uriComponent

Gibt eine URI-codierte (Uniform Resource Identifier) Version für eine Zeichenfolge zurück, indem URL-unsichere Zeichen durch Escapezeichen ersetzt werden. Verwenden Sie diese Funktion anstelle von encodeUriComponent(). Obwohl beide Funktionen in gleicher Weise funktionieren, wird uriComponent() bevorzugt.

uriComponent('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die Zeichenfolge, die in das URI-codierte Format konvertiert werden soll
Rückgabewert type BESCHREIBUNG
<encoded-uri> String Die URI-codierte Zeichenfolge mit Escapezeichen

Beispiel

In diesem Beispiel wird eine URI-codierte Version für diese Zeichenfolge erstellt:

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

Dies ist das zurückgegebene Ergebnis: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Gibt die binäre Version einer URI-Komponente (Uniform Resource Identifier) zurück.

uriComponentToBinary('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die URI-codierte Zeichenfolge, die konvertiert werden soll
Rückgabewert type BESCHREIBUNG
<binary-for-encoded-uri> String Die Binärversion für die URI-codierte Zeichenfolge Der binäre Inhalt ist base64-codiert und wird von $content dargestellt.

Beispiel

In diesem Beispiel wird die binäre Version für diese URI-codierte Zeichenfolge erstellt:

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

Dies ist das zurückgegebene Ergebnis:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Gibt die Zeichenfolgenversion einer URI-codierten Zeichenfolge (Uniform Resource Identifier) zurück, d. h., die URI-codierte Zeichenfolge wird decodiert.

uriComponentToString('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die URI-codierte Zeichenfolge, die decodiert werden soll
Rückgabewert type BESCHREIBUNG
<decoded-uri> String Die decodierte Version für die URI-codierte Zeichenfolge

Beispiel

In diesem Beispiel wird die decodierte Zeichenfolgenversion für diese URI-codierte Zeichenfolge erstellt:

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

Dies ist das zurückgegebene Ergebnis: "https://contoso.com"

utcNow

Gibt den aktuellen Zeitstempel zurück.

utcNow('<format>')

Optional können Sie mit dem <format>-Parameter ein anderes Format angeben.

Parameter Erforderlich Type BESCHREIBUNG
<format> Nein String Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
Rückgabewert type BESCHREIBUNG
<current-timestamp> String Das aktuelle Datum und die aktuelle Uhrzeit

Beispiel 1

Nehmen Sie an, heute ist der 15. April 2018, 13:00:00 Uhr. In diesem Beispiel wird der aktuelle Zeitstempel abgerufen:

utcNow()

Dies ist das zurückgegebene Ergebnis: "2018-04-15T13:00:00.0000000Z"

Beispiel 2

Nehmen Sie an, heute ist der 15. April 2018, 13:00:00 Uhr. In diesem Beispiel wird der aktuelle Zeitstempel mit dem optionalen „D“-Format abgerufen:

utcNow('D')

Dies ist das zurückgegebene Ergebnis: "Sunday, April 15, 2018"

Xml

Gibt die XML-Version einer Zeichenfolge zurück, die ein JSON-Objekt enthält.

xml('<value>')
Parameter Erforderlich Type BESCHREIBUNG
<value> Ja String Die Zeichenfolge mit dem JSON-Objekt, das konvertiert werden soll.

Das JSON-Objekt darf nur eine Stammeigenschaft haben, die kein Array sein darf.
Verwenden Sie den umgekehrten Schrägstrich (\) als Escapezeichen für das doppelte Anführungszeichen (").

Rückgabewert type BESCHREIBUNG
<xml-version> Object Das codierte XML-Objekt für die angegebene Zeichenfolge oder das angegebene JSON-Objekt

Beispiel 1

In diesem Beispiel wird die XML-Version für diese Zeichenfolge erstellt, die ein JSON-Objekt enthält:

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

Dies ist das zurückgegebene XML-Objekt:

<name>Sophia Owen</name>

Beispiel 2

Angenommen, Sie haben dieses JSON-Objekt:

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

In diesem Beispiel wird das XML-Objekt für eine Zeichenfolge erstellt, die dieses JSON-Objekt enthält:

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

Dies ist das zurückgegebene XML-Objekt:

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

xpath

Überprüft die XML auf Knoten oder Werte, die mit einem XPath-Ausdruck (XML Path Language) übereinstimmen, und gibt die übereinstimmenden Knoten oder Werte zurück. Ein XPath-Ausdruck oder einfach „XPath“ vereinfacht Ihnen das Navigieren in einer XML-Dokumentstruktur, sodass Sie im XML-Inhalt Knoten auswählen oder Werte berechnen können.

xpath('<xml>', '<xpath>')
Parameter Erforderlich Type BESCHREIBUNG
<xml> Ja Any Die XML-Zeichenfolge, in der nach Knoten oder Werten gesucht werden soll, die mit einem XPath-Ausdruckswert übereinstimmen
<xpath> Ja Any Der XPath-Ausdruck, der für die Suche nach übereinstimmenden XML-Knoten oder -Werten verwendet wird
Rückgabewert type BESCHREIBUNG
<xml-node> XML Ein XML-Knoten, wenn nur ein einziger Knoten mit dem angegebenen XPath-Ausdruck übereinstimmt
<value> Any Der Wert aus einem XML-Knoten, wenn nur ein einziger Wert mit dem angegebenen XPath-Ausdruck übereinstimmt
[<xml-node1>, <xml-node2>, ...]
-oder-
[<value1>, <value2>, ...]
Array Ein Array mit XML-Knoten oder -Werten, die mit den angegebenen XPath-Ausdruck übereinstimmen

Beispiel 1

Im Anschluss an das Beispiel 1 wird in diesem Beispiel nach Knoten gesucht, die mit dem <count></count>-Knoten übereinstimmen, und die Werte dieser Knoten werden mit der sum()-Funktion addiert:

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

Dies ist das zurückgegebene Ergebnis: 30

Beispiel 2

In diesem Beispiel wird in beiden Ausdrücken nach Knoten gesucht, die mit dem <location></location>-Knoten in den angegebenen Argumenten übereinstimmen, die XML mit einem Namespace enthalten. In den Ausdrücken wird der umgekehrte Schrägstrich (\) als Escapezeichen für das doppelte Anführungszeichen (") verwendet.

  • Ausdruck 1

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

  • Ausdruck 2

    xpath(xml(body('Http')), '/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]')

Dies sind die Argumente:

  • Dieses XML-Objekt, das den Namespace des XML-Dokument enthält, xmlns="http://contoso.com":

    <?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>
    
  • Dies sind die beiden XPath-Ausdrücke:

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

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

Dies ist der Ergebnisknoten, der mit dem <location></location>-Knoten übereinstimmt:

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

Beispiel 3

Im Anschluss an Beispiel 3 wird in diesem Beispiel nach dem der Wert im <location></location>-Knoten gesucht:

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

Dies ist das zurückgegebene Ergebnis: "Paris"

Hinweis

Sie können Kommentare zu Datenflussausdrücken hinzufügen, aber nicht zu Pipeline-Ausdrücken.

Eine Liste der Systemvariablen, die Sie in Ausdrücken verwenden können, finden Sie unter Systemvariablen.