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

Artikel
05/17/2024

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.

Anfügen des Datums an einen Dateinamen: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
Anfügen eines DateTime-Werts in der Zeitzone des Kunden: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
Anfügen eines TriggerTime-Werts: @concat('Test_', pipeline().TriggerTime)
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:

URL-Codierung für den ursprünglichen Zeichenfolgenwert
Ersetzen der URL-codierten Zeichenfolge, z. B. Zeilenvorschub (%0A), Wagenrücklauf (%0D), horizontaler Tabulator (%09)
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:

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.

Teilen über

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

Ausdrücke

Beispiele

Beispiel für komplexen Ausdruck

Editor für dynamische Inhalte

Ein Dataset mit einem Parameter

Eine Pipeline mit einem Parameter

Ersetzen von Sonderzeichen

Versehen eines einfachen Anführungszeichens mit Escapezeichen

Tutorial

Functions

Datumsfunktionen

Zeichenfolgenfunktionen

Auflistungsfunktionen

Logische Funktionen

Konvertierungsfunktionen

Mathematische Funktionen

Funktionsreferenz

add

addDays

addHours

addMinutes

addSeconds

addToTime

and

array

base64

base64ToBinary

base64ToString

BINARY

bool

coalesce

concat

contains

convertFromUtc

convertTimeZone

convertToUtc

createArray

dataUri

dataUriToBinary

dataUriToString

dayOfMonth

dayOfWeek

dayOfYear

decodeBase64

decodeDataUri

decodeUriComponent

div

encodeUriComponent

empty

endsWith

equals

first

float

formatDateTime

getFutureTime

getPastTime

greater

greaterOrEquals

guid

if

indexOf

INT

json

Schnittmenge

join

last

lastIndexOf

length

less

lessOrEquals

max

Min

mod

mul

not

oder

rand

range