Ausdrücke und Funktionen für Data Factory in Microsoft Fabric

Dieser Artikel enthält Details zu Ausdrücken und Funktionen, die von Data Factory in Microsoft Fabric unterstützt werden.

Ausdrücke

Ausdruckswerte in der Definition können Literale oder Ausdrücke sein, die zur Laufzeit ausgewertet werden. Beispiel:

"value"

oder

"@pipeline().parameters.password"

Ausdrücke können an einer beliebigen Stelle in einem Zeichenfolgenwert angezeigt werden und führen immer zu einem anderen Zeichenfolgenwert. Wenn ein Wert ein Ausdruck ist, wird der Textkörper des Ausdrucks extrahiert, indem das At-Sign (@) entfernt wird. Wenn eine Literalzeichenfolge erforderlich ist, die mit @beginnt, muss sie mithilfe von @@escaped werden. Die folgenden Beispiele zeigen, wie Ausdrücke ausgewertet werden.

Ausdruckswert	Ergebnis
"Parameter"	Die Zeichen "Parameter" werden zurückgegeben.
"parameters[1]"	Die Zeichen "Parameters[1]" werden zurückgegeben.
"@@"	Es wird eine 1-Zeichenfolge zurückgegeben, die '@' enthält.
" @"	Es wird eine 2-Zeichenfolge zurückgegeben, die "@" enthält.

Ausdrücke können auch innerhalb von Zeichenfolgen angezeigt werden, wobei ein Feature namens Zeichenfolgeninterpolation verwendet wird, in @{ ... }das Ausdrücke eingeschlossen werden. Beispiel: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Bei Verwendung der Zeichenfolgeninterpolation ist das Ergebnis immer eine Zeichenfolge. Sagen Sie, ich habe folgendes definiertmyNumber:42myStringfoo

Ausdruckswert	Ergebnis
"@pipeline().parameters.myString"	Gibt foo als Zeichenfolge zurück.
"@{pipeline().parameters.myString}"	Gibt foo als Zeichenfolge zurück.
"@pipeline().parameters.myNumber"	Gibt als Zahl zurück42.
"@{pipeline().parameters.myNumber}"	Gibt 42 als Zeichenfolge zurück.
"Antwort ist: @{pipeline().parameters.myNumber}"	Gibt die Zeichenfolge Answer is: 42zurück.
"@concat('Antwort lautet: ', string(pipeline().parameters.myNumber))"	Gibt die Zeichenfolge zurück. Answer is: 42
"Antwort ist: @@{pipeline().parameters.myNumber}"	Gibt die Zeichenfolge Answer is: @{pipeline().parameters.myNumber}zurück.

In den Steuerungsflussaktivitäten wie forEach-Aktivität können Sie ein Array bereitstellen, das für die Eigenschaftselemente durchlaufen und zum Durchlaufen einer einzelnen Enumeration in forEach-Aktivität verwendet @item() wird. Wenn z. B. Elemente ein Array sind: [1, 2, 3], @item() gibt 1 in der ersten Iteration, 2 in der zweiten Iteration und 3 in der dritten Iteration zurück. Sie können auch einen ähnlichen Ausdruck verwenden @range(0,10) , um 10 Mal zu durchlaufen, beginnend mit 0, das mit 9 endet.

Sie können "Aktivitätsname" verwenden @activity(, um die Ausgabe von Aktivitäten zu erfassen und Entscheidungen zu treffen. Betrachten Sie eine Webaktivität namens "Web1". Wenn Sie die Ausgabe der ersten Aktivität im Textkörper der zweiten Aktivität platzieren möchten, sieht der Ausdruck im Allgemeinen wie folgt aus: @activity('Web1').output oder @activity('Web1').output.data oder etwas ähnliches, je nachdem, wie die Ausgabe der ersten Aktivität aussieht.

Examples

Beispiel für komplexe Ausdrücke

Das folgende Beispiel zeigt ein komplexes Beispiel, das auf ein tiefes Unterfeld der Aktivitätsausgabe verweist. Um auf einen Pipelineparameter zu verweisen, der zu einem Unterfeld ausgewertet wird, verwenden Sie die [] Syntax anstelle des Operators dot(.) (wie im Fall von Unterfeld1 und Unterfeld2), als Teil einer Aktivitätsausgabe.

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

Das dynamische Erstellen von Dateien und das Benennen dieser Dateien ist ein gängiges Muster. Lassen Sie uns einige Beispiele für dynamische Dateibenennung untersuchen.

• Anfügen des Datums an einen Dateinamen: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
• Anfügen von DateTime in der Kundenzeitzone: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
• Anfügezeit: @concat('Test_', pipeline().TriggerTime)
• Geben Sie einen benutzerdefinierten Dateinamen in einem Zuordnungsdatenfluss aus, wenn sie in eine einzelne Datei mit Datum ausgegeben werden: 'Test_' + toString(currentDate()) + '.csv'

In den oben genannten Fällen werden vier dynamische Dateinamen erstellt, beginnend mit Test_.

Dynamischer Inhalts-Editor

Der dynamische Inhalts-Editor escapet Zeichen in Ihren Inhalten automatisch, wenn Sie die Bearbeitung abgeschlossen haben. Der folgende Inhalt im Inhalts-Editor ist beispielsweise eine Zeichenfolgeninterpolation mit einer Ausdrucksfunktion.

"@{toUpper('myData')}"

Der dynamische Inhalts-Editor konvertiert oberhalb von Inhalt in Ausdruck "@{toUpper('myData')}". Das Ergebnis dieses Ausdrucks ist die formatierte Zeichenfolge unten.

"MYDATA"

Ersetzen von Sonderzeichen

Der dynamische Inhalts-Editor escapet Automatisch Zeichen wie doppelte Anführungszeichen, umgekehrten Schrägstrich in Ihren Inhalten, wenn Sie die Bearbeitung abgeschlossen haben. Dies führt zu Problemen, wenn Sie zeilenvorschub oder tabulatoren möchten, indem Sie \n, \t in replace() -Funktion verwenden. Sie können ihren dynamischen Inhalt in der Codeansicht bearbeiten, um das Zusätzliche \ im Ausdruck zu entfernen, oder Sie können die folgenden Schritte ausführen, um Sonderzeichen mithilfe der Ausdruckssprache zu ersetzen:

1. URL-Codierung für den ursprünglichen Zeichenfolgenwert
2. Ersetzen Sie URL-codierte Zeichenfolge, z. B. Zeilenvorschub (%0A), Wagenrücklauf(%0D), horizontale Tab(%09).
3. URL-Decodierung

Beispiel: Variable companyName mit einem Neuenlinezeichen in seinem Wert, Ausdruck @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) kann das Neuelinezeichen entfernen.

Contoso- Corporation

Einfaches Anführungszeichen entfernen

Ausdrucksfunktionen verwenden ein einfaches Anführungszeichen für Zeichenfolgenwertparameter. Verwenden Sie zwei einfache Anführungszeichen, um ein ' Zeichen in Zeichenfolgenfunktionen zu escapen. Der Ausdruck @concat('Baba', '''s ', 'book store') gibt z. B. das Ergebnis unter dem Ergebnis zurück.

Baba's book store

Pipelinebereichsvariablen

Auf diese Systemvariablen kann überall in der Pipeline verwiesen werden.

Variablenname	Description
@pipeline().DataFactory	ID des Arbeitsbereichs, in dem die Pipeline ausgeführt wird
@pipeline().Pipeline	ID der Pipeline
@pipeline().PipelineName	Name der Pipeline
@pipeline().RunId	ID der bestimmten Pipelineausführung
@pipeline().TriggerId	ID des Triggers, der die Pipeline aufgerufen hat
@pipeline().TriggerName	Name des Triggers, der die Pipeline aufgerufen hat
@pipeline().TriggerTime	Der Zeitpunkt des Triggerlaufs, der die Pipeline aufgerufen hat. Dies ist der Zeitpunkt, zu dem der Trigger tatsächlich ausgelöst wurde, um die Pipelineausführung aufzurufen, und es kann sich geringfügig von der geplanten Zeit des Triggers unterscheiden.
@pipeline().GroupId	ID der Gruppe, zu der die Pipelineausführung gehört.
@pipeline()?. TriggeredByPipelineName	Name der Pipeline, die die Pipelineausführung auslöst. Gilt, wenn die Pipelineausführung durch eine ExecutePipeline-Aktivität ausgelöst wird. Bei Verwendung unter anderen Umständen auf Null ausgewertet. Notieren Sie sich das Fragezeichen nach @pipeline()
@pipeline()?. TriggeredByPipelineRunId	Run-ID der Pipeline, die die Pipelineausführung auslöst. Gilt, wenn die Pipelineausführung durch eine ExecutePipeline-Aktivität ausgelöst wird. Bei Verwendung unter anderen Umständen auf Null ausgewertet. Notieren Sie sich das Fragezeichen nach @pipeline()

Hinweis

Triggerbezogene Datums-/Uhrzeit-Systemvariablen (sowohl in Pipeline- als auch Triggerbereichen) geben UTC-Datumsangaben im ISO 8601-Format zurück, 2017-06-01T22:20:00.4061448Zz. B. .

Funktionen

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 Uhrzeitfunktion	Aufgabe
addDays	Add a number of days to a timestamp.
addHours	Fügen Sie einem Zeitstempel eine Anzahl von Stunden hinzu.
addMinutes	Add a number of minutes to a timestamp.
addSeconds	Fügen Sie einem Zeitstempel eine Anzahl von Sekunden hinzu.
addToTime	Fügen Sie einem Zeitstempel eine Anzahl von Zeiteinheiten hinzu. Siehe auch getFutureTime.
convertFromUtc	Wandeln Sie einen Zeitstempel von Universal Time Coordinated (UTC) in die Zielzeitzone um.
convertTimeZone	Wandeln Sie einen Zeitstempel aus der Quellzeitzone in die Zielzeitzone um.
convertToUtc	Wandeln Sie einen Zeitstempel aus der Quellzeitzone in koordinierte Weltzeit (UTC) um.
dayOfMonth	Gibt den Tag der Monatskomponente aus einem Zeitstempel zurück.
dayOfWeek	Gibt den Wochentag aus einem Zeitstempel zurück.
dayOfYear	Gibt den Tag der Jahreskomponente aus einem Zeitstempel zurück.
formatDateTime	Gibt den Zeitstempel als Zeichenfolge im optionalen Format zurück.
getFutureTime	Gibt den aktuellen Zeitstempel plus der angegebenen Zeiteinheiten zurück. Siehe auch addToTime.
getPastTime	Gibt den aktuellen Zeitstempel minus der angegebenen Zeiteinheiten zurück. Siehe auch subtrahierenFromTime.
startOfDay	Gibt den Anfang des Tages für einen Zeitstempel zurück.
startOfHour	Gibt den Anfang der Stunde für einen Zeitstempel zurück.
startOfMonth	Gibt den Anfang des Monats für einen Zeitstempel zurück.
subtrahierenFromTime	Subtrahieren Sie eine Anzahl von Zeiteinheiten von einem Zeitstempel. Siehe auch getPastTime.
zecken	Gibt den ticks Eigenschaftswert für einen angegebenen Zeitstempel zurück.
utcNow	Gibt den aktuellen Zeitstempel als Zeichenfolge zurück.

Zeichenfolgenfunktionen

Um mit Zeichenfolgen zu arbeiten, können Sie diese Zeichenfolgenfunktionen und auch einige Sammlungsfunktionen verwenden. Zeichenfolgenfunktionen funktionieren nur für Zeichenfolgen.

String-Funktion	Aufgabe
Verkettung	Kombinieren Sie zwei oder mehr Zeichenfolgen, und geben Sie die kombinierte Zeichenfolge zurück.
endsWith	Überprüfen Sie, ob eine Zeichenfolge mit der angegebenen Teilzeichenfolge endet.
GUID	Generieren Sie eine GUID (Globally Unique Identifier) als Zeichenfolge.
indexOf	Gibt die Startposition für eine Teilzeichenfolge zurück.
lastIndexOf	Gibt die Anfangsposition für das letzte Vorkommen einer Teilzeichenfolge zurück.
replace	Ersetzen Sie eine Teilzeichenfolge durch die angegebene Zeichenfolge, und geben Sie die aktualisierte Zeichenfolge zurück.
trennen	Gibt ein Array zurück, das Teilzeichenfolgen enthält, die durch Kommas getrennt sind, von einer größeren Zeichenfolge basierend auf einem angegebenen Trennzeichen in der ursprünglichen Zeichenfolge.
startsWith	Überprüfen Sie, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge beginnt.
Teilzeichenfolge	Zurückgeben von Zeichen aus einer Zeichenfolge, beginnend mit der angegebenen Position.
toLower	Zurückgeben einer Zeichenfolge im Kleinbuchstabenformat.
toUpper	Gibt eine Zeichenfolge im Großbuchstabenformat zurück.
stutzen	Entfernen Sie führende und nachfolgende Leerzeichen aus einer Zeichenfolge, und geben Sie die aktualisierte Zeichenfolge zurück.

Auflistungsfunktionen

Zum Arbeiten mit Auflistungen, im Allgemeinen Arrays, Zeichenfolgen und manchmal wörterbüchern, können Sie diese Sammlungsfunktionen verwenden.

Sammlungsfunktion	Aufgabe
enthält	Überprüfen Sie, ob eine Sammlung über ein bestimmtes Element verfügt.
leer	Überprüfen Sie, ob eine Sammlung leer ist.
erste	Gibt das erste Element aus einer Auflistung zurück.
Schnittpunkt	Gibt eine Auflistung zurück, die nur die allgemeinen Elemente in den angegebenen Auflistungen enthält.
verbinden	Gibt eine Zeichenfolge zurück, die alle Elemente aus einem Array enthält, getrennt durch das angegebene Zeichen.
letzte	Gibt das letzte Element aus einer Auflistung zurück.
Länge	Gibt die Anzahl der Elemente in einer Zeichenfolge oder einem Array zurück.
hüpfen	Entfernen Sie Elemente aus der Vorderseite einer Auflistung, und geben Sie alle anderen Elemente zurück.
take	Gibt Elemente von vorne in einer Auflistung zurück.
Vereinigung	Gibt eine Auflistung zurück, die alle Elemente aus den angegebenen Auflistungen enthält.

Logische Funktionen

Diese Funktionen sind nützlich in Bedingungen, sie können verwendet werden, um jede Art von Logik auszuwerten.

Logische Vergleichsfunktion	Aufgabe
und	Überprüfen Sie, ob alle Ausdrücke wahr sind.
gleich	Überprüfen Sie, ob beide Werte gleichwertig sind.
größer	Überprüfen Sie, ob der erste Wert größer als der zweite Wert ist.
greaterOrEquals	Überprüfen Sie, ob der erste Wert größer oder gleich dem zweiten Wert ist.
if	Überprüfen Sie, ob ein Ausdruck wahr oder falsch ist. Geben Sie basierend auf dem Ergebnis einen angegebenen Wert zurück.
weniger	Überprüfen Sie, ob der erste Wert kleiner als der zweite Wert ist.
lessOrEquals	Überprüfen Sie, ob der erste Wert kleiner oder gleich dem zweiten Wert ist.
nicht	Überprüfen Sie, ob ein Ausdruck falsch ist.
oder	Überprüfen Sie, ob mindestens ein Ausdruck wahr ist.

Konvertierungsfunktionen

Diese Funktionen werden verwendet, um zwischen jedem der systemeigenen Typen in der Sprache zu konvertieren:

• Schnur
• Integer
• Schweben
• boolean
• Felder
• Wörterbücher

Konvertierungsfunktion	Aufgabe
array	Zurückgeben eines Arrays aus einer einzelnen angegebenen Eingabe. Mehrere Eingaben finden Sie unter createArray.
Base64	Gibt die base64-codierte Version für eine Zeichenfolge zurück.
base64ToBinary	Gibt die binäre Version für eine base64-codierte Zeichenfolge zurück.
base64ToString	Gibt die Zeichenfolgenversion für eine base64-codierte Zeichenfolge zurück.
binär	Gibt die binäre Version für einen Eingabewert zurück.
Bool	Gibt die boolesche Version für einen Eingabewert zurück.
zusammenfügen	Gibt den ersten Wert ungleich Null aus einem oder mehreren Parametern 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äre Version 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äre Version für einen Daten-URI zurück.
decodeUriComponent	Gibt eine Zeichenfolge zurück, die Escapezeichen durch decodierte Versionen ersetzt.
encodeUriComponent	Zurückgeben einer Zeichenfolge, die URL-unsichere Zeichen durch Escapezeichen ersetzt.
float	Gibt eine Gleitkommazahl für einen Eingabewert zurück.
int	Gibt die ganzzahlige Version für eine Zeichenfolge 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äre Version 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üfen Sie XML auf Knoten oder Werte, die einem XPath-Ausdruck (XML Path Language) entsprechen, und geben Sie die übereinstimmenden Knoten oder Werte zurück.

Mathematische Funktionen

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

Mathematische Funktion	Aufgabe
add	Gibt das Ergebnis aus dem Hinzufügen von zwei Zahlen zurück.
Div	Gibt das Ergebnis aus dem Dividieren von zwei Zahlen 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 zurück, indem zwei Zahlen dividiert werden.
mul	Gibt das Produkt aus der Multiplikation von zwei Zahlen zurück.
Rand	Gibt eine zufällige ganze Zahl aus einem angegebenen Bereich zurück.
Bereich	Gibt ein ganzzahliges Array zurück, das mit einer angegebenen ganzzahligen Zahl beginnt.
sub	Gibt das Ergebnis vom Subtrahieren der zweiten Zahl von der ersten Zahl zurück.

Funktionsreferenz

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

add

Gibt das Ergebnis aus dem Hinzufügen von zwei Zahlen zurück.

add(<summand_1>, <summand_2>)

Parameter	Erforderlich	Typ	Description
< >summand_1, <summand_2>	Yes	Ganze Zahl, Float oder gemischt	Die hinzuzufügenden Zahlen

Rückgabewert	Typ	Description
< Ergebnissumme>	Ganze Zahl oder Float	Das Ergebnis des Hinzufügens der angegebenen Zahlen

Beispiel

In diesem Beispiel werden die angegebenen Zahlen hinzugefügt:

add(1, 1.5)

Und gibt dieses Ergebnis zurück: 2.5

addDays

Add a number of days to a timestamp.

addDays('<timestamp>', <days>, '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge, die den Zeitstempel enthält
< Tage>	Yes	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" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Aktualisierter Zeitstempel>	String	Der Zeitstempel plus der angegebenen Anzahl von Tagen

Beispiel 1

In diesem Beispiel werden dem angegebenen Zeitstempel 10 Tage hinzugefügt:

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

Und gibt dieses Ergebnis zurück: "2018-03-25T00:00:0000000Z"

Beispiel 2

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

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

Und gibt dieses Ergebnis zurück: "2018-03-10T00:00:0000000Z"

addHours

Fügen Sie einem Zeitstempel eine Anzahl von Stunden hinzu.

addHours('<timestamp>', <hours>, '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge, die den Zeitstempel enthält
< Stunden>	Yes	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" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Aktualisierter Zeitstempel>	String	Der Zeitstempel plus der angegebenen Anzahl von Stunden

Beispiel 1

In diesem Beispiel werden dem angegebenen Zeitstempel 10 Stunden hinzugefügt:

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

Und gibt dieses Ergebnis zurück: "2018-03-15T10:00:0000000Z"

Beispiel 2

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

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

Und gibt dieses Ergebnis zurück: "2018-03-15T10:00:0000000Z"

addMinutes

Add a number of minutes to a timestamp.

addMinutes('<timestamp>', <minutes>, '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge, die den Zeitstempel enthält
< Protokoll>	Yes	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" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Aktualisierter Zeitstempel>	String	Der Zeitstempel plus der angegebenen Anzahl von Minuten

Beispiel 1

In diesem Beispiel werden dem angegebenen Zeitstempel 10 Minuten hinzugefügt:

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

Und gibt dieses Ergebnis zurück: "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)

Und gibt dieses Ergebnis zurück: "2018-03-15T00:15:00.0000000Z"

addSeconds

Fügen Sie einem Zeitstempel eine Anzahl von Sekunden hinzu.

addSeconds('<timestamp>', <seconds>, '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge, die den Zeitstempel enthält
< Nachschlag>	Yes	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" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Aktualisierter Zeitstempel>	String	Der Zeitstempel plus der angegebenen Anzahl von Sekunden

Beispiel 1

In diesem Beispiel werden dem angegebenen Zeitstempel 10 Sekunden hinzugefügt:

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

Und gibt dieses Ergebnis zurück: "2018-03-15T00:00:10.0000000Z"

Beispiel 2

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

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

Und gibt dieses Ergebnis zurück: "2018-03-15T00:00:25.0000000Z"

addToTime

Fügen Sie einem Zeitstempel eine Anzahl von Zeiteinheiten hinzu. Siehe auch getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge, die den Zeitstempel enthält
< Intervall>	Yes	Integer	Die Anzahl der angegebenen Zeiteinheiten, die hinzugefügt werden sollen
< timeUnit>	Yes	String	Die Zeiteinheit, die mit Intervall verwendet werden soll: "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" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Aktualisierter Zeitstempel>	String	Der Zeitstempel plus die angegebene Anzahl von Zeiteinheiten

Beispiel 1

In diesem Beispiel wird dem angegebenen Zeitstempel ein Tag hinzugefügt:

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

Und gibt dieses Ergebnis zurück: "2018-01-02T00:00:00.0000000Z"

Beispiel 2

In diesem Beispiel wird dem angegebenen Zeitstempel ein Tag hinzugefügt:

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

Und gibt das Ergebnis mithilfe des optionalen "D"-Formats zurück: "Tuesday, January 2, 2018"

und

Überprüfen Sie, ob beide Ausdrücke wahr sind. Gibt "true" zurück, wenn beide Ausdrücke wahr sind oder "false" zurückgeben, wenn mindestens ein Ausdruck falsch ist.

and(<expression1>, <expression2>)

Parameter	Erforderlich	Typ	Description
< Expression1>, <Expression2>	Yes	Boolean	Zu überprüfende Ausdrücke

Rückgabewert	Typ	Description
true oder false	Boolean	Gibt true zurück, wenn beide Ausdrücke wahr sind. Gibt "false" zurück, wenn mindestens ein Ausdruck falsch ist.

Beispiel 1

In diesen Beispielen wird überprüft, ob die angegebenen booleschen Werte beide wahr sind:

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

Und gibt diese Ergebnisse zurück:

• First example: Both expressions are true, so returns true.
• Second example: One expression is false, so returns false.
• Drittes Beispiel: Beide Ausdrücke sind falsch, daher wird zurückgegeben false.

Beispiel 2

In diesen Beispielen wird überprüft, ob die angegebenen Ausdrücke beide wahr sind:

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

Und gibt diese Ergebnisse zurück:

• First example: Both expressions are true, so returns true.
• Second example: One expression is false, so returns false.
• Drittes Beispiel: Beide Ausdrücke sind falsch, daher wird zurückgegeben false.

Array

Zurückgeben eines Arrays aus einer einzelnen angegebenen Eingabe. Mehrere Eingaben finden Sie unter createArray().

array('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die Zeichenfolge zum Erstellen eines Arrays

Rückgabewert	Typ	Description
[<Wert>]	Array	Ein Array, das die einzelne angegebene Eingabe enthält

Beispiel

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

array('hello')

Und gibt dieses Ergebnis zurück: ["hello"]

Base64

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

base64('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die Eingabezeichenfolge

Rückgabewert	Typ	Description
< base64-string>	String	Die base64-codierte Version für die Eingabezeichenfolge

Beispiel

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

base64('hello')

Und gibt dieses Ergebnis zurück: "aGVsbG8="

base64ToBinary

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

base64ToBinary('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die base64-codierte Zeichenfolge, die konvertiert werden soll

Rückgabewert	Typ	Description
< binary-for-base64-string>	String	Die binäre Version für die base64-codierte Zeichenfolge

Beispiel

In diesem Beispiel wird die base64-codierte Zeichenfolge "aGVsbG8=" in eine binäre Zeichenfolge konvertiert:

base64ToBinary('aGVsbG8=')

Und gibt dieses Ergebnis zurück:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Gibt die Zeichenfolgenversion für eine base64-codierte Zeichenfolge zurück, die die base64-Zeichenfolge effektiv decodiert. Verwenden Sie diese Funktion anstelle der DecodierungBase64(). Obwohl beide Funktionen auf die gleiche Weise funktionieren, base64ToString() wird bevorzugt.

base64ToString('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die base64-codierte Zeichenfolge zum Decodieren

Rückgabewert	Typ	Description
< decoded-base64-string>	String	Die Zeichenfolgenversion für eine base64-codierte Zeichenfolge

Beispiel

In diesem Beispiel wird die base64-codierte Zeichenfolge "aGVsbG8=" in eine Zeichenfolge konvertiert:

base64ToString('aGVsbG8=')

Und gibt dieses Ergebnis zurück: "hello"

binär

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

binary('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die zu konvertierende Zeichenfolge

Rückgabewert	Typ	Description
< binary-for-input-value>	String	Die binäre Version für die angegebene Zeichenfolge

Beispiel

In diesem Beispiel wird die Zeichenfolge "hello" in eine binäre Zeichenfolge konvertiert:

binary('hello')

Und gibt dieses Ergebnis zurück:

"0110100001100101011011000110110001101111"

Boolesch

Gibt die boolesche Version für einen Wert zurück.

bool(<value>)

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	Beliebig	Der zu konvertierende Wert

Rückgabewert	Typ	Description
true oder false	Boolean	Die boolesche Version für den angegebenen Wert

Beispiel

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

bool(1)
bool(0)

Und gibt diese Ergebnisse zurück:

• Erstes Beispiel: true
• Zweites Beispiel: false

zusammenwachsen

Gibt den ersten Wert ungleich Null aus einem oder mehreren Parametern zurück. Leere Zeichenfolgen, leere Arrays und leere Objekte sind nicht NULL.

coalesce(<object_1>, <object_2>, ...)

Parameter	Erforderlich	Typ	Description
< >object_1, <object_2>, ...	Yes	Beliebig, kann Typen mischen	Mindestens ein Element, das auf NULL überprüft werden soll

Rückgabewert	Typ	Description
< first-non-null-item>	Beliebig	Das erste Element oder der erste Wert, der nicht NULL ist. Wenn alle Parameter null sind, gibt diese Funktion NULL zurück.

Beispiel

In diesen Beispielen wird der erste Wert ungleich Null aus den angegebenen Werten oder NULL zurückgegeben, wenn alle Werte null sind:

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

Und gibt diese Ergebnisse zurück:

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

concat

Kombinieren Sie zwei oder mehr Zeichenfolgen, und geben Sie die kombinierte Zeichenfolge zurück.

concat('<text1>', '<text2>', ...)

Parameter	Erforderlich	Typ	Description
< text1>, <text2>, ...	Yes	String	Mindestens zwei zu kombinierende Zeichenfolgen

Rückgabewert	Typ	Description
< text1text2...>	String	Die aus den kombinierten Eingabezeichenfolgen erstellte Zeichenfolge

Beispiel

In diesem Beispiel werden die Zeichenfolgen "Hello" und "World" kombiniert:

concat('Hello', 'World')

Und gibt dieses Ergebnis zurück: "HelloWorld"

contains

Überprüfen Sie, ob eine Sammlung über ein bestimmtes Element verfügt. Gibt "true" zurück, wenn das Element gefunden wird, oder "false" zurück, wenn es nicht gefunden wurde. Bei dieser Funktion wird die Groß-/Kleinschreibung beachtet.

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

Insbesondere funktioniert diese Funktion für diese Sammlungstypen:

• Eine Zeichenfolge zum Suchen einer Teilzeichenfolge
• Ein Array zum Suchen eines Werts
• Ein Wörterbuch zum Suchen eines Schlüssels

Parameter	Erforderlich	Typ	Description
< Sammlung>	Yes	Zeichenfolge, Array oder Wörterbuch	Die zu überprüfende Sammlung
< Wert>	Yes	String, Array oder Dictionary, bzw. Wörterbuch	Das element, das gesucht werden soll

Rückgabewert	Typ	Description
true oder false	Boolean	Gibt true zurück, wenn das Element gefunden wird. Gibt "false" zurück, wenn er nicht gefunden wurde.

Beispiel 1

In diesem Beispiel wird die Zeichenfolge "hello world" für die Teilzeichenfolge "world" überprüft und "true" zurückgegeben:

contains('hello world', 'world')

Beispiel 2

In diesem Beispiel wird die Zeichenfolge "hello world" für die Teilzeichenfolge "universe" überprüft und "false" zurückgegeben:

contains('hello world', 'universe')

convertFromUtc

Wandeln Sie einen Zeitstempel von Universal Time Coordinated (UTC) in die Zielzeitzone um.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge, die den Zeitstempel enthält
< destinationTimeZone>	Yes	String	Der Name für die Zielzeitzone. Informationen zu Zeitzonennamen finden Sie unter Microsoft-Zeitzonenwerte. Möglicherweise müssen Sie jedoch alle Interpunktionszeichen aus dem Namen der Zeitzone entfernen.
< Format>	Nein	String	Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< konvertierter Zeitstempel>	String	Der in die Zielzeitzone konvertierte Zeitstempel

Beispiel 1

In diesem Beispiel wird ein Zeitstempel in die angegebene Zeitzone konvertiert:

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

Und gibt dieses Ergebnis zurück: "2018-01-01T00:00:00Z"

Beispiel 2

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

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

Und gibt dieses Ergebnis zurück: "Monday, January 1, 2018"

convertTimeZone

Wandeln Sie einen Zeitstempel aus der Quellzeitzone in die Zielzeitzone um.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge, die den Zeitstempel enthält
< sourceTimeZone>	Yes	String	Der Name für die Quellzeitzone. Informationen zu Zeitzonennamen finden Sie unter Microsoft-Zeitzonenwerte. Möglicherweise müssen Sie jedoch alle Interpunktionszeichen aus dem Namen der Zeitzone entfernen.
< destinationTimeZone>	Yes	String	Der Name für die Zielzeitzone. Informationen zu Zeitzonennamen finden Sie unter Microsoft-Zeitzonenwerte. Möglicherweise müssen Sie jedoch alle Interpunktionszeichen aus dem Namen der Zeitzone entfernen.
< Format>	Nein	String	Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< konvertierter Zeitstempel>	String	Der in die Zielzeitzone konvertierte Zeitstempel

Beispiel 1

In diesem Beispiel wird die Quellzeitzone in die Zielzeitzone konvertiert:

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

Und gibt dieses Ergebnis zurück: "2018-01-01T00:00:00.0000000"

Beispiel 2

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

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

Und gibt dieses Ergebnis zurück: "Monday, January 1, 2018"

convertToUtc

Wandeln Sie einen Zeitstempel aus der Quellzeitzone in koordinierte Weltzeit (UTC) um.

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge, die den Zeitstempel enthält
< sourceTimeZone>	Yes	String	Der Name für die Quellzeitzone. Informationen zu Zeitzonennamen finden Sie unter Microsoft-Zeitzonenwerte. Möglicherweise müssen Sie jedoch alle Interpunktionszeichen aus dem Namen der Zeitzone entfernen.
< Format>	Nein	String	Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< konvertierter Zeitstempel>	String	Der in UTC konvertierte Zeitstempel

Beispiel 1

In diesem Beispiel wird ein Zeitstempel in UTC konvertiert:

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

Und gibt dieses Ergebnis zurück: "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')

Und gibt dieses Ergebnis zurück: "Monday, January 1, 2018"

createArray

Gibt ein Array aus mehreren Eingaben zurück. Informationen zu einzelnen Eingabearrays finden Sie unter Array().

createArray('<object1>', '<object2>', ...)

Parameter	Erforderlich	Typ	Description
< object1>, <object2>, ...	Yes	Alle, aber nicht gemischt	Mindestens zwei Elemente zum Erstellen des Arrays

Rückgabewert	Typ	Description
[<Objekt1>; <Objekt2>; ...]	Array	Das Array, das aus allen Eingabeelementen erstellt wurde

Beispiel

In diesem Beispiel wird ein Array aus diesen Eingaben erstellt:

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

Und gibt dieses Ergebnis zurück: ["h", "e", "l", "l", "o"]

dataUri

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

dataUri('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die zu konvertierende Zeichenfolge

Rückgabewert	Typ	Description
< 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')

Und gibt dieses Ergebnis zurück: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Gibt die binäre Version für einen URI (Uniform Resource Identifier) für Daten zurück. Verwenden Sie diese Funktion statt decodierenDataUri(). Obwohl beide Funktionen auf die gleiche Weise funktionieren, dataUriBinary() wird bevorzugt.

dataUriToBinary('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Der zu konvertierende Daten-URI

Rückgabewert	Typ	Description
< 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=')

Und gibt dieses Ergebnis zurück:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

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

dataUriToString('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Der zu konvertierende Daten-URI

Rückgabewert	Typ	Description
< string-for-data-uri>	String	Die Zeichenfolgenversion für den Daten-URI

Beispiel

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

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

Und gibt dieses Ergebnis zurück: "hello"

dayOfMonth

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

dayOfMonth('<timestamp>')

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge, die den Zeitstempel enthält

Rückgabewert	Typ	Description
< Tag des Monats>	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')

Und gibt dieses Ergebnis zurück: 15

TagDerWoche

Gibt den Wochentag aus einem Zeitstempel zurück.

dayOfWeek('<timestamp>')

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge, die den Zeitstempel enthält

Rückgabewert	Typ	Description
< Wochentag>	Integer	Der Wochentag vom angegebenen Zeitstempel, wobei Sonntag 0, Montag ist 1 usw.

Beispiel

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

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

Und gibt dieses Ergebnis zurück: 3

dayOfYear

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

dayOfYear('<timestamp>')

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge, die den Zeitstempel enthält

Rückgabewert	Typ	Description
< Tag des Jahres>	Integer	Der Tag des Jahres aus dem angegebenen Zeitstempel

Beispiel

In diesem Beispiel wird die Anzahl des Tages des Jahres aus diesem Zeitstempel zurückgegeben:

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

Und gibt dieses Ergebnis zurück: 74

decodeBase64

Gibt die Zeichenfolgenversion für eine base64-codierte Zeichenfolge zurück, die die base64-Zeichenfolge effektiv decodiert. Erwägen Sie die Verwendung von base64ToString() anstelle von decodeBase64(). Obwohl beide Funktionen auf die gleiche Weise funktionieren, base64ToString() wird bevorzugt.

decodeBase64('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die base64-codierte Zeichenfolge zum Decodieren

Rückgabewert	Typ	Description
< 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=')

Und gibt dieses Ergebnis zurück: "hello"

decodeDataUri

Gibt die binäre Version für einen URI (Uniform Resource Identifier) für Daten zurück. Erwägen Sie die Verwendung von dataUriToBinary(), statt decodeDataUri(). Obwohl beide Funktionen auf die gleiche Weise funktionieren, dataUriToBinary() wird bevorzugt.

decodeDataUri('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die zu decodierende Daten-URI-Zeichenfolge

Rückgabewert	Typ	Description
< binary-for-data-uri>	String	Die binäre Version 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=')

Und gibt dieses Ergebnis zurück:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Gibt eine Zeichenfolge zurück, die Escapezeichen durch decodierte Versionen ersetzt.

decodeUriComponent('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die Zeichenfolge mit den Escapezeichen zum Decodieren

Rückgabewert	Typ	Description
< 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')

Und gibt dieses Ergebnis zurück: "https://contoso.com"

div

Gibt das ganze Ergebnis zurück, indem zwei Zahlen dividiert werden. Informationen zum Abrufen des restlichen Ergebnisses finden Sie unter mod().

div(<dividend>, <divisor>)

Parameter	Erforderlich	Typ	Description
< Dividende>	Yes	Ganze Zahl oder Float	Die Zahl, die durch den Divisor divisor dividiert werden soll
< Divisor>	Yes	Ganze Zahl oder Float	Die Zahl, die die Dividende dividiert, aber nicht 0 sein kann

Rückgabewert	Typ	Description
< Quotient-Ergebnis>	Integer	Das Ganzzahlergebnis, das die erste Zahl durch die zweite Zahl dividiert

Beispiel

Beide Beispiele dividieren die erste Zahl durch die zweite Zahl:

div(10, 5)
div(11, 5)

Und geben Sie dieses Ergebnis zurück: 2

encodeUriComponent

Gibt eine URI-codierte Version (Uniform Resource Identifier) für eine Zeichenfolge zurück, indem URL-unsichere Zeichen durch Escapezeichen ersetzt werden. Erwägen Sie die Verwendung von uriComponent(), anstatt encodeUriComponent(). Obwohl beide Funktionen auf die gleiche Weise funktionieren, uriComponent() wird bevorzugt.

encodeUriComponent('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die Zeichenfolge, die in das URI-codierte Format konvertiert werden soll

Rückgabewert	Typ	Description
< 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')

Und gibt dieses Ergebnis zurück: "http%3A%2F%2Fcontoso.com"

leer

Überprüfen Sie, ob eine Sammlung leer ist. Gibt "true" zurück, wenn die Auflistung leer ist, oder "false" zurück, wenn sie nicht leer ist.

empty('<collection>')
empty([<collection>])

Parameter	Erforderlich	Typ	Description
< Sammlung>	Yes	Zeichenfolge, Array oder Objekt	Die zu überprüfende Sammlung

Rückgabewert	Typ	Description
true oder false	Boolean	Gibt true zurück, wenn die Auflistung leer ist. Gibt "false" zurück, wenn er nicht leer ist.

Beispiel

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

empty('')
empty('abc')

Und gibt diese Ergebnisse zurück:

• Erstes Beispiel: Übergibt eine leere Zeichenfolge, sodass die Funktion zurückgegeben wird true.
• Zweites Beispiel: Übergibt die Zeichenfolge "abc", sodass die Funktion zurückgegeben wird false.

endsWith

Überprüfen Sie, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge endet. Gibt "true" zurück, wenn die Teilzeichenfolge gefunden wird, oder "false" zurück, wenn sie nicht gefunden wurde. Bei dieser Funktion wird die Groß-/Kleinschreibung nicht beachtet.

endsWith('<text>', '<searchText>')

Parameter	Erforderlich	Typ	Description
< Text>	Yes	String	Die zu überprüfende Zeichenfolge
< searchText>	Yes	String	Die endende Teilzeichenfolge, die gesucht werden soll

Rückgabewert	Typ	Description
true oder false	Boolean	Gibt true zurück, wenn die endende Teilzeichenfolge gefunden wird. Gibt "false" zurück, wenn er 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')

Und gibt dieses Ergebnis zurück: true

Beispiel 2

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

endsWith('hello world', 'universe')

Und gibt dieses Ergebnis zurück: false

gleich

Überprüfen Sie, ob beide Werte, Ausdrücke oder Objekte gleichwertig sind. Gibt "true" zurück, wenn beide entsprechen oder "false" zurückgeben, wenn sie nicht gleichwertig sind.

equals('<object1>', '<object2>')

Parameter	Erforderlich	Typ	Description
< object1>, <object2>	Yes	Verschiedene	Die zu vergleichenden Werte, Ausdrücke oder Objekte

Rückgabewert	Typ	Description
true oder false	Boolean	Gibt "true" zurück, wenn beide gleich sind. Gibt false zurück, wenn keine Entsprechung.

Beispiel

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

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

Und gibt diese Ergebnisse zurück:

• Erstes Beispiel: Beide Werte sind gleichwertig, sodass die Funktion zurückgegeben wird true.
• Second example: Both values aren't equivalent, so the function returns false.

erste

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

first('<collection>')
first([<collection>])

Parameter	Erforderlich	Typ	Description
< Sammlung>	Yes	Zeichenfolge oder Matrix	Die Sammlung, in der das erste Element gefunden werden soll

Rückgabewert	Typ	Description
< First-collection-item>	Beliebig	Das erste Element in der Sammlung

Beispiel

In diesen Beispielen wird das erste Element in diesen Auflistungen gefunden:

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

Und geben Sie diese Ergebnisse zurück:

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

Schweben

Konvertieren Sie eine Zeichenfolgenversion für eine Gleitkommazahl in eine tatsächliche Gleitkommazahl.

float('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die Zeichenfolge mit einer gültigen Gleitkommazahl, die konvertiert werden soll

Rückgabewert	Typ	Description
< Float-Wert>	Schweben	Die Gleitkommazahl für die angegebene Zeichenfolge

Beispiel

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

float('10.333')

Und gibt dieses Ergebnis zurück: 10.333

formatDateTime

Gibt einen Zeitstempel im angegebenen Format zurück.

formatDateTime('<timestamp>', '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	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" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Neuformatierungs-Zeitstempel>	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')

Und gibt dieses Ergebnis zurück: "2018-03-15T12:00:00"

getFutureTime

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

getFutureTime(<interval>, <timeUnit>, <format>?)

Parameter	Erforderlich	Typ	Description
< Intervall>	Yes	Integer	Die Anzahl der angegebenen Zeiteinheiten, die hinzugefügt werden sollen
< timeUnit>	Yes	String	Die Zeiteinheit, die mit Intervall verwendet werden soll: "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" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Aktualisierter Zeitstempel>	String	Der aktuelle Zeitstempel plus die angegebene 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')

Und gibt dieses Ergebnis zurück: "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 in das Format "D" konvertiert:

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

Und gibt dieses Ergebnis zurück: "Tuesday, March 6, 2018"

getPastTime

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

getPastTime(<interval>, <timeUnit>, <format>?)

Parameter	Erforderlich	Typ	Description
< Intervall>	Yes	Integer	Die Anzahl der angegebenen Zeiteinheiten, die subtrahiert werden sollen
< timeUnit>	Yes	String	Die Zeiteinheit, die mit Intervall verwendet werden soll: "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" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Aktualisierter Zeitstempel>	String	Der aktuelle Zeitstempel minus der angegebenen Anzahl von Zeiteinheiten

Beispiel 1

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

getPastTime(5, 'Day')

Und gibt dieses Ergebnis zurück: "2018-01-27T00:00:00.0000000Z"

Beispiel 2

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

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

Und gibt dieses Ergebnis zurück: "Saturday, January 27, 2018"

größer

Überprüfen Sie, ob der erste Wert größer als der zweite Wert ist. Gibt "true" zurück, wenn der erste Wert mehr ist, oder "false" zurück, wenn der Wert kleiner ist.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	Ganze Zahl, Float oder Zeichenfolge	Der erste Wert, der überprüft, ob größer als der zweite Wert ist
< compareTo>	Yes	Ganze Zahl, Float oder Zeichenfolge, bzw. Zeichenfolge	Der Vergleichswert

Rückgabewert	Typ	Description
true oder false	Boolean	Gibt true zurück, wenn der erste Wert größer als der zweite Wert ist. Gibt "false" zurück, wenn der erste Wert gleich oder kleiner als der zweite Wert ist.

Beispiel

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

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

Und geben Sie diese Ergebnisse zurück:

• Erstes Beispiel: true
• Zweites Beispiel: false

greaterOrEquals

Überprüfen Sie, ob der erste Wert größer oder gleich dem zweiten Wert ist. Gibt "true" zurück, wenn der erste Wert größer oder gleich ist, oder "false" zurückgeben, wenn der erste Wert kleiner ist.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	Ganze Zahl, Float oder Zeichenfolge	Der erste Wert, der überprüft, ob größer oder gleich dem zweiten Wert ist
< compareTo>	Yes	Ganze Zahl, Float oder Zeichenfolge, bzw. Zeichenfolge	Der Vergleichswert

Rückgabewert	Typ	Description
true oder false	Boolean	Gibt true zurück, wenn der erste Wert größer oder gleich dem zweiten Wert ist. Gibt "false" zurück, wenn der erste Wert kleiner als der zweite Wert ist.

Beispiel

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

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

Und geben Sie diese Ergebnisse zurück:

• Erstes Beispiel: true
• Zweites Beispiel: false

guid

Generieren Sie eine GUID (Globally Unique Identifier) als Zeichenfolge, z. B. "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Außerdem können Sie ein anderes Format für die GUID als das Standardformat "D" angeben, das durch Bindestriche getrennt ist.

guid('<format>')

Parameter	Erforderlich	Typ	Description
< Format>	Nein	String	Ein einzelner Formatbezeichner für die zurückgegebene GUID. Standardmäßig ist das Format "D", aber Sie können "N", "D", "B", "P" oder "X" verwenden.

Rückgabewert	Typ	Description
< GUID-Wert>	String	Eine zufällig generierte GUID

Beispiel

In diesem Beispiel wird dieselbe GUID generiert, aber als 32 Ziffern, durch Bindestriche getrennt und in Klammern eingeschlossen:

guid('P')

Und gibt dieses Ergebnis zurück: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

Überprüfen Sie, ob ein Ausdruck wahr oder falsch ist. Geben Sie basierend auf dem Ergebnis einen angegebenen Wert zurück.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Parameter	Erforderlich	Typ	Description
< Ausdruck>	Yes	Boolean	Der zu überprüfende Ausdruck
< valueIfTrue>	Yes	Beliebig	Der Wert, der zurückgegeben werden soll, wenn der Ausdruck wahr ist
< valueIfFalse>	Yes	Beliebig	Der Wert, der zurückgegeben werden soll, wenn der Ausdruck falsch ist

Rückgabewert	Typ	Description
< angegebene Rückgabewert>	Beliebig	Der angegebene Wert, der basierend darauf zurückgibt, ob der Ausdruck wahr oder falsch ist

Beispiel

In diesem Beispiel wird zurückgegeben "yes" , weil der angegebene Ausdruck "true" zurückgibt. Andernfalls gibt das Beispiel Folgendes zurück "no":

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

indexOf

Gibt die Startposition oder den Indexwert für eine Teilzeichenfolge zurück. Bei dieser Funktion wird die Groß-/Kleinschreibung nicht beachtet, und Indizes beginnen mit der Zahl 0.

indexOf('<text>', '<searchText>')

Parameter	Erforderlich	Typ	Description
< Text>	Yes	String	Die Zeichenfolge mit der zu findenden Teilzeichenfolge
< searchText>	Yes	String	Die zu suchende Teilzeichenfolge

Rückgabewert	Typ	Description
< Indexwert>	Integer	Die Startposition oder der Indexwert für die angegebene Teilzeichenfolge. Wenn die Zeichenfolge nicht gefunden wird, geben Sie die Zahl -1 zurück.

Beispiel

In diesem Beispiel wird der Startindexwert für die Teilzeichenfolge "world" in der Zeichenfolge "hello world" gefunden:

indexOf('hello world', 'world')

Und gibt dieses Ergebnis zurück: 6

INT

Gibt die ganzzahlige Version für eine Zeichenfolge zurück.

int('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die zu konvertierende Zeichenfolge

Rückgabewert	Typ	Description
< ganzzahliges Ergebnis>	Integer	Die ganzzahlige Version für die angegebene Zeichenfolge

Beispiel

In diesem Beispiel wird eine ganzzahlige Version für die Zeichenfolge "10" erstellt:

int('10')

Und gibt dieses Ergebnis zurück: 10

json

Gibt den JSON-Typwert (JavaScript Object Notation) für eine Zeichenfolge oder xml zurück.

json('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	Zeichenfolge oder XML	Die zu konvertierende Zeichenfolge oder XML

Rückgabewert	Typ	Description
< JSON-Ergebnis>	NATIVEr JSON-Typ oder -Objekt	Der native JSON-Typwert oder -Objekt für die angegebene Zeichenfolge oder XML. Wenn die Zeichenfolge null ist, 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]')

Und gibt dieses Ergebnis zurück: [1, 2, 3]

Beispiel 2

In diesem Beispiel wird diese Zeichenfolge in JSON konvertiert:

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

Und gibt dieses Ergebnis zurück:

{
  "fullName": "Sophia Owen"
}

Beispiel 3

In diesem Beispiel wird dieser XML-Code in JSON konvertiert:

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

Und gibt dieses Ergebnis zurück:

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

Schnittpunkt

Gibt eine Auflistung zurück, die nur die allgemeinen Elemente in den angegebenen Auflistungen enthält. Damit das Ergebnis angezeigt wird, muss ein Element in allen Auflistungen angezeigt werden, die an diese Funktion übergeben werden. Wenn mindestens ein Element denselben Namen hat, wird das letzte Element mit diesem Namen im Ergebnis angezeigt.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Parameter	Erforderlich	Typ	Description
< collection1>, <collection2>, ...	Yes	Array oder Objekt, aber nicht beide	Die Sammlungen, von denen nur die allgemeinen Elemente verwendet werden sollen

Rückgabewert	Typ	Description
< common-items>	Array oder Objekt, bzw. Objekt	Eine Auflistung, die nur über die allgemeinen Elemente in den angegebenen Auflistungen verfügt

Beispiel

In diesem Beispiel werden die allgemeinen Elemente in diesen Arrays gefunden:

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

Und gibt ein Array mit nur diesen Elementen zurück: [1, 2]

beitreten

Gibt eine Zeichenfolge zurück, die alle Elemente aus einem Array enthält und jedes Zeichen durch ein Trennzeichen getrennt hat.

join([<collection>], '<delimiter>')

Parameter	Erforderlich	Typ	Description
< Sammlung>	Yes	Array	Das Array, das die zu verbindenden Elemente enthält
< Trennzeichen>	Yes	String	Das Trennzeichen, das zwischen jedem Zeichen in der resultierenden Zeichenfolge angezeigt wird

Rückgabewert	Typ	Description
< zeichen1><Trennzeichen><char2><Trennzeichen>...	String	Die resultierende Zeichenfolge, die aus allen Elementen im angegebenen Array erstellt wurde

Beispiel

In diesem Beispiel wird eine Zeichenfolge aus allen Elementen in diesem Array mit dem angegebenen Zeichen als Trennzeichen erstellt:

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

Und gibt dieses Ergebnis zurück: "a.b.c"

letzte

Gibt das letzte Element aus einer Auflistung zurück.

last('<collection>')
last([<collection>])

Parameter	Erforderlich	Typ	Description
< Sammlung>	Yes	Zeichenfolge oder Matrix	Die Sammlung, in der das letzte Element gefunden werden soll

Rückgabewert	Typ	Description
< letztes Sammlungselement>	Zeichenfolge bzw. Array	Das letzte Element in der Sammlung

Beispiel

In diesen Beispielen wird das letzte Element in diesen Auflistungen gefunden:

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

Und gibt diese Ergebnisse zurück:

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

lastIndexOf

Gibt die Anfangsposition oder den Indexwert für das letzte Vorkommen einer Teilzeichenfolge zurück. Bei dieser Funktion wird die Groß-/Kleinschreibung nicht beachtet, und Indizes beginnen mit der Zahl 0.

lastIndexOf('<text>', '<searchText>')

Parameter	Erforderlich	Typ	Description
< Text>	Yes	String	Die Zeichenfolge mit der zu findenden Teilzeichenfolge
< searchText>	Yes	String	Die zu suchende Teilzeichenfolge

Rückgabewert	Typ	Description
< Endindexwert>	Integer	Die Anfangsposition oder der Indexwert für das letzte Vorkommen der angegebenen Teilzeichenfolge. Wenn die Zeichenfolge nicht gefunden wird, geben Sie die Zahl -1 zurück.

Beispiel

In diesem Beispiel wird der Anfangsindexwert für das letzte Vorkommen der Teilzeichenfolge "world" in der Zeichenfolge "hello world" gefunden:

lastIndexOf('hello world', 'world')

Und gibt dieses Ergebnis zurück: 6

length

Gibt die Anzahl der Elemente in einer Auflistung zurück.

length('<collection>')
length([<collection>])

Parameter	Erforderlich	Typ	Description
< Sammlung>	Yes	Zeichenfolge oder Matrix	Die Auflistung mit den zu zählenden Elementen

Rückgabewert	Typ	Description
< Länge oder Anzahl>	Integer	Die Anzahl der Elemente in der Auflistung

Beispiel

In diesen Beispielen wird die Anzahl der Elemente in diesen Auflistungen gezählt:

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

Und geben Sie dieses Ergebnis zurück: 4

weniger

Überprüfen Sie, ob der erste Wert kleiner als der zweite Wert ist. Gibt "true" zurück, wenn der erste Wert kleiner ist oder "false" zurückgibt, wenn der erste Wert mehr ist.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	Ganze Zahl, Float oder Zeichenfolge	Der erste Wert, der überprüft, ob kleiner als der zweite Wert ist
< compareTo>	Yes	Ganze Zahl, Float oder Zeichenfolge, bzw. Zeichenfolge	Das Vergleichselement

Rückgabewert	Typ	Description
true oder false	Boolean	Gibt true zurück, wenn der erste Wert kleiner als der zweite Wert ist. Gibt "false" zurück, wenn der erste Wert gleich oder größer als der zweite Wert ist.

Beispiel

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

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

Und geben Sie diese Ergebnisse zurück:

• Erstes Beispiel: true
• Zweites Beispiel: false

lessOrEquals

Überprüfen Sie, ob der erste Wert kleiner oder gleich dem zweiten Wert ist. Gibt "true" zurück, wenn der erste Wert kleiner oder gleich ist, oder "false" zurückgeben, wenn der erste Wert mehr ist.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	Ganze Zahl, Float oder Zeichenfolge	Der erste Wert, der überprüft, ob der zweite Wert kleiner oder gleich dem zweiten Wert ist.
< compareTo>	Yes	Ganze Zahl, Float oder Zeichenfolge, bzw. Zeichenfolge	Das Vergleichselement

Rückgabewert	Typ	Description
true oder false	Boolean	Gibt true zurück, wenn der erste Wert kleiner oder gleich dem zweiten Wert ist. Gibt false zurück, wenn der erste Wert größer als der zweite Wert ist.

Beispiel

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

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

Und geben Sie diese Ergebnisse zurück:

• Erstes Beispiel: true
• Zweites Beispiel: false

max

Gibt den höchsten Wert aus einer Liste oder einem Array mit Zahlen zurück, die an beiden Enden einschließlich sind.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Parameter	Erforderlich	Typ	Description
< Zahl1>, <Zahl2>, ...	Yes	Ganze Zahl, Float oder beides	Der Satz von Zahlen, aus denen der höchste Wert abgerufen werden soll
[<Zahl1>, <Zahl2>; ...]	Yes	Array – Ganze Zahl, Float oder beides	Das Array von Zahlen, aus denen Sie den höchsten Wert berechnen möchten

Rückgabewert	Typ	Description
< Max-Wert>	Ganze Zahl oder Float	Der höchste Wert im angegebenen Array oder Zahlensatz

Beispiel

In diesen Beispielen wird der höchste Wert aus der Reihe von Zahlen und dem Array abgerufen:

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

Und geben Sie dieses Ergebnis zurück: 3

min

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

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Parameter	Erforderlich	Typ	Description
< Zahl1>, <Zahl2>, ...	Yes	Ganze Zahl, Float oder beides	Der Satz von Zahlen, aus denen sie den niedrigsten Wert berechnen möchten
[<Zahl1>, <Zahl2>; ...]	Yes	Array – Ganze Zahl, Float oder beides	Das Array von Zahlen, aus denen sie den niedrigsten Wert berechnen möchten

Rückgabewert	Typ	Description
< Min-Wert>	Ganze Zahl oder Float	Der niedrigste Wert in der angegebenen Gruppe von Zahlen oder angegebenen Arrays

Beispiel

In diesen Beispielen wird der niedrigste Wert in der Reihe von Zahlen und dem Array abgerufen:

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

Und geben Sie dieses Ergebnis zurück: 1

mod

Gibt den Rest zurück, indem zwei Zahlen dividiert werden. Informationen zum Abrufen des ganzzahligen Ergebnisses finden Sie unter div().

mod(<dividend>, <divisor>)

Parameter	Erforderlich	Typ	Description
< Dividende>	Yes	Ganze Zahl oder Float	Die Zahl, die durch den Divisor divisor dividiert werden soll
< Divisor>	Yes	Ganze Zahl oder Float	Die Zahl, die die Dividende dividiert, aber nicht 0 sein kann.

Rückgabewert	Typ	Description
< modulo-result>	Ganze Zahl oder Float	Der Rest davon, die erste Zahl durch die zweite Zahl zu dividieren

Beispiel

In diesem Beispiel wird die erste Zahl durch die zweite Zahl dividiert:

mod(3, 2)

Und geben Sie dieses Ergebnis zurück: 1

mul

Gibt das Produkt aus der Multiplikation von zwei Zahlen zurück.

mul(<multiplicand1>, <multiplicand2>)

Parameter	Erforderlich	Typ	Description
< multipliziert1>	Yes	Ganze Zahl oder Float	Die Zahl, die multipliziert werden soll 2
< multiplicand2>	Yes	Ganze Zahl oder Float	Die Zahl, die multipliziert1 multipliziert wird

Rückgabewert	Typ	Description
< Produktergebnis>	Ganze Zahl oder Float	Das Produkt vom Multiplizieren der ersten Zahl mit der zweiten Zahl

Beispiel

In den folgenden Beispielen wird die erste Zahl durch die zweite Zahl gezählt:

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

Und geben Sie diese Ergebnisse zurück:

• Erstes Beispiel: 2
• Zweites Beispiel 3

not

Überprüfen Sie, ob ein Ausdruck falsch ist. Gibt "true" zurück, wenn der Ausdruck "false" ist, oder "false" zurück, wenn "true" ist.

not(<expression>)

Parameter	Erforderlich	Typ	Description
< Ausdruck>	Yes	Boolean	Der zu überprüfende Ausdruck

Rückgabewert	Typ	Description
true oder false	Boolean	Gibt "true" zurück, wenn der Ausdruck "false" ist. Gibt "false" zurück, wenn der Ausdruck wahr ist.

Beispiel 1

In diesen Beispielen wird überprüft, ob die angegebenen Ausdrücke falsch sind:

not(false)
not(true)

Und geben Sie diese Ergebnisse zurück:

• Erstes Beispiel: Der Ausdruck ist false, sodass die Funktion zurückgegeben wird true.
• Second example: The expression is true, so the function returns false.

Beispiel 2

In diesen Beispielen wird überprüft, ob die angegebenen Ausdrücke falsch sind:

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

Und geben Sie diese Ergebnisse zurück:

• Erstes Beispiel: Der Ausdruck ist false, sodass die Funktion zurückgegeben wird true.
• Second example: The expression is true, so the function returns false.

oder

Überprüfen Sie, ob mindestens ein Ausdruck wahr ist. Gibt "true" zurück, wenn mindestens ein Ausdruck wahr ist oder "false" zurückgegeben wird, wenn beide falsch sind.

or(<expression1>, <expression2>)

Parameter	Erforderlich	Typ	Description
< Expression1>, <Expression2>	Yes	Boolean	Zu überprüfende Ausdrücke

Rückgabewert	Typ	Description
true oder false	Boolean	Gibt true zurück, wenn mindestens ein Ausdruck wahr ist. Gibt "false" zurück, wenn beide Ausdrücke falsch sind.

Beispiel 1

In diesen Beispielen wird überprüft, ob mindestens ein Ausdruck wahr ist:

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

Und geben Sie diese Ergebnisse zurück:

• Erstes Beispiel: Mindestens ein Ausdruck ist wahr, sodass die Funktion zurückgegeben wird true.
• Zweites Beispiel: Beide Ausdrücke sind falsch, sodass die Funktion zurückgegeben wird false.

Beispiel 2

In diesen Beispielen wird überprüft, ob mindestens ein Ausdruck wahr ist:

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

Und geben Sie diese Ergebnisse zurück:

• Erstes Beispiel: Mindestens ein Ausdruck ist wahr, sodass die Funktion zurückgegeben wird true.
• Zweites Beispiel: Beide Ausdrücke sind falsch, sodass die Funktion zurückgegeben wird false.

Rand

Gibt eine zufällige ganze Zahl aus einem angegebenen Bereich zurück, der nur am Anfang endet.

rand(<minValue>, <maxValue>)

Parameter	Erforderlich	Typ	Description
< minValue>	Yes	Integer	Die niedrigste ganze Zahl im Bereich
< maxValue>	Yes	Integer	Die ganze Zahl, die auf die höchste ganze Zahl im Bereich folgt, den die Funktion zurückgeben kann

Rückgabewert	Typ	Description
< Zufallsergebnis>	Integer	Die zufällige ganze Zahl, die aus dem angegebenen Bereich zurückgegeben wird

Beispiel

In diesem Beispiel wird eine zufällige ganze Zahl aus dem angegebenen Bereich abgerufen, mit Ausnahme des Maximalwerts:

rand(1, 5)

Und gibt eine dieser Zahlen als Ergebnis zurück: 1, , 2, , 3oder 4

range

Gibt ein ganzzahliges Array zurück, das mit einer angegebenen ganzzahligen Zahl beginnt.

range(<startIndex>, <count>)

Parameter	Erforderlich	Typ	Description
< startIndex>	Yes	Integer	Ein ganzzahliger Wert, der das Array als erstes Element startet
< zählen>	Yes	Integer	Die Anzahl der ganzen Zahlen im Array

Rückgabewert	Typ	Description
[<Bereichsergebnis>]	Array	Das Array mit ganzzahligen Zahlen beginnend mit dem angegebenen Index

Beispiel

In diesem Beispiel wird ein ganzzahliges Array erstellt, das mit dem angegebenen Index beginnt und die angegebene Anzahl ganzzahliger Zahlen aufweist:

range(1, 4)

Und gibt dieses Ergebnis zurück: [1, 2, 3, 4]

replace

Ersetzen Sie eine Teilzeichenfolge durch die angegebene Zeichenfolge, und geben Sie die Ergebniszeichenfolge zurück. Bei dieser Funktion wird die Groß-/Kleinschreibung beachtet.

replace('<text>', '<oldText>', '<newText>')

Parameter	Erforderlich	Typ	Description
< Text>	Yes	String	Die Zeichenfolge, die die zu ersetzende Teilzeichenfolge enthält
< oldText>	Yes	String	Die zu ersetzende Teilzeichenfolge
< newText>	Yes	String	Die Ersetzungszeichenfolge

Rückgabewert	Typ	Description
< aktualisierter Text>	String	Die aktualisierte Zeichenfolge nach dem Ersetzen der Teilzeichenfolge Wenn die Teilzeichenfolge nicht gefunden wird, geben Sie die ursprüngliche Zeichenfolge zurück.

Beispiel

In diesem Beispiel wird die Teilzeichenfolge "old" in "the old string" gefunden und "old" durch "new" ersetzt:

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

Und gibt dieses Ergebnis zurück: "the new string"

skip

Entfernen Sie Elemente aus der Vorderseite einer Auflistung, und geben Sie alle anderen Elemente zurück.

skip([<collection>], <count>)

Parameter	Erforderlich	Typ	Description
< Sammlung>	Yes	Array	Die Sammlung, deren Elemente Sie entfernen möchten
< zählen>	Yes	Integer	Eine positive ganze Zahl für die Anzahl der Elemente, die am Anfang entfernt werden sollen

Rückgabewert	Typ	Description
[<updated-collection>]	Array	Die aktualisierte Auflistung nach dem Entfernen der angegebenen Elemente

Beispiel

In diesem Beispiel wird ein Element, die Zahl 0, von der Vorderseite des angegebenen Arrays entfernt:

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

Und gibt dieses Array mit den verbleibenden Elementen zurück: [1,2,3]

trennen

Gibt ein Array zurück, das Teilzeichenfolgen enthält, getrennt durch Kommas, basierend auf dem angegebenen Trennzeichen in der ursprünglichen Zeichenfolge.

split('<text>', '<delimiter>')

Parameter	Erforderlich	Typ	Description
< Text>	Yes	String	Die Zeichenfolge, die basierend auf dem angegebenen Trennzeichen in der ursprünglichen Zeichenfolge in Teilzeichenfolgen getrennt werden soll
< Trennzeichen>	Yes	String	Das Zeichen in der ursprünglichen Zeichenfolge, das als Trennzeichen verwendet werden soll

Rückgabewert	Typ	Description
[<Teilzeichenfolge1>;<Teilzeichenfolge2>,...]	Array	Ein Array, das Teilzeichenfolgen aus der ursprünglichen Zeichenfolge enthält, getrennt durch Kommas

Beispiel

In diesem Beispiel wird ein Array mit Teilzeichenfolgen aus der angegebenen Zeichenfolge basierend auf dem angegebenen Zeichen als Trennzeichen erstellt:

split('a_b_c', '_')

Und gibt dieses Array als Ergebnis zurück: ["a","b","c"]

startOfDay

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

startOfDay('<timestamp>', '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	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" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Aktualisierter Zeitstempel>	String	Der angegebene Zeitstempel, beginnt jedoch mit der Null-Stunden-Marke für den Tag.

Beispiel

In diesem Beispiel wird der Anfang des Tages für diesen Zeitstempel gefunden:

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

Und gibt dieses Ergebnis zurück: "2018-03-15T00:00:00.0000000Z"

startOfHour

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

startOfHour('<timestamp>', '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	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" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Aktualisierter Zeitstempel>	String	Der angegebene Zeitstempel, aber beginnt mit der Nullminutenmarke für die Stunde.

Beispiel

In diesem Beispiel wird der Anfang der Stunde für diesen Zeitstempel gefunden:

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

Und gibt dieses Ergebnis zurück: "2018-03-15T13:00:00.0000000Z"

startOfMonth

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

startOfMonth('<timestamp>', '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	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" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Aktualisierter Zeitstempel>	String	Der angegebene Zeitstempel, beginnt aber am ersten Tag des Monats bei der Null-Stunden-Marke.

Beispiel

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

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

Und gibt dieses Ergebnis zurück: "2018-03-01T00:00:00.0000000Z"

startsWith

Überprüfen Sie, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge beginnt. Gibt "true" zurück, wenn die Teilzeichenfolge gefunden wird, oder "false" zurück, wenn sie nicht gefunden wurde. Bei dieser Funktion wird die Groß-/Kleinschreibung nicht beachtet.

startsWith('<text>', '<searchText>')

Parameter	Erforderlich	Typ	Description
< Text>	Yes	String	Die zu überprüfende Zeichenfolge
< searchText>	Yes	String	Die startende Zeichenfolge, die gesucht werden soll

Rückgabewert	Typ	Description
true oder false	Boolean	Gibt true zurück, wenn die anfangse Teilzeichenfolge gefunden wird. Gibt "false" zurück, wenn er nicht gefunden wurde.

Beispiel 1

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

startsWith('hello world', 'hello')

Und gibt dieses Ergebnis zurück: true

Beispiel 2

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

startsWith('hello world', 'greetings')

Und gibt dieses Ergebnis zurück: false

Schnur

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

string(<value>)

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	Beliebig	Der zu konvertierende Wert

Rückgabewert	Typ	Description
< Zeichenfolgenwert>	String	Die Zeichenfolgenversion für den angegebenen Wert

Beispiel 1

In diesem Beispiel wird die Zeichenfolgenversion für diese Nummer erstellt:

string(10)

Und gibt dieses Ergebnis zurück: "10"

Beispiel 2

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

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

Und gibt dieses Ergebnis zurück: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

Gibt das Ergebnis vom Subtrahieren der zweiten Zahl von der ersten Zahl zurück.

sub(<minuend>, <subtrahend>)

Parameter	Erforderlich	Typ	Description
< Minuend>	Yes	Ganze Zahl oder Float	Die Zahl, von der der Subtrahend subtrahiert werden soll
< Subtrahend>	Yes	Ganze Zahl oder Float	Die Zahl, die von der Minuend subtrahiert werden soll

Rückgabewert	Typ	Description
< Ergebnis>	Ganze Zahl oder Float	Das Ergebnis vom Subtrahieren der zweiten Zahl von der ersten Zahl

Beispiel

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

sub(10.3, .3)

Und gibt dieses Ergebnis zurück: 10

Teilzeichenfolge

Zurückgeben von Zeichen aus einer Zeichenfolge, beginnend mit der angegebenen Position oder index. Indexwerte beginnen mit der Zahl 0.

substring('<text>', <startIndex>, <length>)

Parameter	Erforderlich	Typ	Description
< Text>	Yes	String	Die Zeichenfolge, deren Zeichen Sie verwenden möchten
< startIndex>	Yes	Integer	Eine positive Zahl, die gleich oder größer als 0 ist, die Sie als Anfangsposition oder Indexwert verwenden möchten
< Länge>	Yes	Integer	Eine positive Anzahl von Zeichen in der Teilzeichenfolge

Rückgabewert	Typ	Description
< Teilzeichenfolgenergebnis>	String	Eine Teilzeichenfolge mit der angegebenen Anzahl von Zeichen, beginnend mit der angegebenen Indexposition in der Quellzeichenfolge

Beispiel

In diesem Beispiel wird eine fünfstellige Teilzeichenfolge aus der angegebenen Zeichenfolge erstellt, beginnend mit dem Indexwert 6:

substring('hello world', 6, 5)

Und gibt dieses Ergebnis zurück: "world"

subtrahierenFromTime

Subtrahieren Sie eine Anzahl von Zeiteinheiten von einem Zeitstempel. Siehe auch getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge, die den Zeitstempel enthält
< Intervall>	Yes	Integer	Die Anzahl der angegebenen Zeiteinheiten, die subtrahiert werden sollen
< timeUnit>	Yes	String	Die Zeiteinheit, die mit Intervall verwendet werden soll: "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" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Aktualisierter Zeitstempel>	String	Der Zeitstempel minus 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')

Und gibt dieses Ergebnis zurück: "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')

Und gibt dieses Ergebnis mithilfe des optionalen "D"-Formats zurück: "Monday, January, 1, 2018"

nehmen

Gibt Elemente von vorne in einer Auflistung zurück.

take('<collection>', <count>)
take([<collection>], <count>)

Parameter	Erforderlich	Typ	Description
< Sammlung>	Yes	Zeichenfolge oder Matrix	Die Sammlung, deren Elemente Sie benötigen
< zählen>	Yes	Integer	Eine positive ganze Zahl für die Anzahl der Elemente, die Sie von vorne wünschen

Rückgabewert	Typ	Description
< Teilmenge> oder [<Teilmenge>]	Zeichenfolge bzw. Array	Eine Zeichenfolge oder ein Array mit der angegebenen Anzahl von Elementen, die von der Vorderseite der ursprünglichen Auflistung stammen

Beispiel

In diesen Beispielen wird die angegebene Anzahl von Elementen von der Vorderseite dieser Auflistungen abgerufen:

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

Und geben Sie diese Ergebnisse zurück:

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

zecken

Gibt den ticks Eigenschaftswert für einen angegebenen Zeitstempel zurück. Ein Teilstrich ist ein Intervall von 100 Nanosekunden.

ticks('<timestamp>')

Parameter	Erforderlich	Typ	Description
< Zeitstempel>	Yes	String	Die Zeichenfolge für einen Zeitstempel

Rückgabewert	Typ	Description
< Teilstrichnummer>	Integer	Die Anzahl der Teilstriche, die seit 12:00:00 Uhr, 1. Januar 0001 im gregorianischen Kalender seit dem Eingabezeitstempel verstrichen sind

toLower

Zurückgeben einer Zeichenfolge im Kleinbuchstabenformat. Wenn ein Zeichen in der Zeichenfolge keine Kleinschreibung aufweist, bleibt dieses Zeichen in der zurückgegebenen Zeichenfolge unverändert.

toLower('<text>')

Parameter	Erforderlich	Typ	Description
< Text>	Yes	String	Die Zeichenfolge, die im Kleinbuchstabenformat zurückgegeben werden soll

Rückgabewert	Typ	Description
< Kleinbuchstabe>	String	Die ursprüngliche Zeichenfolge im Kleinbuchstabenformat

Beispiel

In diesem Beispiel wird diese Zeichenfolge in Kleinbuchstaben konvertiert:

toLower('Hello World')

Und gibt dieses Ergebnis zurück: "hello world"

toUpper

Gibt eine Zeichenfolge im Großbuchstabenformat zurück. Wenn ein Zeichen in der Zeichenfolge keine Großbuchstaben aufweist, bleibt dieses Zeichen in der zurückgegebenen Zeichenfolge unverändert.

toUpper('<text>')

Parameter	Erforderlich	Typ	Description
< Text>	Yes	String	Die Zeichenfolge, die im Großbuchstabenformat zurückgegeben werden soll

Rückgabewert	Typ	Description
< Text in Großbuchstaben>	String	Die ursprüngliche Zeichenfolge im Großbuchstabenformat

Beispiel

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

toUpper('Hello World')

Und gibt dieses Ergebnis zurück: "HELLO WORLD"

stutzen

Entfernen Sie führende und nachfolgende Leerzeichen aus einer Zeichenfolge, und geben Sie die aktualisierte Zeichenfolge zurück.

trim('<text>')

Parameter	Erforderlich	Typ	Description
< Text>	Yes	String	Die Zeichenfolge, die das führende und nachfolgende Leerzeichen enthält, das entfernt werden soll

Rückgabewert	Typ	Description
< updatedText>	String	Eine aktualisierte Version für die ursprüngliche Zeichenfolge ohne führende oder nachfolgende Leerzeichen

Beispiel

In diesem Beispiel wird das führende und nachfolgende Leerzeichen aus der Zeichenfolge "Hello World" entfernt:

trim(' Hello World  ')

Und gibt dieses Ergebnis zurück: "Hello World"

union

Gibt eine Auflistung zurück, die alle Elemente aus den angegebenen Auflistungen enthält. Um im Ergebnis anzuzeigen, kann ein Element in einer beliebigen Auflistung angezeigt werden, die an diese Funktion übergeben wird. Wenn mindestens ein Element denselben Namen hat, wird das letzte Element mit diesem Namen im Ergebnis angezeigt.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Parameter	Erforderlich	Typ	Description
< collection1>, <collection2>, ...	Yes	Array oder Objekt, aber nicht beide	Die Sammlungen, aus denen Sie alle Elemente erhalten möchten

Rückgabewert	Typ	Description
< updatedCollection>	Array oder Objekt, bzw. Objekt	Eine Auflistung mit allen Elementen aus den angegebenen Auflistungen – keine Duplikate

Beispiel

In diesem Beispiel werden alle Elemente aus diesen Auflistungen abgerufen:

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

Und gibt dieses Ergebnis zurück: [1, 2, 3, 10, 101]

uriComponent

Gibt eine URI-codierte Version (Uniform Resource Identifier) für eine Zeichenfolge zurück, indem URL-unsichere Zeichen durch Escapezeichen ersetzt werden. Verwenden Sie diese Funktion, anstatt " UriComponent()" zu codieren. Obwohl beide Funktionen auf die gleiche Weise funktionieren, uriComponent() wird bevorzugt.

uriComponent('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die Zeichenfolge, die in das URI-codierte Format konvertiert werden soll

Rückgabewert	Typ	Description
< 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')

Und gibt dieses Ergebnis zurück: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

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

uriComponentToBinary('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die URI-codierte Zeichenfolge, die konvertiert werden soll

Rückgabewert	Typ	Description
< binary-for-encoded-uri>	String	Die binäre Version für die URI-codierte Zeichenfolge. Der binäre Inhalt ist base64-codiert und wird durch dargestellt.$content

Beispiel

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

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

Und gibt dieses Ergebnis zurück:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Gibt die Zeichenfolgenversion für eine URI-codierte Zeichenfolge (Uniform Resource Identifier) zurück, die die URI-codierte Zeichenfolge effektiv decodiert.

uriComponentToString('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die URI-codierte Zeichenfolge zum Decodieren

Rückgabewert	Typ	Description
< 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')

Und gibt dieses Ergebnis zurück: "https://contoso.com"

utcNow

Gibt den aktuellen Zeitstempel zurück.

utcNow('<format>')

Optional können Sie ein anderes Format mit dem <Formatparameter> angeben.

Parameter	Erforderlich	Typ	Description
< Format>	Nein	String	Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), das iso 8601 entspricht und Zeitzoneninformationen behält.

Rückgabewert	Typ	Description
< Aktueller Zeitstempel>	String	Das aktuelle Datum und die aktuelle Uhrzeit

Beispiel 1

Angenommen, heute ist der 15. April 2018 um 1:00:00 Uhr. In diesem Beispiel wird der aktuelle Zeitstempel angezeigt:

utcNow()

Und gibt dieses Ergebnis zurück: "2018-04-15T13:00:00.0000000Z"

Beispiel 2

Angenommen, heute ist der 15. April 2018 um 1:00:00 Uhr. In diesem Beispiel wird der aktuelle Zeitstempel mithilfe des optionalen "D"-Formats angezeigt:

utcNow('D')

Und gibt dieses Ergebnis zurück: "Sunday, April 15, 2018"

Xml

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

xml('<value>')

Parameter	Erforderlich	Typ	Description
< Wert>	Yes	String	Die Zeichenfolge mit dem JSON-Objekt, das konvertiert werden soll Das JSON-Objekt darf nur eine Stammeigenschaft aufweisen, bei der es sich nicht um ein Array handeln kann. Verwenden Sie das umgekehrte Schrägstrichzeichen (\) als Escapezeichen für das doppelte Anführungszeichen (").

Rückgabewert	Typ	Description
< XML-Version>	Object	Der codierte XML-Code für die angegebene Zeichenfolge oder das 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\" }'))

Und gibt dieses Ergebnis-XML zurück:

<name>Sophia Owen</name>

Beispiel 2

Angenommen, Sie haben dieses JSON-Objekt:

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

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

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

Und gibt dieses Ergebnis-XML zurück:

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

xpath

Überprüfen Sie XML auf Knoten oder Werte, die einem XPath-Ausdruck (XML Path Language) entsprechen, und geben Sie die übereinstimmenden Knoten oder Werte zurück. Ein XPath-Ausdruck oder einfach nur "XPath" hilft Ihnen beim Navigieren in einer XML-Dokumentstruktur, sodass Sie Knoten auswählen oder Werte im XML-Inhalt berechnen können.

xpath('<xml>', '<xpath>')

Parameter	Erforderlich	Typ	Description
< XML>	Yes	Beliebig	Die XML-Zeichenfolge, die nach Knoten oder Werten gesucht werden soll, die einem XPath-Ausdruckswert entsprechen
< xpath>	Yes	Beliebig	Der XPath-Ausdruck, der verwendet wird, um übereinstimmende XML-Knoten oder -Werte zu finden

Rückgabewert	Typ	Description
< XML-Knoten>	XML	Ein XML-Knoten, wenn nur ein einzelner Knoten dem angegebenen XPath-Ausdruck entspricht
< Wert>	Beliebig	Der Wert eines XML-Knotens, wenn nur ein einzelner Wert mit dem angegebenen XPath-Ausdruck übereinstimmt
[<xml-node1>, <xml-node2>, ...] -oder- [<Wert1>, <Wert2>, ...]	Array	Ein Array mit XML-Knoten oder -Werten, die dem angegebenen XPath-Ausdruck entsprechen

Beispiel 1

Im Folgenden in Beispiel 1 findet dieses Beispiel Knoten, die mit dem <count></count> Knoten übereinstimmen, und fügt diese Knotenwerte mit der sum() Funktion hinzu:

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

Und gibt dieses Ergebnis zurück: 30

Beispiel 2

In diesem Beispiel finden beide Ausdrücke Knoten, die mit dem <location></location> Knoten übereinstimmen, in den angegebenen Argumenten, die XML mit einem Namespace enthalten. Die Ausdrücke verwenden das umgekehrte Schrägstrichzeichen (\) als Escapezeichen für das doppelte Anführungszeichen (").

• 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:

• Dieser XML-Code, der den XML-Dokumentnamespace enthält, xmlns="http://contoso.com":

  <?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>
  

• XPath-Ausdruck hier:

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

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

Hier sehen Sie den Ergebnisknoten, der dem <location></location> Knoten entspricht:

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

Beispiel 3

Im Folgenden in Beispiel 3 findet dieses Beispiel den Wert im <location></location> Knoten:

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

Und gibt dieses Ergebnis zurück: "Paris"

Hinweis

Man kann Kommentare zu Datenflussausdrücken hinzufügen, aber nicht in Pipelineausdrücken.

Verwandte Inhalte

Anweisungen zur allgemeinen Parameterverwendung finden Sie unter "Parameters for Data Factory" in Fabric