Vordefinierte Funktionen für adaptive Ausdrücke

GILT FÜR: SDK v4

In diesem Artikel werden die verfügbaren vordefinierten Funktionen geordnet nach allgemeinen Zwecken aufgeführt. Informationen zu Operatoren, die in vordefinierten Funktionen und Ausdruckssyntax verwendet werden, finden Sie unter Operatoren.

Vordefinierte Ausdrücke lassen sich in die folgenden Funktionstypen unterteilen:

• Zeichenfolge
• Sammlung
• Logischer Vergleich
• Konvertierung
• Mathematisch
• Datum
• Timex
• URI-Analyse
• Objektmanipulation und -konstruktion
• Regulärer Ausdruck
• Typüberprüfung

Sie können die Liste auch in alphabetischer Reihenfolge anzeigen.

Zeichenfolgenfunktionen

Funktion	Erklärung
length	Gibt die Länge einer Zeichenfolge zurück.
replace	Ersetzt eine Teilzeichenfolge durch die angegebene Zeichenfolge und gibt die aktualisierte Zeichenfolge zurück. Für diese Funktion wird die Groß-/Kleinschreibung beachtet.
replaceIgnoreCase	Ersetzt eine Teilzeichenfolge durch die angegebene Zeichenfolge und gibt die aktualisierte Zeichenfolge zurück. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet.
split	Gibt ein Array mit Teilzeichenfolgen basierend auf dem angegebenen Trennzeichen zurück.
substring	Gibt Zeichen aus einer Zeichenfolge zurück.
toLower	Zurückgeben einer Zeichenfolge in Kleinbuchstaben in einem optionalen Gebietsschemaformat.
toUpper	Zurückgeben einer Zeichenfolge in Großbuchstaben in einem optionalen Gebietsschemaformat.
trim	Entfernt führende und nachfolgende Leerzeichen aus einer Zeichenfolge.
addOrdinal	Gibt die Ordnungszahl der Eingabezahl zurück.
endsWith	Überprüft, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge endet. Gibt true zurück, wenn die Teilzeichenfolge gefunden wird. Andernfalls wird false zurückgegeben. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet.
startsWith	Überprüft, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge beginnt. Gibt true zurück, wenn die Teilzeichenfolge gefunden wird. Andernfalls wird false zurückgegeben. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet.
countWord	Gibt die Anzahl der Wörter in der angegebenen Zeichenfolge zurück.
concat	Kombiniert mindestens zwei Zeichenfolgen miteinander und gibt die resultierende Zeichenfolge zurück.
newGuid	Gibt eine neue GUID-Zeichenfolge zurück.
indexOf	Gibt die Anfangsposition oder den Anfangsindexwert einer Teilzeichenfolge zurück oder sucht nach dem angegebenen Objekt und gibt den Null-basierten Index des ersten Vorkommens in der gesamten Liste zurück. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet, und Indizes beginnen mit der Zahl 0.
lastIndexOf	Gibt die Anfangsposition oder den Anfangsindexwert des letzten Vorkommens einer Teilzeichenfolge zurück oder sucht nach dem angegebenen Objekt und gibt den Null-basierten Index des letzten Vorkommens innerhalb des Elementbereichs in der Liste zurück. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet, und Indizes beginnen mit der Zahl 0.
sentenceCase	Großschreibung des ersten Buchstabens des ersten Worts in einer Zeichenfolge in einem optionalen lokalen Format.
titleCase	Großschreibung des ersten Buchstabens jedes Worts in einer Zeichenfolge in einem optionalen Gebietsschemaformat.
umkehren	Kehrt die Reihenfolge der Elemente in einer Zeichenfolge oder einem Array um.

Erfassungsfunktionen

Funktion	Erklärung
contains	Sucht nach einem Element in einer Zeichenfolge oder einem Array oder nach einem Parameter in einem komplexen Objekt. Beispiele: contains('hello world', 'hello') contains(createArray('1','2'), '1') contains(json("{'foo':'bar'}"), 'foo')
first	Gibt das erste Element aus der Sammlung zurück.
Verknüpfen	Gibt eine Zeichenfolge zurück, die alle Elemente aus einem Array enthält und in der je zwei Elemente durch ein Trennzeichen getrennt sind. Beispiel: join(createArray('a','b'), '.') = "a.b" = "a.b"
last	Gibt das letzte Element aus der Sammlung zurück.
count	Gibt die Anzahl der Elemente in der Sammlung zurück.
foreach	Wird für jedes Element ausgeführt und gibt die neue Sammlung zurück.
union	Gibt eine Sammlung zurück, die sämtliche Elemente aus den angegebenen Sammlungen enthält.
skip	Entfernt Elemente vom Anfang einer Sammlung und gibt die verbleibenden Elemente zurück.
take	Gibt Elemente vom Anfang einer Sammlung zurück.
intersection	Gibt eine Sammlung zurück, die nur die gängigen Elemente aus den angegebenen Sammlungen enthält.
subArray	Gibt ein Teilarray von der angegebenen Anfangs- und Endposition zurück. Indexwerte beginnen bei 0.
select	Wird für jedes Element ausgeführt und gibt die neue Sammlung transformierter Elemente zurück.
where	Filtert nach jedem Element und gibt die neue Sammlung gefilterter Elemente zurück, die der angegebenen Bedingung entsprechen.
sortBy	Sortiert Elemente in der Sammlung in aufsteigender Reihenfolge und gibt die sortierte Sammlung zurück.
sortByDescending	Sortiert Elemente in der Sammlung in absteigender Reihenfolge und gibt die sortierte Sammlung zurück.
indicesAndValues	Wandelt ein Array oder Objekt in ein Array aus Objekten mit Eigenschaften für Indizes und Werte um.
flatten	Vereinfacht Arrays zu einem Array mit Nicht-Array-Werten.
unique	Entfernt alle Duplikate aus einem Array.
beliebig	Bestimmt, ob Elemente einer Sequenz eine Bedingung erfüllen.
all	Bestimmt, ob alle Elemente einer Sequenz eine Bedingung erfüllen.
umkehren	Kehrt die Reihenfolge der Elemente in einer Zeichenfolge oder einem Array um.
merge	Führt mehrere JSON-Objekte oder -Elemente in einem Array zusammen.

Logische Vergleichsfunktionen

Funktion	Erklärung
und	Logisches UND. Gibt „true“ zurück, wenn alle angegebenen Ausdrücke als „true“ ausgewertet werden.
equals	Vergleichsoperator für „ist gleich“. Gibt „true“ zurück, wenn die angegebenen Werte gleich sind.
empty	Hiermit überprüfen Sie, ob das Ziel leer ist.
greater	Vergleichsoperator für „ist größer als“. Gibt true zurück, wenn der erste Wert größer als der zweite Wert ist, gibt andernfalls false zurück.
greaterOrEquals	Vergleichsoperator für „ist größer als oder gleich“. Gibt true zurück, wenn der erste Wert größer gleich dem zweiten Wert ist, gibt andernfalls false zurück.
if	Überprüft, ob ein Ausdruck gleich „true“ oder „false“ ist. Gibt abhängig vom Ergebnis einen angegebenen Wert zurück.
less	Vergleich kleiner als Vorgang. Gibt true zurück, wenn der erste Wert kleiner als der zweite Wert ist, gibt andernfalls false zurück.
lessOrEquals	Vergleichsoperator für „ist kleiner als oder gleich“. Gibt true zurück, wenn der erste Wert kleiner gleich dem zweiten Wert ist, gibt andernfalls false zurück.
not	Logischer nicht-Operator. Gibt true zurück, wenn der Ausdruck zu „false“ ausgewertet wird, gibt false zurück, wenn der Ausdruck zu „true“ ausgewertet wird.
or	Logische oder-Operation. Gibt true zurück, wenn mindestens ein Ausdruck als „true“ ausgewertet wird, gibt false zurück, wenn alle Ausdrücke als „false“ ausgewertet werden.
exists	Wertet einen Ausdruck auf Wahrheitsgehalt aus.

Konvertierungsfunktionen

Funktion	Erklärung
float	Gibt die Gleitkomma-Darstellung der angegebenen Zeichenfolge zurück.
int	Gibt die integere Darstellung der angegebenen Zeichenfolge zurück.
string	Gibt die Zeichenfolgenversion des angegebenen Werts in einem optionalen Gebietsschemaformat zurück.
bool	Gibt die boolesche Darstellung der angegebenen Zeichenfolge zurück.
createArray	Erstellt ein Array aus mehreren Eingaben.
json	Gibt den JSON-Typwert oder das JSON-Objekt (JavaScript Object Notation) einer Zeichenfolge oder eines XML-Codes zurück.
base64	Gibt die Base64-codierte Version einer Zeichenfolge oder eines Bytearrays zurück.
base64ToBinary	Gibt die Binärversion für eine base64-codierte Zeichenfolge zurück.
base64ToString	Gibt die Zeichenfolgenversion einer Base64-codierten Zeichenfolge zurück.
binary	Gibt die Binärversion für einen Eingabewert zurück.
dataUri	Gibt den URI für einen Eingabewert zurück.
dataUriToBinary	Gibt die Binärversion eines Daten-URI zurück.
dataUriToString	Gibt die Binärversion einer Daten-URL zurück.
uriComponent	Gibt die URI-codierte Version für einen Eingabewert zurück, indem URL-unsichere Zeichen durch Escapezeichen ersetzt werden.
uriComponentToString	Gibt die Zeichenfolgenversion einer URI-codierten Zeichenfolge zurück.
xml	Gibt die XML-Version einer Zeichenfolge zurück.
formatNumber	Formatieren Sie einen Wert auf die nächste Zahl für die angegebene Anzahl von Bruchstellen und ein optionales angegebenes Gebietsschema.
jsonStringify	Gibt die JSON-Zeichenfolge eines Werts zurück.
stringOrValue Zeichenfolgen-Interpolation umbrechen, um echten Wert zu erhalten. Zum Beispiel gibt stringOrValue('${1}') die Zahl 1 zurück, während stringOrValue('${1} item') die Zeichenfolge „1 Element“ zurückgibt.

Mathematische Funktionen

Funktion	Erklärung
abs	Gibt den absoluten Wert einer angegebenen Zahl zurück.
add	Mathematische Addition. Hiermit wird das Ergebnis der Addition zweier (reiner) Zahlen oder der Verkettung von zwei oder mehr Zeichenfolgen zurückgegeben.
div	Mathematische Division. Gibt das ganzzahlige Ergebnis der Division zweier Zahlen zurück.
max	Gibt den größten Wert aus einer Sammlung zurück.
min	Gibt den kleinsten Wert aus einer Sammlung zurück.
mod	Gibt den Restwert aus der Division zweier Zahlen zurück.
mul	Mathematische Multiplikation. Gibt das Produkt aus der Multiplikation zweier Zahlen zurück.
rand	Gibt eine zufällige Zahl zwischen einem angegebenen Minimal- und Maximalwert zurück.
sqrt	Gibt die Quadratwurzel einer angegebenen Zahl zurück.
sub	Mathematische Subtraktion. Gibt das Ergebnis aus der Subtraktion der zweiten Zahl von der ersten Zahl zurück.
sum	Gibt die Summe von Zahlen in einem Array zurück.
range	Gibt ein Array mit ganzen Zahlen zurück, das mit einer angegebenen ganzen Zahl beginnt.
exp	Gibt die Potenzierung einer Zahl zu einer anderen zurück.
average	Gibt die Durchschnittszahl eines numerischen Arrays zurück.
floor	Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Zahl ist.
ceiling	Gibt die kleinste Ganzzahl zurück, die größer oder gleich der angegebenen Zahl ist.
round	Rundet einen Wert auf die nächste Ganzzahl oder auf die angegebene Anzahl von Bruchstellen.

Datums- und Uhrzeitfunktionen

Funktion	Erklärung
addDays	Fügt einem angegebenen Zeitstempel eine Anzahl von angegebenen Tagen in einem optionalen lokalen Format hinzu.
addHours	Fügt einem angegebenen Zeitstempel eine Anzahl von angegebenen Stunden in einem optionalen lokalen Format hinzu.
addMinutes	Fügt einem angegebenen Zeitstempel eine Anzahl von angegebenen Minuten in einem optionalen lokalen Format hinzu.
addSeconds	Fügt einem angegebenen Zeitstempel eine Anzahl von angegebenen Sekunden hinzu.
dayOfMonth	Gibt den Tag des Monats für einen angegebenen Zeitstempel oder Zeit-Ausdruck zurück.
dayOfWeek	Gibt den Wochentag für einen angegebenen Zeitstempel zurück.
dayOfYear	Gibt den Tag des Jahrs für einen angegebenen Zeitstempel zurück.
formatDateTime	Gibt einen Zeitstempel in einem optionalen Gebietsschemaformat zurück.
formatEpoch	Hiermit wird ein Zeitstempel der UNIX-Epoch-Zeit zurückgegeben (UNIX- oder POSIX-Zeit).
formatTicks	Gibt einen Zeitstempel in einem optionalen Gebietsschemaformat von Takten zurück.
subtractFromTime	Subtrahiert eine Anzahl von Zeiteinheiten von einem Zeitstempel in einem optionalen Gebietsschemaformat.
utcNow	Gibt den Zeitstempel als Zeichenfolge in optionalem Gebietsschemaformat zurück.
dateReadBack	Verwendet die date-time-Bibliothek für den Einlesevorgang für ein Datum.
month	Gibt den Monat des angegebenen Zeitstempels zurück.
date	Gibt das Datum für einen angegebenen Zeitstempel zurück.
year	Gibt das Jahr für einen angegebenen Zeitstempel zurück.
getTimeOfDay	Gibt die Uhrzeit für einen angegebenen Zeitstempel zurück.
getFutureTime	Gibt den aktuellen Zeitstempel plus die angegebenen Zeiteinheiten in einem optionalen Gebietsschemaformat zurück.
getPastTime	Gibt den aktuellen Zeitstempel in einem optionalen Gebietsschemaformat abzüglich der angegebenen Zeiteinheiten zurück.
addToTime	Addiert eine Anzahl von Zeiteinheiten zu einem Zeitstempel in einem optionalen Gebietsschemaformat.
convertFromUTC	Konvertieren eines Zeitstempels in ein optionales Gebietsschemaformat von Universal Time Coordinated (UTC).
convertToUTC	Konvertieren eines Zeitstempels von einem optionalen Gebietsschemaformat in Universal Time Coordinated (UTC).
startOfDay	Gibt den Anfang des Tages für einen Zeitstempel in einem optionalen Gebietsschemaformat zurück.
startOfHour	Gibt den Anfang der Stunde für einen Zeitstempel in einem optionalen Gebietsschemaformat zurück.
startOfMonth	Gibt den Beginn des Monats für einen Zeitstempel in einem optionalen Gebietsschemaformat zurück.
ticks	Gibt den Wert der Ticks-Eigenschaftswert eines angegebenen Zeitstempels zurück.
ticksToDays	Wandeln Sie einen Ticks-Eigenschaftswert in die Anzahl der Tage um.
ticksToHours	Wandeln Sie einen Ticks-Eigenschaftswert in die Anzahl der Stunden um.
ticksToMinutes	Wandeln Sie einen Ticks-Eigenschaftswert in die Anzahl der Minuten um.
dateTimeDiff	Gibt die Differenz zwischen zwei Ticks als eine Zeitspanne zurück.
getPreviousViableDate	Gibt das vorherige valide Datum eines Timex-Ausdrucks basierend auf dem aktuellen Datum und einer optional angegebenen Zeitzone zurück.
getNextViableDate	Gibt das nächste valide Datum eines Timex-Ausdrucks basierend auf dem aktuellen Datum und einer optional angegebenen Zeitzone zurück.
getPreviousViableTime	Gibt die vorherige valide Zeit eines Timex-Ausdrucks basierend auf der aktuellen Uhrzeit und einer optional angegebenen Zeitzone zurück.
getNextViableTime	Gibt die nächste valide Zeit eines Timex-Ausdrucks basierend auf der aktuellen Uhrzeit und einer optional angegebenen Zeitzone zurück.

Timex-Funktionen

Funktion	Erklärung
isPresent	Gibt „true“ zurück, wenn die TimexProperty oder der Timex-Ausdruck sich auf die Gegenwart bezieht.
isDuration	Gibt „true“ zurück, wenn die TimexProperty oder der Timex-Ausdruck sich auf eine Dauer bezieht.
isTime	Gibt „true“ zurück, wenn die TimexProperty oder der Timex-Ausdruck sich auf eine Uhrzeit bezieht.
isDate	Gibt „true“ zurück, wenn die TimexProperty oder der Timex-Ausdruck sich auf ein Datum bezieht.
isTimeRange	Gibt „true“ zurück, wenn die TimexProperty oder der Timex-Ausdruck sich auf einen Zeitbereich bezieht.
isDateRange	Gibt „true“ zurück, wenn die TimexProperty oder der Timex-Ausdruck sich auf einen Datumsbereich bezieht.
isDefinite	Gibt „true“ zurück, wenn die TimexProperty oder der Timex-Ausdruck sich auf einen bestimmten Tag bezieht.
rresolve	Gibt zurück, wenn eine angegebene Timex-Eigenschaft oder ein angegebener Timex-Ausdruck sich auf eine gültige Uhrzeit bezieht. Gültige Uhrzeiten enthalten Stunden, Minuten und Sekunden.

URI-Analysefunktionen

Funktion	Erklärung
uriHost	Gibt den Wert für den Host eines Uniform Resource Identifier (URI) zurück.
uriPath	Gibt den Wert für den Pfad eines Uniform Resource Identifier (URI) zurück.
uriPathAndQuery	Gibt die Werte für den Pfad und die Abfrage eines Uniform Resource Identifier (URI) zurück.
uriPort	Gibt den Wert für den Port eines Uniform Resource Identifier (URI) zurück.
uriQuery	Gibt den Wert für die Abfrage eines Uniform Resource Identifier (URI) zurück.
uriScheme	Gibt den Wert für das Schema eines Uniform Resource Identifier (URI) zurück.

Funktionen für Objektmanipulation und -konstruktion

Funktion	Erklärung
addProperty	Fügt eine Eigenschaft und den zugehörigen Wert oder ein Name/Wert-Paar zu einem JSON-Objekt hinzu und gibt das aktualisierte Objekt zurück.
removeProperty	Entfernt eine Eigenschaft aus einem JSON-Objekt und gibt das aktualisierte Objekt zurück.
setProperty	Legt den Wert der Eigenschaft eines JSON-Objekts fest und gibt das aktualisierte Objekt zurück.
getProperty	Gibt den Wert einer angegebenen Eigenschaft oder Stammeigenschaft aus einem JSON-Objekt zurück.
coalesce	Gibt den ersten Wert ungleich NULL aus mindestens einem Parameter 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.
jPath	Überprüft JSON oder eine JSON-Zeichenfolge auf Knoten oder Werte, die einem Pfadausdruck entsprechen, und gibt die übereinstimmenden Knoten zurück.
setPathToValue	Legt den Wert eines bestimmten Pfads fest und gibt den Wert zurück.

Funktionen für regulären Ausdrücke

Funktion	Erklärung
isMatch	Gibt „true“ zurück, wenn eine Zeichenfolge einem gängigen RegEx-Muster entspricht.

Funktionen für die Typprüfung

Funktion	Erklärung
EOL	Gibt Sequenztext des Zeilenendes (EOL) zurück.
isInteger	Gibt „true“ zurück, wenn die Eingabe eine Ganzzahl ist
isFloat	Gibt „true“ zurück, wenn die Eingabe eine Gleitkommazahl ist
isBoolean	Gibt „true“ zurück, wenn die Eingabe ein boolescher Wert ist.
isArray	Gibt „true“ zurück, wenn die Eingabe ein Array ist.
isObject	Gibt „true“ zurück, wenn die Eingabe ein Objekt ist.
isDateTime	Gibt „true“ zurück, wenn die Eingabe ein Zeitstempel im UTC-ISO-Format ist.
isString	Gibt true zurück, wenn die Eingabe eine Zeichenfolge ist.

Vordefinierte Funktionen alphabetisch sortiert

abs

Gibt den absoluten Wert einer angegebenen Zahl zurück.

abs(<number>)

Parameter	Erforderlich	Type	Beschreibung
<number>	Ja	Zahl	Zahl zum Abrufen des absoluten Werts von

Rückgabewert	type	Beschreibung des Dataflows
<result>	Zahl	Das Ergebnis aus der Berechnung des absoluten Werts.

Beispiele

In diesen Beispielen wird der absolute Wert berechnet:

abs(3.12134)
abs(-3.12134)

Beide geben das Ergebnis 3,12134 zurück.

add

Hiermit wird das Ergebnis der Addition von zwei oder mehr (reinen) Zahlen oder der Verkettung von zwei oder mehr Zeichenfolgen (in anderen Fällen) zurückgegeben.

add(<item1>, <item2>, ...)

Parameter	Erforderlich	Type	Beschreibung
<item1>, <item2>,...	Ja	any	items

Rückgabewert	type	BESCHREIBUNG
<result-sum>	Zahl oder Zeichenfolge	Dies ist das Ergebnis der Addition der angegebenen Zahlen oder des verketteten Ergebnisses.

Beispiel

In diesem Beispiel werden die angegebenen Zahlen addiert:

add(1, 1.5)

Das Ergebnis 2.5 wird zurückgegeben.

In diesem Beispiel werden die angegebenen Elemente verkettet:

add('hello',null)
add('hello','world')

Dies sind die zurückgegebenen Ergebnisse:

• hello
• helloworld

addDays

Fügen Sie einem Zeitstempel in einem optionalen Gebietsschemaformat eine Anzahl von Tagen hinzu.

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge mit dem Zeitstempel, der im standardmäßigen UTC-ISO-Format vorliegen muss: YYYY-MM-DDTHH:mm:ss.fffZ
<days>	Ja	integer	Die positive oder negative Anzahl von Tagen, die hinzugefügt werden sollen
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<updated-timestamp>	Zeichenfolge	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:00.000Z', 10)

Das Ergebnis ist 2018-03-25T00:00:00.000Z.

Beispiel 2

In diesem Beispiel werden 10 Tage vom angegebenen Zeitstempel subtrahiert:

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

Das Ergebnis 2018-03-10T00:00:00.000Z wird zurückgegeben.

Beispiel 3

In diesem Beispiel wird dem angegebenen Zeitstempel im Gebietsschema de-DE 1 Tag hinzugefügt:

addDays('2018-03-15T13:00:00.000Z', 1, '', 'de-dE')

Das Ergebnis ist 2018-03-15T13:00:00.000Z.

addHours

Fügt einem angegebenen Zeitstempel eine Anzahl von angegebenen Stunden in einem optionalen Gebietsschemaformat hinzu.

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält
<hours>	Ja	integer	Die positive oder negative Anzahl von Stunden, die hinzugefügt werden sollen
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<updated-timestamp>	Zeichenfolge	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:00.000Z', 10)

Das Ergebnis 2018-03-15T10:00:00.000Z wird zurückgegeben.

Beispiel 2

In diesem Beispiel werden 10 Stunden vom angegebenen Zeitstempel subtrahiert:

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

Das Ergebnis 2018-03-15T10:00:00.000Z wird zurückgegeben.

Beispiel 3

In diesem Beispiel werden 2 Stunden zu dem angegebenen Zeitstempel im Gebietsschema de-DE addiert:

addHours('2018-03-15T13:00:00.000Z', 2, '', 'de-DE')

Das Ergebnis ist 15.03.18 15:00:00.

addMinutes

Fügt einem Zeitstempel in einem optionalen Gebietsschemaformat eine Anzahl von Minuten hinzu.

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält
<minutes>	Ja	integer	Die positive oder negative Anzahl von Minuten, die hinzugefügt werden sollen
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<updated-timestamp>	Zeichenfolge	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:00.000Z', 10)

Das Ergebnis 2018-03-15T00:20:00.000Z wird zurückgegeben.

Beispiel 2

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

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

Das Ergebnis 2018-03-15T00:15:00.000Z wird zurückgegeben.

Beispiel 3

In diesem Beispiel werden 30 Minuten zu dem angegebenen Zeitstempel im Gebietsschemaformat de-DE addiert:

addMinutes('2018-03-15T00:00:00.000Z', 30, '', 'de-DE')

Das Ergebnis ist 15.03.18 13:30:00.

addOrdinal

Gibt die Ordnungszahl der Eingabezahl zurück.

addOrdinal(<number>)

Parameter	Erforderlich	Type	Beschreibung
<number>	Ja	integer	Die in eine Ordnungszahl zu konvertierende Zahl

Rückgabewert	type	Beschreibung des Dataflows
<result>	Zeichenfolge	Die aus der Eingabezahl konvertierte Ordnungszahl

Beispiel

addOrdinal(11)
addOrdinal(12)
addOrdinal(13)
addOrdinal(21)
addOrdinal(22)
addOrdinal(23)

Es werden jeweils diese Ergebnisse zurückgegeben:

• 11th
• 12th
• 13th
• 21st
• 22nd
• 23rd

addProperty

Fügt eine Eigenschaft und den zugehörigen Wert, oder ein Name/Wert-Paar zu einem JSON-Objekt hinzu und gibt das aktualisierte Objekt zurück. Wenn das Objekt zur Laufzeit bereits vorhanden ist, löst die Funktion einen Fehler aus.

addProperty('<object>', '<property>', value)

Parameter	Erforderlich	Type	Beschreibung
<object>	Ja	Objekt	Das JSON-Objekt, zu dem Sie eine Eigenschaft hinzufügen möchten
<property>	Ja	Zeichenfolge	Der Name der hinzuzufügenden Eigenschaft
<value>	Ja	any	Wert der Eigenschaft

Rückgabewert	type	BESCHREIBUNG
<updated-object>	Objekt	Das aktualisierte JSON-Objekt nach dem Hinzufügen einer neuen Eigenschaft

Beispiel

In diesem Beispiel wird die accountNumber-Eigenschaft zum customerProfile-Objekt hinzugefügt, das mit der json()-Funktion in JSON konvertiert wird. Die Funktion weist einen Wert zu, der von der newGuid()-Funktion generiert wird, und gibt das aktualisierte Objekt zurück:

addProperty(json('customerProfile'), 'accountNumber', newGuid())

addSeconds

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

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält
<seconds>	Ja	integer	Die positive oder negative Anzahl von Sekunden, die hinzugefügt werden sollen
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.

Rückgabewert	type	BESCHREIBUNG
<updated-timestamp>	Zeichenfolge	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:00.000Z', 10)

Das Ergebnis 2018-03-15T00:00:10.000Z wird zurückgegeben.

Beispiel 2

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

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

Das Ergebnis 2018-03-15T00:00:25.000Z wird zurückgegeben.

addToTime

Addiert eine Anzahl von Zeiteinheiten zu einem Zeitstempel in einem optionalen Gebietsschemaformat. Siehe auch getFutureTime().

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält
<interval>	Ja	integer	Die Anzahl der angegebenen Zeiteinheiten, die hinzugefügt werden sollen
<timeUnit>	Ja	Zeichenfolge	Die mit interval zu verwendende Zeiteinheit. Mögliche Einheiten sind „Second“, „Minute“, „Hour“, „Day“, „Week“, „Month“ und „Year“.
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<updated-timestamp>	Zeichenfolge	Zeitstempel plus Anzahl von angegebenen Zeiteinheiten im angegebenen Format.

Beispiel 1

Dieses Beispiel addiert einen Tag zum angegebenen Zeitstempel.

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

Das Ergebnis 2018-01-02T00:00:00.000Z wird zurückgegeben.

Beispiel 2

Dieses Beispiel addiert zwei Wochen zum angegebenen Zeitstempel.

addToTime('2018-01-01T00:00:00.000Z', 2, 'Week', 'MM-DD-YY')

Das Ergebnis wird im Format „MM-DD-YY“ als 01-15-18 zurückgegeben.

all

Bestimmt, ob alle Elemente einer Sequenz eine Bedingung erfüllen.

all(<sequence>, <item>, <condition>)

Parameter	Erforderlich	Type	Beschreibung
<Sequenz>	Ja	Objekt	Eine zu bewertende Sequenz.
<item>	Ja	Zeichenfolge	Bezieht sich auf die Elemente, die in der Sequenz ausgewertet werden sollen.
<condition>	Ja	expression	Der Ausdruck., um die Bedingung zu bewerten.

Rückgabewert	type	BESCHREIBUNG
true oder false	Boolean	Gibt true zurück,wenn alle Elemente eine Bedingung erfüllen. Gibt false zurück ,wenn es mindestens eins nicht tut.

Beispiele

Diese Beispiele bestimmen, ob alle Elemente einer Sequenz eine Bedingung erfüllen:

all(createArray(1, 'cool'), item, isInteger(item))
all(createArray(1, 2), item => isInteger(item))

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• false, da beide Elemente in der Sequenz keine ganzen Zahlen sind.
• true, da beide Elemente in der Sequenz ganze Zahlen sind.

und

Überprüft, ob für sämtliche Ausdrücke der Wert „TRUE“ festgelegt ist. Gibt true zurück, wenn alle Ausdrücke „true“ sind, oder gibt false zurück, wenn mindestens ein Ausdruck „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 alle Ausdrücke „true“ sind. Gibt false zurück, wenn mindestens ein Ausdruck „false“ ist.

Beispiel 1

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

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

Es werden jeweils diese Ergebnisse zurückgegeben:

• Beide Ausdrücke sind „true“, daher gibt die Funktion true zurück.
• Ein Ausdruck ist „false“, daher gibt die Funktion false zurück.
• Beide Ausdrücke sind gleich „false“, weshalb die Funktion false zurückgibt.

Beispiel 2

In diesen Beispielen wird überprüft, ob die 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))

Es werden jeweils diese Ergebnisse zurückgegeben:

• Beide Ausdrücke sind „true“, daher gibt die Funktion true zurück.
• Ein Ausdruck ist „false“, daher gibt die Funktion false zurück.
• Beide Ausdrücke sind „true“, daher gibt die Funktion false zurück.

any

Bestimmt, ob Elemente einer Sequenz eine Bedingung erfüllen.

all(<sequence>, <item>, <condition>)

Parameter	Erforderlich	Type	Beschreibung
<Sequenz>	Ja	Objekt	Eine zu bewertende Sequenz.
<item>	Ja	Zeichenfolge	Bezieht sich auf die Elemente, die in der Sequenz ausgewertet werden sollen.
<condition>	Ja	expression	Der Ausdruck., um die Bedingung zu bewerten.

Rückgabewert	type	BESCHREIBUNG
true oder false	Boolean	Gibt true zurück, wenn alle Elemente die Bedingung erfüllen. Gibt false zurück ,wenn es mindestens eins nicht tut.

Beispiele

Diese Beispiele bestimmen, ob alle Elemente einer Sequenz eine Bedingung erfüllen:

any(createArray(1, 'cool'), item, isInteger(item))
any(createArray('first', 'cool'), item => isInteger(item))

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• true, da mindestens ein Element in der Sequenz eine ganze Zahl ist
• false, da keines der Elemente in der Sequenz eine ganze Zahl ist.

average

Gibt den Zahlendurchschnitt eines numerischen Arrays zurück.

average(<numericArray>)

Parameter	Erforderlich	Type	Beschreibung
<numericArray>	Ja	Zahlenarray	Das Eingabearray zum Berechnen des Durchschnitts

Rückgabewert	type	Beschreibung
<average-of-array>	Zahl	Der Durchschnittswert des angegebenen Arrays

Beispiel

Dieses Beispiel berechnet den Durchschnitt des Arrays in createArray():

average(createArray(1,2,3))

Das Ergebnis 2 wird zurückgegeben.

base64

Gibt die Base64-codierte Version einer Zeichenfolge oder eines Bytearrays zurück.

base64('<value>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Zeichenfolge oder Bytearray	Die eingegebene Zeichenfolge

Rückgabewert	type	BESCHREIBUNG
<base64-string>	Zeichenfolge	Die Base64-codierte Version der Eingabezeichenfolge

Beispiel 1

Dieses Beispiel konvertiert die Zeichenfolge hello in eine Base64-codierte Zeichenfolge:

base64('hello')

Das Ergebnis "aGVsbG8=" wird zurückgegeben.

Beispiel 2

Dieses Beispiel nimmt byteArr, was new byte[] { 3, 5, 1, 12 } enstpricht:

base64('byteArr')

Das Ergebnis "AwUBDA==" wird zurückgegeben.

base64ToBinary

Gibt das Binärarray einer Base64-codierten Zeichenfolge zurück.

base64ToBinary('<value>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Zeichenfolge	Die base64-codierte Zeichenfolge, die konvertiert werden soll

Rückgabewert	type	BESCHREIBUNG
<binary-for-base64-string>	Bytearray	Die Binärversion der Base64-codierten Zeichenfolge

Beispiel

Dieses Beispiel konvertiert die Base64-codierte Zeichenfolge AwUBDA== in eine Binärzeichenfolge:

base64ToBinary('AwUBDA==')

Das Ergebnis new byte[] { 3, 5, 1, 12 } wird zurückgegeben.

base64ToString

Gibt die Zeichenfolgenversion einer Base64-codierten Zeichenfolge zurück, d. h., die Base64-Zeichenfolge wird decodiert.

base64ToString('<value>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Zeichenfolge	Die base64-codierte Zeichenfolge, die decodiert werden soll

Rückgabewert	type	BESCHREIBUNG
<decoded-base64-string>	Zeichenfolge	Die Zeichenfolgenversion einer Base64-codierten Zeichenfolge

Beispiel

Dieses Beispiel konvertiert die Base64-codierte Zeichenfolge aGVsbG8= in eine Binärzeichenfolge:

base64ToString('aGVsbG8=')

Das Ergebnis hello wird zurückgegeben.

binary

Gibt die Binärversion einer Zeichenfolge zurück.

binary('<value>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Zeichenfolge	Die Zeichenfolge, die konvertiert werden soll

Rückgabewert	type	BESCHREIBUNG
<binary-for-input-value>	Bytearray	Die Binärversion der angegebenen Zeichenfolge

Beispiel

Dieses Beispiel konvertiert die Zeichenfolge hello in eine Binärzeichenfolge:

binary('hello')

Das Ergebnis new byte[] { 104, 101, 108, 108, 111 } wird zurückgegeben.

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 boolesche Version des angegebenen Werts

Beispiel

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

bool(1)
bool(0)

Es werden jeweils diese Ergebnisse zurückgegeben:

• true
• false

ceiling

Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Zahl ist.

ceiling('<number>')

Parameter	Erforderlich	Type	Beschreibung
<number>	Ja	Zahl	Eine Eingabenummer

Rückgabewert	type	Beschreibung
<Ganzzahliger Wert>	integer	Gibt die größte ganze Zahl zurück, die größer oder gleich einem Zahlenwert ist

Beispiel

Gibt die größte ganze Zahl kleiner oder gleich der Zahl 10,333 zurück:

ceiling(10.333)

Gibt die ganze Zahl 11 zurück.

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 (Typkombinationen akzeptabel)	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)

Und jeweils Folgendes zurückgeben:

• true
• hello
• NULL

concat

Kombiniert mindestens zwei Objekte miteinander und gibt die kombinierten Objekte in einer Liste oder Zeichenfolge zurück.

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

Parameter	Erforderlich	Type	Beschreibung
<object1>, <object2>, ...	Ja	any	Mindestens zwei Objekte, die verkettet werden sollen.

Rückgabewert	type	Beschreibung
<object1object2...>	Zeichenfolge oder Liste	Die kombinierte Zeichenfolge oder Liste. Nullwerte werden übersprungen.

Erwartete Rückgabewerte:

• Wenn alle Elemente Listen sind, wird eine Liste zurückgegeben.
• Wenn ein Element vorhanden ist, das keine Liste ist, wird eine Zeichenfolge zurückgegeben.
• Wenn ein Wert null ist, wird er übersprungen und nicht verkettet.

Beispiel

Dieses Beispiel kombiniert die Zeichenfolgen Hello und World:

concat('Hello', 'World')

Das Ergebnis HelloWorld wird zurückgegeben.

Beispiel 2

In diesem Beispiel werden die Listen [1,2] und [3,4] kombiniert:

concat([1,2],[3,4])

Das Ergebnis [1, 2, 3, 4] wird zurückgegeben.

Beispiel 3

In diesen Beispielen werden Objekte unterschiedlicher Typen kombiniert:

concat('a', 'b', 1, 2)
concat('a', [1,2])

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Die Zeichenfolge ab12.
• Das Objekt aSystem.Collections.Generic.List 1[System.Object]. Dies ist unlesbar und am besten zu vermeiden.

Beispiel 4

In diesen Beispielen werden Objekte kombiniert und null:

concat([1,2], null)
concat('a', 1, null)

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Die Liste [1,2].
• Die a1-Zeichenfolge.

contains

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

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

Diese Funktion ist für die folgenden 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 zurück, wenn das Element gefunden wird. Gibt false zurück, wenn es nicht gefunden wird.

Beispiel 1

Dieses Beispiel prüft die Zeichenfolge hello world auf die Teilzeichenfolge world:

contains('hello world', 'world')

Das Ergebnis true wird zurückgegeben.

Beispiel 2

Dieses Beispiel prüft die Zeichenfolge hello world auf die Teilzeichenfolge universe:

contains('hello world', 'universe')

Das Ergebnis false wird zurückgegeben.

count

Gibt Anzahl von Elementen einer Sammlung zurück

count('<collection>')
count([<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

Beispiele:

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

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

Beide geben das Ergebnis 4 zurück.

countWord

Gibt die Anzahl von Wörtern in einer Zeichenfolge zurück.

countWord('<text>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<text>	Ja	Zeichenfolge	Die Zeichenfolge, die gezählt werden soll

Rückgabewert	type	BESCHREIBUNG
<count>	integer	Die Anzahl von Wörtern in der Zeichenfolge

Beispiel

Dieses Beispiel zählt die Anzahl von Wörtern in der Zeichenfolge hello world:

countWord("hello word")

Das Ergebnis 2 wird zurückgegeben.

convertFromUTC

Konvertiert einen Zeitstempel in einem optionalen Gebietsschemaformat aus UTC (Universal Time Coordinated) in eine Zielzeitzone.

convertFromUTC('<timestamp>', '<destinationTimeZone>', '<format>'?, '<locale>'?)

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält
<destinationTimeZone>	Ja	Zeichenfolge	Der Name der Zielzeitzone. Unterstützt Windows- und IANA-Zeitzonen.
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (yyyy-MM-ddTHH:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<converted-timestamp>	Zeichenfolge	Der in das Format der Zielzeitzone konvertierte Zeitstempel

Beispiele:

Diese Beispiele führen eine Konvertierung aus UTC in die Pacific Standard Time durch:

convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time', 'MM-DD-YY')
convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time')

Es werden jeweils diese Ergebnisse zurückgegeben:

• 02-01-18
• 2018-01-01T18:00:00.0000000

Beispiel 2

In diesem Beispiel wird ein Zeitstempel im Gebietsschema en-US von UTC in Pacific Standard Time konvertiert:

convertFromUTC('2018-01-02T02:00:00.000Z', 'Pacific Standard Time', 'D', 'en-US')

Und gibt das Ergebnis Montag, den 1. Januar 2018 zurück.

convertToUTC

Konvertiert einen Zeitstempel in einem optionalen Gebietsschema aus der Quellzeitzone in UTC (Universal Time Coordinated).

convertToUTC('<timestamp>', '<sourceTimeZone>', '<format>'?, '<locale>'?)

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält
<sourceTimeZone>	Ja	Zeichenfolge	Der Name der Zielzeitzone. Unterstützt Windows- und IANA-Zeitzonen.
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<converted-timestamp>	Zeichenfolge	Der in das Format der Zielzeitzone konvertierte Zeitstempel

Beispiel

In diesem Beispiel wird ein Zeitstempel aus der Pazifischen Standardzeit in UTC konvertiert.

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

Das Ergebnis 2018-01-01T08:00:00.000Z wird zurückgegeben.

Beispiel 2

In diesem Beispiel wird ein Zeitstempel im Gebietsschema en-US von Pacific Standard Time in UTC konvertiert:

convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time', '', 'de-DE')

Das Ergebnis ist 01.01.18 08:00:00.

createArray

Gibt ein Array aus mehreren Eingaben zurück.

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

Dieses Beispiel erstellt ein Array aus den folgenden Eingaben:

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

Das Ergebnis [h ,e, l, l, o] wird zurückgegeben.

dataUri

Gibt einen Daten-URI (Uniform Resource Identifier) einer Zeichenfolge zurück.

dataUri('<value>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Zeichenfolge	Die Zeichenfolge, die konvertiert werden soll

Rückgabewert	type	Beschreibung
[<<date-uri>>]	Zeichenfolge	Der Daten-URI für die Eingabezeichenfolge

Beispiel

dataUri('hello')

Gibt das Ergebnis data:text/plain;charset=utf-8;base64,aGVsbG8= zurück.

dataUriToBinary

Gibt die Binärversion eines Daten-URI (Uniform Resource Identifier) zurück.

dataUriToBinary('<value>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Zeichenfolge	Der Daten-URI, der konvertiert werden soll

Rückgabewert	type	Beschreibung
[<binary-for-data-uri>]	Bytearray	Die Binärversion des Daten-URI

Beispiel

Dieses Beispiel erstellt eine Binärversion des folgenden Daten-URI:

dataUriToBinary('aGVsbG8=')

Das Ergebnis new byte[] { 97, 71, 86, 115, 98, 71, 56, 61 } wird zurückgegeben.

dataUriToString

Gibt die Zeichenfolgenversion eines Daten-URI (Uniform Resource Identifier) zurück.

dataUriToString('<value>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Zeichenfolge	Der Daten-URI, der konvertiert werden soll

Rückgabewert	type	Beschreibung
[<string-for-data-uri>]	Zeichenfolge	Die Zeichenfolgenversion des Daten-URI

Beispiel

Dieses Beispiel erstellt eine Zeichenfolge aus dem folgenden Daten-URI:

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

Das Ergebnis hello wird zurückgegeben.

date

Gibt das Datum eines angegebenen Zeitstempels im Format m/dd/yyyy zurück.

date('<timestramp>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält

Rückgabewert	type	Beschreibung
<date>	Zeichenfolge	Das Datum des angegebenen Zeitstempels

date('2018-03-15T13:00:00.000Z')

Gibt das Ergebnis 3-15-2018 zurück.

dateReadBack

Verwendet die date-time-Bibliothek für den Einlesevorgang für ein Datum.

dateReadBack('<currentDate>', '<targetDate>')

Parameter	Erforderlich	Type	Beschreibung
<currentDate>	Ja	Zeichenfolge	Die Zeichenfolge, die das aktuelle Datum enthält
<targetDate>	Ja	Zeichenfolge	Die Zeichenfolge, die das Zieldatum enthält

Rückgabewert	type	Beschreibung
<date-readback>	Zeichenfolge	Der Einlesevorgang zwischen aktuellem Datum und Zieldatum

Beispiel 1

dateReadBack('2018-03-15T13:00:00.000Z', '2018-03-16T13:00:00.000Z')

Gibt das Ergebnis tomorrow zurück.

DateTimeDiff

Gibt die Differenz zwischen zwei Ticks als eine Zeitspanne zurück.

dateTimeDiff('<timestamp1>', '<timestamp2>')

Parameter	Erforderlich	Type	Beschreibung
<timestamp1>	Ja	Zeichenfolge	Die erste zu vergleichende Zeitstempel-Zeichenfolge
<timestamp2>	Ja	Zeichenfolge	Die zweite zu vergleichende Zeitstempel-Zeichenfolge

Rückgabewert	type	Beschreibung
<ticks>	Zahl	Der Unterschied in Ticks zwischen zwei Zeitstempeln

Beispiel 1

Gibt die Differenz zwischen zwei Zeitstempeln in Ticks zurück.

dateTimeDiff('2019-01-01T08:00:00.000Z','2018-01-01T08:00:00.000Z')

Und gibt die Zahl 315360000000000 zurück.

Beispiel 2

Gibt die Differenz zwischen zwei Zeitstempeln in Ticks zurück.

dateTimeDiff('2018-01-01T08:00:00.000Z', '2019-01-01T08:00:00.000Z')

Gibt das Ergebnis -315360000000000 zurück. Der Wert ist eine negative Zahl.

dayOfMonth

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

dayOfMonth('<timestamp>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält

Rückgabewert	type	BESCHREIBUNG
<day-of-month>	integer	Der Tag des Monats aus dem angegebenen Zeitstempel

Beispiel

Dieses Beispiel gibt die Zahl für den Tag des Monats aus dem folgenden Zeitstempel zurück:

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

Das Ergebnis 15 wird zurückgegeben.

dayOfWeek

Gibt den Wochentag aus einem Zeitstempel zurück.

dayOfWeek('<timestamp>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält

Rückgabewert	type	BESCHREIBUNG
<day-of-week>	integer	Der Tag der Woche aus dem angegebenen Zeitstempel. Sonntag ist 0, Montag ist 1 usw.

Beispiel

Dieses Beispiel gibt die Zahl für den Tag der Woche aus dem folgenden Zeitstempel zurück:

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

Das Ergebnis 3 wird zurückgegeben.

dayOfYear

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

dayOfYear('<timestamp>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält

Rückgabewert	type	BESCHREIBUNG
<day-of-year>	integer	Der Tag des Jahres aus dem angegebenen Zeitstempel

Beispiel

Dieses Beispiel gibt die Zahl für den Tag des Jahrs aus dem folgenden Zeitstempel zurück:

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

Das Ergebnis 74 wird zurückgegeben.

div

Gibt das ganzzahlige Ergebnis der Division zweier Zahlen zurück. Zur Rückgabe des Rests siehe mod().

div(<dividend>, <divisor>)

Parameter	Erforderlich	Type	BESCHREIBUNG
<dividend>	Ja	Zahl	Die Zahl, die durch den Divisor dividiert werden soll.
<divisor>	Ja	Zahl	Die Zahl, durch die der Dividend geteilt wird. Darf nicht null (0) sein.

Rückgabewert	type	BESCHREIBUNG
<quotient-result>	Zahl	Das Ergebnis aus der Division der ersten Zahl durch die zweite Zahl

Beispiel

In beiden Beispielen wird die erste Zahl durch die zweite Zahl dividiert:

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

Es wird das Ergebnis 2 zurückgegeben.

Es gibt eine Lücke zwischen Javascript und .NET SDK. Der folgende Ausdruck gibt beispielsweise unterschiedliche Ergebnisse in Javascript und .NET SDK zurück:

Wenn einer der Parameter eine Gleitkommazahl ist, ist das Ergebnis ebenfalls eine Gleitkommazahl mit .NET-SDK.

Beispiel

div(11.2, 2)

Gibt das Ergebnis 5.6 zurück.

Wenn einer der Parameter eine Gleitkommazahl ist, ist das Ergebnis ebenfalls eine Gleitkommazahl mit Javascript-SDK.

Beispiel

div(11.2, 2)

Gibt das Ergebnis 5 zurück.

Die Problemumgehung für Javascript, um eine bestimmte Anzahl von Dezimalstellen in Ergebnissen beizubehalten, besteht darin, diesen Ausdruck zu verwenden. Wenn Sie beispielsweise drei Dezimalstellen beibehalten möchten:

float(concat(string(div(a, b)),'.',string(mod(div(a*1000, b), 1000))))

empty

Hiermit überprüfen Sie, ob eine Instanz leer ist. true wird zurückgegeben, wenn die Eingabe leer ist. Leer bedeutet hier Folgendes:

• Die Eingabe ist NULL oder nicht definiert.
• Die Eingabe ist NULL oder eine leere Zeichenfolge.
• Die Eingabe ist eine Sammlung mit der Größe „Null“ (0).
• Die Eingabe ist ein Objekt ohne Eigenschaft.

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

Parameter	Erforderlich	Type	Beschreibung
<instance>	Ja	any	Dies ist die zu überprüfende Instanz.

Rückgabewert	type	BESCHREIBUNG
true oder false	Boolean	true wird zurückgegeben, wenn die Instanz leer ist.

Beispiel

Mit diesen Beispielen wird überprüft, ob die angegebene Instanz leer ist:

empty('')
empty('abc')
empty([1])
empty(null)

Es werden jeweils diese Ergebnisse zurückgegeben:

• Es wird eine leere Zeichenfolge übergeben, weshalb die Funktion true zurückgibt.
• Es wird die Zeichenfolge abc übergeben, weshalb die Funktion false zurückgibt.
• Die Sammlung wird mit einem Element übergeben, sodass die Funktion false zurückgibt.
• Das NULL-Objekt wird übergeben, sodass die Funktion true zurückgibt.

endsWith

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

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<text>	Ja	Zeichenfolge	Die Zeichenfolge, die überprüft werden soll
<searchText>	Ja	Zeichenfolge	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. Andernfalls wird false zurückgegeben.

Beispiel 1

Dieses Beispiel überprüft, ob die Zeichenfolge hello world mit der Zeichenfolge world endet:

endsWith('hello world', 'world')

Das Ergebnis true wird zurückgegeben.

Beispiel 2

Dieses Beispiel überprüft, ob die Zeichenfolge hello world mit der Zeichenfolge universe endet:

endsWith('hello world', 'universe')

Das Ergebnis false wird zurückgegeben.

EOL

Gibt Sequenztext des Zeilenendes (EOL) zurück.

EOL()

Rückgabewert	type	Beschreibung
<IsOSPlatform>	Zeichenfolge	Geben Sie \r\n in Windows und \n unter Mac und Linux zurück.

Beispiel

In diesem Beispiel wird das Ende des Zeilensequenztexts überprüft:

EOL()

Die folgenden Zeichenfolgen werden zurückgegeben:

• Windows: \r\n
• Mac oder Linux: \n

equals

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

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

Parameter	Erforderlich	Type	Beschreibung
<object1>, <object2>	Ja	any	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. Andernfalls wird false zurückgegeben.

Beispiel

Diese Beispiele überprüfen, ob die angegebenen Eingaben gleichwertig sind:

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

Es werden jeweils diese Ergebnisse zurückgegeben:

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

exists

Wertet einen Ausdruck auf Wahrheitsgehalt aus.

exists(expression)

Parameter	Erforderlich	Type	BESCHREIBUNG
expression	Ja	expression	Ausdruck, der auf Wahrheitsgehalt ausgewertet werden soll

Rückgabewert	type	BESCHREIBUNG
<„true“ oder „false“>	Boolean	Ergebnis der Auswertung des Ausdrucks

Beispiel

Diese Beispiele werten den Wahrheitsgehalt von foo = {"bar":"value"} aus:

exists(foo.bar)
exists(foo.bar2)

Es werden jeweils diese Ergebnisse zurückgegeben:

• true
• false

exp

Gibt die Potenzierung einer Zahl zu einer anderen zurück.

exp(realNumber, exponentNumber)

Parameter	Erforderlich	Type	Beschreibung
realNumber	Ja	Zahl	Reelle Zahl, deren Exponent berechnet werden soll
exponentNumber	Ja	Zahl	Exponent

Rückgabewert	type	Beschreibung
<result-exp>	Zahl	Das Ergebnis der Berechnung des Exponenten von realNumber

Beispiel

Dieses Beispiel berechnet den Exponenten:

exp(2, 2)

Das Ergebnis 4 wird zurückgegeben.

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, in der das erste Element gesucht werden soll

Rückgabewert	type	BESCHREIBUNG
<first-collection-item>	any	Das erste Element in der Sammlung

Beispiel

Diese Beispiele suchen das erste Element in den folgenden Sammlungen:

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

Es werden jeweils diese Ergebnisse zurückgegeben:

• h
• 0

Vereinfachen

Vereinfacht ein Array in Nicht-Array-Werte. Sie können optional die maximale Tiefe für die Vereinfachung angeben.

flatten([<collection>], '<depth>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<collection>	Ja	array	Die Sammlung, die vereinfacht werden soll
<depth>	No	Zahl	Die maximale Tiefe für die Vereinfachung. Der Standardwert ist „infinity“ (unendlich).

Rückgabewert	type	Beschreibung
<new-collection>	array	Neue Sammlung, deren Elemente zu einem Nicht-Array mit der angegebenen Tiefe vereinfacht wurden

Beispiel 1

Dieses Beispiel vereinfacht das folgende Array:

flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)))

Das Ergebnis [1, 2, 3, 4, 5, 6] wird zurückgegeben.

Beispiel 2

Dieses Beispiel vereinfacht das Array bis zur Tiefe 1:

flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)), 1)

Das Ergebnis [1, 2, [3, 4], [5, 6]] wird zurückgegeben.

float

Konvertiert die Zeichenfolgenversion einer Gleitkommazahl in eine Gleitkommazahl. Diese Funktion können Sie nur verwenden, wenn Sie einen benutzerdefinierten Parameter an eine App (z. B. eine Logik-App) übergeben. Wenn die Zeichenfolge nicht in eine Gleitkommazahl konvertiert werden kann, wird eine -Ausnahme ausgelöst.

float('<value>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Zeichenfolge	Die Zeichenfolge mit einer gültigen Gleitkommazahl, in die konvertiert werden soll

Rückgabewert	type	BESCHREIBUNG
<float-value>	float	Die Gleitkommazahl der angegebenen Zeichenfolge

Beispiel

In diesem Beispiel wird die Gleitkomma-Version einer Zeichenfolge konvertiert:

float('10.333')

Und gibt den Float-Wert 10,333 zurück.

floor

Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Zahl ist.

floor('<number>')

Parameter	Erforderlich	Type	Beschreibung
<number>	Ja	Zahl	Eine Eingabenummer

Rückgabewert	type	Beschreibung
<Ganzzahliger Wert>	integer	Die größte Ganzzahl, die kleiner oder gleich zurr Eingabezahl ist.

Beispiel

In diesem Beispiel wird Untergrenze der Zahl 10,333 berechnet:

floor(10.333)

Gibt die ganze Zahl 10 zurück.

foreach

Wird für jedes Element ausgeführt und gibt die neue Sammlung zurück.

foreach([<collection/instance>], <iteratorName>, <function>)

Parameter	Erforderlich	Type	Beschreibung
<collection/instance>	Ja	Array oder Objekt	Die Sammlung mit den Elementen
<iteratorName>	Ja	Name des Iterators	Das Schlüsselelement der Pfeilfunktion
<function>	Ja	expression	Funktion, die iteratorName enthält

Rückgabewert	type	Beschreibung
<new-collection>	array	Die neue Sammlung, in der jedes Element von der Funktion ausgewertet wurde

Beispiel 1

Dieses Beispiel generiert eine neue Sammlung:

foreach(createArray(0, 1, 2, 3), x, x + 1)

Das Ergebnis [1, 2, 3, 4] wird zurückgegeben.

Beispiel 2

Diese Beispiele generiert eine neue Sammlung:

foreach(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
foreach(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))

Das Ergebnis ['name:jack', 'age:15'] wird zurückgegeben. Beachten Sie, dass der zweite Ausdruck ein Lambda-Ausdruck ist, den einige besser lesbar finden.

formatDateTime

Gibt einen Zeitstempel in einem optionalen Gebietsschemaformat zurück.

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<reformatted-timestamp>	Zeichenfolge	Der aktualisierte Zeitstempel im angegebenen Format

Beispiel 1

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

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

Das Ergebnis 2018-03-15T12:00:00 wird zurückgegeben.

Beispiel 2

In diesem Beispiel wird ein Zeitstempel im Gebietsschema de-DE konvertiert:

formatDateTime('2018-03-15', '', 'de-DE')

Das Ergebnis ist 15.03.18 00:00:00.

formatEpoch

Ein Zeitstempel wird im optionalen Gebietsschema im angegebenen Format von der UNIX-Zeit zurückgegeben (auch bekannt als Epoch-Zeit, POSIX-Zeit und UNIX-Epoch-Zeit).

formatEpoch('<epoch>', '<format>'?, '<locale>'?)

Parameter	Erforderlich	Type	Beschreibung
<epoch>	Ja	Zahl	Dies ist die epoch-Zahl.
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<reformatted-timestamp>	Zeichenfolge	Der aktualisierte Zeitstempel im angegebenen Format

Beispiel

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

formatEpoch(1521118800, 'yyyy-MM-ddTHH:mm:ss.fffZ)'

Das Ergebnis 2018-03-15T12:00:00.000Z wird zurückgegeben.

Beispiel

In diesem Beispiel wird ein Unix-Zeitstempel im Gebietsschema de-DE konvertiert:

formatEpoch(1521118800, '', 'de-DE')

Das Ergebnis ist 15.03.18 13:00:00.

formatNumber

Formatieren Sie einen Wert in die angegebene Anzahl von Bruchzahlen und ein optionales angegebenes Gebietsschema.

formatNumber('<number>', '<precision-digits>', '<locale>'?)

Parameter	Erforderlich	Type	Beschreibung
<number>	Ja	Zahl	Eine Eingabenummer
<precision-digits>	Ja	integer	Eine angegebene Anzahl von Dezimalstellen
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	Beschreibung
<Rückgabewert>	Zahl	Der Rückgabewert der Eingabe, die bei einer angegebenen Anzahl von Bruchzahlen und einem angegebenen Gebietsschema formatiert ist

Beispiel 1

In diesem Beispiel wird die Zahl 10,333 auf 2 Bruchstellen formatiert:

formatNumber(10.333, 2)

Die Zeichenfolge 10,33 wird zurückgegeben.

Beispiel 2

In diesen Beispielen werden Zahlen in eine angegebene Anzahl von Ziffern im Gebietsschema en-US formatiert:

formatNumber(12.123, 2, 'en-US')
formatNumber(1.551, 2, 'en-US')
formatNumber(12.123, 4, 'en-US')

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• 12.12
• 1,55
• 12.1230

formatTicks

Gibt einen Zeitstempel in einem optionalen Gebietsschemaformat von Takten zurück.

formatTicks('<ticks>', '<format>'?, '<locale>'?)

Parameter	Erforderlich	Type	Beschreibung
<epoch>	Ja	Zahl (oder bigint in JavaScript)	Dies ist die Anzahl der Ticks.
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<reformatted-timestamp>	Zeichenfolge	Der aktualisierte Zeitstempel im angegebenen Format

Beispiel 1

In diesem Beispiel werden Ticks in das angegebene Format konvertiert:

formatTicks(637243624200000000, 'yyyy-MM-ddTHH:mm:ss.fffZ')

Das Ergebnis 2020-05-06T11:47:00.000Z wird zurückgegeben.

Beispiel 2

In diesem Beispiel werden Ticks in das angegebene Format im Gebietsschema de-DE konvertiert:

formatTicks(637243624200000000, '', 'de-DE')

Das Ergebnis ist 06.05.20 11:47:00.

getFutureTime

Gibt den aktuellen Zeitstempel plus die angegebenen Zeiteinheiten in einem optionalen Gebietsschemaformat zurück.

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<interval>	Ja	integer	Die Anzahl von bestimmten Zeiteinheiten, die hinzugefügt werden sollen
<timeUnit>	Ja	Zeichenfolge	Die mit interval zu verwendende Zeiteinheit. Mögliche Einheiten sind „Second“, „Minute“, „Hour“, „Day“, „Week“, „Month“ und „Year“.
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<updated-timestamp>	Zeichenfolge	Der aktuelle Zeitstempel plus der angegebenen Anzahl von Zeiteinheiten

Beispiel 1

Angenommen, der aktuelle Zeitstempel lautet 2019-03-01T00:00:00.000Z. Das folgende Beispiel addiert fünf Tage zu diesem Zeitstempel:

getFutureTime(2, 'Week')

Das Ergebnis 2019-03-15T00:00:00.000Z wird zurückgegeben.

Beispiel 2

Angenommen, der aktuelle Zeitstempel lautet 2018-03-01T00:00:00.000Z. Das folgende Beispiel addiert fünf Tage zum Zeitstempel und konvertiert das Ergebnis in das Format MM-DD-YY:

getFutureTime(5, 'Day', 'MM-DD-YY')

Das Ergebnis 03-06-18 wird zurückgegeben.

Beispiel 3

Angenommen, der aktuelle Zeitstempel ist 2020-05-01T00:00:00.000Z und das Gebietsschema ist de-DE. Das folgende Beispiel addiert 1 Tag zu diesem Zeitstempel:

getFutureTime(1,'Day', '', 'de-DE')

Das Ergebnis ist 02.05.20 00:00:00.

getNextViableDate

Gibt das nächste valide Datum eines Timex-Ausdrucks basierend auf dem aktuellen Datum und einer optional angegebenen Zeitzone zurück.

getNextViableDate(<timexString>, <timezone>?)

Parameter	Erforderlich	Type	Beschreibung
<timexString>	Ja	Zeichenfolge	Die Timex-Zeichenfolge des auszuwertenden Datums.
<timezone>	No	Zeichenfolge	Die optionale Zeitzone.

Rückgabewert	type	Beschreibung
<nextViableTime>	Zeichenfolge	Das nächste valide Datum.

Beispiele

Angenommen, das Datum ist 2020-06-12 und die aktuelle Uhrzeit ist 15:42:21.

In diesen Beispielen wird die Timex-Zeichenfolge für das nächste lebensfähige Datum basierend auf dem obigen Datum und der obigen Uhrzeit ausgewertet:

getPreviousViableDate("XXXX-12-20", "America/Los_Angeles")
getPreviousViableDate("XXXX-02-29")

Und gibt die folgenden Zeichenfolgen zurück:

• 2020-12-20
• 2024-02-29

getNextViableTime

Gibt die nächste valide Zeit eines Timex-Ausdrucks basierend auf der aktuellen Uhrzeit und einer optional angegebenen Zeitzone zurück.

getNextViableTime(<timexString>, <timezone>?)

Parameter	Erforderlich	Type	Beschreibung
<timexString>	Ja	Zeichenfolge	Die Timex-Zeichenfolge der auszuwertenden Zeit.
<timezone>	No	Zeichenfolge	Die optionale Zeitzone.

Rückgabewert	type	Beschreibung
<nextViableTime>	Zeichenfolge	Die nächste valide Uhrzeit.

Beispiele

Angenommen, das Datum ist 2020-06-12 und die aktuelle Uhrzeit ist 15:42:21.

In diesen Beispielen wird eine Timex-Zeichenfolge für die nächste valide Uhrzeit basierend auf dem obigen Datum und der obigen Uhrzeit ausgewertet:

getNextViableTime("TXX:12:14", "Asia/Tokyo")
getNextViableTime("TXX:52:14")

Und gibt die folgenden Zeichenfolgen zurück:

• T16:12:14
• T15:52:14

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	Zeichenfolge	Die mit interval zu verwendende Zeiteinheit. Mögliche Einheiten sind „Second“, „Minute“, „Hour“, „Day“, „Week“, „Month“ und „Year“.
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.

Rückgabewert	type	BESCHREIBUNG
<updated-timestamp>	Zeichenfolge	Der aktuelle Zeitstempel abzüglich der angegebenen Anzahl von Zeiteinheiten

Beispiel 1

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

getPastTime(5, 'Day')

Das Ergebnis 2019-01-27T00:00:00.000Z wird zurückgegeben.

Beispiel 2

Angenommen, der aktuelle Zeitstempel lautet 2018-03-01T00:00:00.000Z. In diesem Beispiel werden fünf Tage bis zum Zeitstempel im MM-DD-YY-Format subtrahiert:

getPastTime(5, 'Day', 'MM-DD-YY')

Das Ergebnis 02-26-18 wird zurückgegeben.

Beispiel 3

Angenommen, der aktuelle Zeitstempel ist 2020-05-01T00:00:00.000Z und das Gebietsschema ist de-DE. Das folgende Beispiel subtrahiert 1 Tag vom Zeitstempel:

getPastTime(1,'Day', '', 'de-DE')

Das Ergebnis ist 31.04.20 00:00:00.

getPreviousViableDate

Gibt das vorherige valide Datum eines Timex-Ausdrucks basierend auf dem aktuellen Datum und einer optional angegebenen Zeitzone zurück.

getPreviousViableDate(<timexString>, <timezone>?)

Parameter	Erforderlich	Type	Beschreibung
<timexString>	Ja	Zeichenfolge	Die Timex-Zeichenfolge des auszuwertenden Datums.
<timezone>	No	Zeichenfolge	Die optionale Zeitzone.

Rückgabewert	type	Beschreibung
<previousViableDate>	Zeichenfolge	Das vorherige valide Datum.

Beispiele

Angenommen, das Datum ist 2020-06-12 und die aktuelle Uhrzeit ist 15:42:21.

In diesen Beispielen wird eine Timex-Zeichenfolge für das vorherige valide Datum basierend auf dem obigen Datum und der obigen Uhrzeit ausgewertet:

getPreviousViableDate("XXXX-12-20", "Eastern Standard Time")
getPreviousViableDate("XXXX-02-29")

Und gibt die folgenden Zeichenfolgen zurück:

• 2019-12-20
• 2020-02-29

getPreviousViableTime

Gibt die vorherige valide Uhrzeit eines Timex-Ausdrucks basierend auf dem aktuellen Datum und einer optional angegebenen Zeitzone zurück.

getPreviousViableTime(<timexString>, <timezone>?)

Parameter	Erforderlich	Type	Beschreibung
<timexString>	Ja	Zeichenfolge	Die Timex-Zeichenfolge der auszuwertenden Zeit.
<timezone>	No	Zeichenfolge	Die optionale Zeitzone.

Rückgabewert	type	Beschreibung
<previousViableTime>	Zeichenfolge	Die vorherige valide Uhrzeit.

Beispiele

Angenommen, das Datum ist 2020-06-12 und die aktuelle Uhrzeit ist 15:42:21.

In diesen Beispielen wird eine Timex-Zeichenfolge für die vorherige valide Uhrzeit basierend auf dem obigen Datum und der obigen Uhrzeit ausgewertet:

getPreviousViableTime("TXX:52:14")
getPreviousViableTime("TXX:12:14", 'Europe/London')

Und gibt die folgenden Zeichenfolgen zurück:

• T14:52:14
• T15:12:14

getProperty

Gibt den Wert einer angegebenen Eigenschaft oder der Stammeigenschaft aus einem JSON-Objekt zurück.

Gibt den Wert einer angegebenen Eigenschaft zurück.

getProperty(<JSONObject>, '<propertyName>')

Parameter	Erforderlich	Type	Beschreibung
<JSONObject>	Ja	Objekt	Das JSON-Objekt enthält die Eigenschaft und Werte.
<propertyName>	No	Zeichenfolge	Der Name der optionalen Eigenschaft, aus der auf Werte zugegriffen werden soll.

Rückgabewert	type	BESCHREIBUNG
value	Zeichenfolge	Der Wert der angegebenen Eigenschaft des JSON-Objekts.

Beispiel

Angenommen, Sie verfügen über folgendes JSON-Objekt:

{
   "a:b" : "a:b value",
   "c":
   {
        "d": "d key"
    }
}

Diese Beispiele rufen den Wert einer angegebenen Eigenschaft aus dem JSON-Objekt ab.

getProperty({"a:b": "value"}, 'a:b')
getProperty(c, 'd')

Und gibt die folgenden Zeichenfolgen zurück:

• a:b value
• d key

Zurückgeben der Stammeigenschaft

getProperty('<propertyName>')

Parameter	Erforderlich	Type	Beschreibung
<propertyName>	Ja	Zeichenfolge	Der Name der optionalen Eigenschaft für den Zugriff auf Werte aus dem Stammspeicherbereich.

Rückgabewert	type	BESCHREIBUNG
value	Zeichenfolge	Gibt den Wert der angegebenen Stammeigenschaft in einem JSON-Objekt zurück.

Beispiel

Angenommen, Sie verfügen über folgendes JSON-Objekt:

{
   "a:b" : "a:b value",
   "c":
   {
        "d": "d key"
    }
}

In diesem Beispiel wird die Stammeigenschaft aus dem obigen JSON-Objekt abgerufen:

getProperty("a:b")

Gibt den Zeichenfolgen-Wert a:b value zurück.

getTimeOfDay

Gibt die Uhrzeit für einen angegebenen Zeitstempel zurück.

getTimeOfDay('<timestamp>')

Die zurückgegebene Uhrzeit ist eine der folgenden Zeichenfolgen:

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den angegebenen Zeitstempel enthält

Rückgabewert	type	Beschreibung
<time-of-day>	Zeichenfolge	Die Uhrzeit für den angegebenen Zeitstempel

Im Folgenden werden die Zeichenfolgen für die Uhrzeit aufgeführt:

Uhrzeit	Timestamp
midnight	12AM
morgens	12:01AM – 11:59PM
afternoon	12PM
evening	06:00PM – 10:00PM
Nacht	10:01PM – 11:59PM

Beispiel

getTimeOfDay('2018-03-15T08:00:00.000Z')

Gibt das Ergebnis morning zurück.

greater

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

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Ganzzahl, Gleitkommazahl oder Zeichenfolge	Der Wert (erster Wert), für den überprüft wird, ob er größer ist als der zweite Wert.
<compareTo>	Ja	Ganzzahl, Gleitkommazahl 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')

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• true
• 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	Ganzzahl, Gleitkommazahl oder Zeichenfolge	Der Wert (erster Wert), für den überprüft werden soll, ob er größer gleich dem zweiten Wert ist.
<compareTo>	Ja	Ganzzahl, Gleitkommazahl 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 als der zweite ist.

Beispiel

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

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

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• true
• false

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 zurückzugebende Wert, wenn der Ausdruck als „true“ ausgewertet wird
<valueIfFalse>	Ja	any	Der zurückzugebende Wert, wenn der Ausdruck als „false“ ausgewertet wird

Rückgabewert	type	BESCHREIBUNG
<specified-return-value>	any	Der angegebene Wert, der abhängig davon zurückgegeben wird, ob der Ausdruck als true oder false ausgewertet wird

Beispiel

Dieses Beispiel wertet aus, ob equals(1,1) „true“ ist:

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

Es gibt yes zurück, weil für den angegebenen Ausdruck true zurückgegeben wird. Andernfalls gibt das Beispiel no zurück.

indexOf

Gibt die Anfangsposition oder den Anfangsindexwert einer 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	Zeichenfolge oder Array	Die Zeichenfolge, die die Teilzeichenfolge enthält, nach der gesucht werden soll
<searchText>	Ja	Zeichenfolge	Die Teilzeichenfolge, nach der gesucht werden soll

Rückgabewert	type	BESCHREIBUNG
<index-value>	integer	Die Anfangsposition oder der Anfangsindexwert der angegebenen Teilzeichenfolge.
Wird die Zeichenfolge nicht gefunden, wird die Zahl -1 zurückgegeben.

Beispiel 1

Dieses Beispiel sucht nach dem Anfangsindexwert der Teilzeichenfolge world in der Zeichenfolge hello world:

indexOf('hello world', 'world')

Das Ergebnis 6 wird zurückgegeben.

Beispiel 2

Dieses Beispiel sucht nach dem Anfangsindexwert der Teilzeichenfolge def im Array ['abc', 'def', 'ghi']:

indexOf(createArray('abc', 'def', 'ghi'), 'def')

Das Ergebnis 1 wird zurückgegeben.

indicesAndValues

Wandelt ein Array oder Objekt in ein Array aus Objekten mit Eigenschaften für Indizes (aktueller Index) und Werte um. Bei Arrays ist der Index die Position im Array. Bei Objekten ist des der Schlüssel für den Wert.

indicesAndValues('<collection or object>')

Parameter	Erforderlich	Type	Beschreibung
<collection or object>	Ja	Array oder Objekt	Ursprungszeichenfolge oder -objekt

Rückgabewert	type	BESCHREIBUNG
<collection>	array	Neues Array. Jedes Element besitzt zwei Eigenschaften: den Index mit der Position in einem Array oder den Schlüssel für ein Objekt sowie den entsprechenden Wert.

Beispiel 1

Angenommen, Sie verfügen über die Liste { items: ["zero", "one", "two"] }. Die folgende Funktion akzeptiert diese Liste:

indicesAndValues(items)

Eine neue Liste wird zurückgegeben:

[
  {
    index: 0,
    value: 'zero'
  },
  {
    index: 1,
    value: 'one'
  },
  {
    index: 2,
    value: 'two'
  }
]

Beispiel 2

Angenommen, Sie verfügen über die Liste { items: ["zero", "one", "two"] }. Die folgende Funktion akzeptiert diese Liste:

where(indicesAndValues(items), elt, elt.index >= 1)

Eine neue Liste wird zurückgegeben:

[
  {
    index: 1,
    value: 'one'
  },
  {
    index: 2,
    value: 'two'
  }
]

Beispiel 3

Angenommen, Sie verfügen über die Liste { items: ["zero", "one", "two"] }. Die folgende Funktion akzeptiert diese Liste:

join(foreach(indicesAndValues(items), item, item.value), ',')

Das Ergebnis zero,one,two wird zurückgegeben. Dieser Ausdruck hat denselben Effekt wie join(items, ',').

Beispiel 4

Angenommen, Sie verfügen über das Objekt { user: {name: 'jack', age: 20} } Die folgende Funktion akzeptiert dieses Objekt:

indicesAndValues(user)

Ein neues Objekt wird zurückgegeben:

[
  {
    index: 'name',
    value: 'jack'
  },
  {
    index: 'age',
    value: 20
  }
]

int

Gibt die Ganzzahlversion einer Zeichenfolge zurück. Eine Ausnahme wird ausgelöst, wenn die Zeichenfolge nicht in eine ganze Zahl konvertiert werden kann.

int('<value>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Zeichenfolge	Die Zeichenfolge, die konvertiert werden soll

Rückgabewert	type	BESCHREIBUNG
<integer-result>	integer	Die Ganzzahlversion der angegebenen Zeichenfolge

Beispiel

Dieses Beispiel erstellt eine Ganzzahlversion für die Zeichenfolge 10:

int('10')

Das Ergebnis wird als Ganzzahl 10 zurückgegeben.

intersection

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 beides	Die Sammlungen, aus denen Sie nur die gemeinsame Elemente erhalten möchten

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

Dieses Beispiel sucht nach den gemeinsamen Elementen in den folgenden Arrays:

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

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

isArray

Gibt true zurück, wenn die Eingabe ein Array ist.

isArray('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	any	Die zu testende Eingabe

Rückgabewert	type	BESCHREIBUNG
<Boolean-result>	Boolean	Gibt true zurück, wenn die Eingabe ein Array ist, andernfalls wird false zurückgegeben.

Beispiele

Die folgenden Beispiele überprüfen, ob die Eingabe ein Array ist:

isArray('hello')
isArray(createArray('hello', 'world'))

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Die Eingabe ist eine Zeichenfolge, daher gibt die Funktion false zurück.
• Die Eingabe ist ein Array, daher gibt die Funktion true zurück.

isBoolean

Gibt true zurück, wenn die Eingabe ein boolescher Wert ist.

isBoolean('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	any	Die zu testende Eingabe

Rückgabewert	type	BESCHREIBUNG
<Boolean-result>	Boolean	Gibt true zurück, wenn die Eingabe ein boolescher Wert ist, andernfalls wird false zurückgegeben.

Beispiele

Die folgenden Beispiele überprüfen, ob die Eingabe ein boolescher Wert ist:

isBoolean('hello')
isBoolean(32 > 16)

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Die Eingabe ist eine Zeichenfolge, daher gibt die Funktion false zurück.
• Die Eingabe ist ein boolescher Wert, daher gibt die Funktion true zurück.

isDate

Gibt true zurück, wenn eine angegebene TimexProperty oder ein angegebener Timex-Ausdruck sich auf ein gültiges Datum bezieht. Gültige Werte enthalten den Monat und den Tag des Monats oder den Wochentag.

isDate('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	Objekt oder Zeichenfolge	Das TimexProperty-Objekt der Eingabe oder eine Timex-Ausdruckszeichenfolge.

Rückgabewert	type	BESCHREIBUNG
<boolean-result>	Boolean	Gibt true zurück, wenn die Eingabe sich auf ein gültiges Datum bezieht; gibt false zurück, wenn das Datum ungültig ist.

Beispiele

Diese Beispiele überprüfen, ob die folgenden Eingaben gültige Daten sind:

isDate('2020-12')
isDate('xxxx-12-21')

Die folgenden Ergebnisse werden zurückgegeben:

• false
• true

isDateRange

Gibt true zurück, wenn eine angegebene TimexProperty oder ein angegebener Timex-Ausdruck sich auf einen gültigen Datumsbereich bezieht.

isDateRange('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	Objekt oder Zeichenfolge	Das TimexProperty-Objekt der Eingabe oder eine Timex-Ausdruckszeichenfolge.

Rückgabewert	type	BESCHREIBUNG
<boolean-result>	Boolean	Gibt true zurück, wenn die Eingabe sich auf einen gültigen Datumsbereich bezieht; gibt false zurück, wenn der Datumsbereich nicht gültig ist.

Beispiele

Diese Beispiele überprüfen, ob die folgende Eingabe ein gültiger Datumsbereich ist:

isDateRange('PT30M')
isDateRange('2012-02')

Die folgenden Ergebnisse werden zurückgegeben:

• false
• true

isDateTime

Gibt true zurück, wenn die Eingabe eine Zeitstempelzeichenfolge im UTC-ISO-Format (YYYY-MM-DDTHH:mm:ss.fffZ) ist.

isDateTime('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	any	Die zu testende Eingabe

Rückgabewert	type	BESCHREIBUNG
<Boolean-result>	Boolean	Gibt true zurück, wenn die Eingabe eine Zeitstempel-Zeichenfolge im UTC-ISO-Format ist, andernfalls wird false zurückgegeben.

Beispiele

Die folgenden Beispiele überprüfen, ob die Eingabe eine Zeichenfolge im UTC-ISO-Format ist:

isDateTime('hello world!')
isDateTime('2019-03-01T00:00:00.000Z')

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Die Eingabe ist eine Zeichenfolge, daher gibt die Funktion false zurück.
• Die Eingabe ist eine Zeichenfolge im UTC-ISO-Format, daher gibt die Funktion true zurück.

isDefinite

Gibt true zurück, wenn eine angegebene TimexProperty oder ein angegebener Timex-Ausdruck sich auf ein gültiges Datum bezieht. Gültige Daten enthalten das Jahr, den Monat und den Tag des Monats.

isDefinite('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	Objekt oder Zeichenfolge	Das TimexProperty-Objekt der Eingabe oder eine Timex-Ausdruckszeichenfolge.

Rückgabewert	type	BESCHREIBUNG
<boolean-result>	Boolean	Gibt true zurück, wenn die Eingabe sich auf ein gültiges vollständiges Datum bezieht, andernfalls wird false zurückgegeben.

Beispiele

Angenommen, Sie verfügen über das TimexProperty-Objekt validFullDate = new TimexProperty("2020-02-20"), und die Eigenschaft Now ist auf true festgelegt. Die folgenden Beispiele überprüfen, ob sich das Objekt auf ein gültiges vollständiges Datum bezieht:

isDefinite('xxxx-12-21')
isDefinite(validFullDate)

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• false
• true

isDuration

Gibt true zurück, wenn eine angegebene TimexProperty oder ein angegebener Timex-Ausdruck sich auf eine gültige Dauer bezieht.

isDuration('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	Objekt oder Zeichenfolge	Das TimexProperty-Objekt der Eingabe oder eine Timex-Ausdruckszeichenfolge.

Rückgabewert	type	BESCHREIBUNG
<boolean-result>	Boolean	Gibt true zurück, wenn die Eingabe sich auf eine gültige Dauer bezieht, andernfalls wird false zurückgegeben.

Beispiele

Die folgenden Beispiele überprüfen, ob sich die folgende Eingabe auf eine gültige Dauer bezieht:

isDuration('PT30M')
isDuration('2012-02')

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• true
• false

isFloat

Gibt true zurück, wenn die Eingabe eine Gleitkommazahl ist. Aufgrund der gemeinsamen Ausrichtung von C# und JavaScript wird eine Zahl mit einem Modulo 1-Restwert ungleich Null als Gleitkommazahl behandelt.

isFloat('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	any	Die zu testende Eingabe

Rückgabewert	type	BESCHREIBUNG
<Boolean-result>	Boolean	Gibt true zurück, wenn die Eingabe eine Gleitkommazahl ist, andernfalls wird false zurückgegeben.

Beispiele

Die folgenden Beispiele überprüfen, ob die Eingabe eine Gleitkommazahl ist:

isFloat('hello world!')
isFloat(1.0)
isFloat(12.01)

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Die Eingabe ist eine Zeichenfolge, daher gibt die Funktion false zurück.
• Die Eingabe weist den Modulowert 0 auf, daher gibt die Funktion false zurück.
• Die Eingabe ist eine Gleitkommazahl, daher gibt die Funktion true zurück.

isInteger

Gibt true zurück, wenn die Eingabe eine Ganzzahl ist. Aufgrund der gemeinsamen Ausrichtung von C# und JavaScript wird eine Zahl mit einem Modulo 1-Restwert von Null als Ganzzahl behandelt.

isInteger('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	any	Die zu testende Eingabe

Rückgabewert	type	BESCHREIBUNG
<Boolean-result>	Boolean	Gibt „true“ zurück, wenn die Eingabe eine Ganzzahl ist

Beispiele

Die folgenden Beispiele überprüfen, ob die Eingabe eine Ganzzahl ist:

isInteger('hello world!')
isInteger(1.0)
isInteger(12)

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Die Eingabe ist eine Zeichenfolge, daher gibt die Funktion false zurück.
• Die Eingabe weist den Modulowert 0 auf, daher gibt die Funktion true zurück.
• Die Eingabe ist eine Ganzzahl, daher gibt die Funktion true zurück.

isMatch

Gibt true zurück, wenn eine angegebene Zeichenfolge mit einem angegebenen Muster für reguläre Ausdrücke übereinstimmt.

isMatch('<target**string>', '<pattern>')

Parameter	Erforderlich	Type	Beschreibung
<target**string>	Ja	Zeichenfolge	Die abzugleichende Zeichenfolge
<pattern>	Ja	Zeichenfolge	Ein Muster für reguläre Ausdrücke

Rückgabewert	type	BESCHREIBUNG
<Boolean-result>	Boolean	Gibt true zurück, wenn eine angegebene Zeichenfolge mit einem gängigen Muster für reguläre Ausdrücke übereinstimmt, andernfalls wird false zurückgegeben.

Beispiele

Die folgenden Beispiele überprüfen, ob die Eingabe mit dem angegebenen Muster für reguläre Ausdrücke übereinstimmt:

isMatch('ab', '^[a-z]{1,2}$')
isMatch('FUTURE', '(?i)fortune|future')
isMatch('12abc34', '([0-9]+)([a-z]+)([0-9]+)')
isMatch('abacaxc', 'ab.*?c')

Alle geben das gleiche Ergebnis zurück: true.

isObject

Gibt true zurück, wenn eine Eingabe ein komplexes Objekt ist. Wenn die Eingabe ein primitives Objekt ist, wird false zurückgegeben. Zu den primitiven Objekten gehören Zeichenfolgen, Zahlen und boolesche Werte. Komplexe Typen wie z. B. Klassen enthalten Eigenschaften.

isObject('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	any	Die zu testende Eingabe

Rückgabewert	type	BESCHREIBUNG
<Boolean-result>	Boolean	Gibt true zurück, wenn eine Eingabe ein komplexes Objekt ist. Wenn die Eingabe ein primitives Objekt ist, wird false zurückgegeben.

Beispiele

Die folgenden Beispiele überprüfen, ob die Eingabe ein Objekt ist:

isObject('hello world!')
isObject({userName: "Sam"})

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Die Eingabe ist eine Zeichenfolge, daher gibt die Funktion false zurück.
• Die Eingabe ist ein Objekt, daher gibt die Funktion true zurück.

isPresent

Gibt true zurück, wenn eine angegebene TimexProperty oder ein angegebener Timex-Ausdruck sich auf die Gegenwart bezieht.

isPresent('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	Objekt oder Zeichenfolge	Das TimexProperty-Objekt der Eingabe oder eine Timex-Ausdruckszeichenfolge

Rückgabewert	type	BESCHREIBUNG
<boolean-result>	Boolean	Gibt true zurück, wenn die Eingabe sich auf die Gegenwart bezieht, andernfalls wird „false“ zurückgegeben.

Beispiele Angenommen, Sie verfügen über das TimexProperty-Objekt validNow = new TimexProperty() { Now = true } und legen die Now-Eigenschaft auf true fest. Die folgenden Beispiele überprüfen, ob sich die folgende Eingabe auf die Gegenwart bezieht:

isPresent('PT30M')
isPresent(validNow)

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• false
• true

isString

Gibt true zurück, wenn die Eingabe eine Zeichenfolge ist.

isString('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	any	Die zu testende Eingabe

Rückgabewert	type	BESCHREIBUNG
<Boolean-result>	Boolean	Gibt true zurück, wenn die Eingabe eine Zeichenfolge ist, andernfalls wird false zurückgegeben.

Beispiele

Die folgenden Beispiele überprüfen, ob die Eingabe eine Zeichenfolge ist:

isString('hello world!')
isString(3.14)

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Die Eingabe ist eine Zeichenfolge, daher gibt die Funktion true zurück.
• Die Eingabe ist eine Gleitkommazahl, daher gibt die Funktion false zurück.

isTime

Gibt true zurück, wenn eine angegebene TimexProperty oder ein angegebener Timex-Ausdruck sich auf eine gültige Uhrzeit bezieht. Gültige Uhrzeiten enthalten Stunden, Minuten und Sekunden.

isTime('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	Objekt oder Zeichenfolge	Das TimexProperty-Objekt der Eingabe oder eine Timex-Ausdruckszeichenfolge

Rückgabewert	type	BESCHREIBUNG
<boolean-result>	Boolean	Gibt true zurück, wenn die Eingabe sich auf eine gültige Uhrzeit bezieht, andernfalls wird false zurückgegeben.

Beispiele

Diese Beispiele überprüfen, ob die folgende Eingabe sich auf eine gültige Uhrzeit bezieht:

isTime('PT30M')
isTime('2012-02-21T12:30:45')

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• false
• true

isTimeRange

Gibt true zurück, wenn eine angegebene TimexProperty oder ein angegebener Timex-Ausdruck sich auf eine gültige Uhrzeit bezieht. Gültige Uhrzeitbereiche umfassen „partOfDay“.

isTime('<input>')

Parameter	Erforderlich	Type	Beschreibung
<input>	Ja	Objekt oder Zeichenfolge	Das TimexProperty-Objekt der Eingabe oder eine Timex-Ausdruckszeichenfolge.

Rückgabewert	type	BESCHREIBUNG
<boolean-result>	Boolean	Gibt true zurück, wenn die Eingabe sich auf einen gültigen Uhrzeitbereich bezieht, andernfalls wird false zurückgegeben.

Beispiele

Angenommen, Sie verfügen über das TimexProperty-Objekt validTimeRange = new TimexProperty() { PartOfDay = "morning" } und legen die Now-Eigenschaft auf true fest. Diese Beispiele überprüfen, ob die folgenden Eingaben gültige Uhrzeitbereiche sind:

isTimeRange('PT30M')
isTimeRange(validTimeRange)

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• false
• true

Verknüpfen

Gibt eine Zeichenfolge zurück, die alle Elemente aus einem Array enthält und in der die Zeichen 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	Zeichenfolge	Das Trennzeichen, das zwischen den einzelnen Elementen in der Ergebniszeichenfolge steht.

Rückgabewert	type	Beschreibung
<char1><delimiter><char2><delimiter>...	Zeichenfolge	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'), '.')

Das Ergebnis a.b.c wird zurückgegeben.

jPath

Überprüft JSON oder eine JSON-Zeichenfolge auf Knoten oder Werte, die einem Pfadausdruck entsprechen, und gibt die übereinstimmenden Knoten zurück.

jPath(<json>, '<path>')

Parameter	Erforderlich	Type	Beschreibung
<json>	Ja	any	Das JSON-Objekt oder die Zeichenfolge, in dem/der nach Knoten oder Werten gesucht werden soll, die mit dem Pfadausdruckswert übereinstimmen
<path>	Ja	any	Der Pfadausdruck, der für die Suche nach übereinstimmenden JSON-Knoten oder -Werten verwendet wird

Rückgabewert	type	Beschreibung
[ <json-node>]	array	Eine Liste der JSON-Knoten oder -Werte, die mit dem angegebenen Pfadausdruck übereinstimmen

C#-Beispiel

Angenommen, Sie verfügen über folgende JSON:

{
    "Stores": [
        "Lambton Quay",
        "Willis Street"
    ],
    "Manufacturers": [
        {
            "Name": "Acme Co",
            "Products": [
                {
                    "Name": "Anvil",
                    "Price": 50
                }
            ]
        },
        {
            "Name": "Contoso",
            "Products": [
                {
                    "Name": "Elbow Grease",
                    "Price": 99.95
                },
                {
                    "Name": "Headlight Fluid",
                    "Price": 4
                }
            ]
        }
    ]
}

Der Pfadausdruck lautet $..Products[?(@.Price >= 50)].Name

jPath(jsonStr, path)

Dies gibt das Ergebnis ["Anvil", "Elbow Grease"] zurück.

JavaScript-Beispiel

Angenommen, Sie verfügen über folgende JSON:

{
    "automobiles": [
        {
            "maker": "Nissan",
            "model": "Teana",
            "year": 2011
        },
        {
            "maker": "Honda",
            "model": "Jazz",
            "year": 2010
        },
        {
            "maker": "Honda",
            "model": "Civic",
            "year": 2007
        },
        {
            "maker": "Toyota",
            "model": "Yaris",
            "year": 2008
        },
        {
            "maker": "Honda",
            "model": "Accord",
            "year": 2011
        }
    ],
    "motorcycles": [
        {
            "maker": "Honda",
            "model": "ST1300",
            "year": 2012
        }
    ]
}

Der Pfadausdruck ist .automobiles{.maker === "Honda" && .year > 2009}.model.

jPath(jsonStr, path)

Dies gibt das Ergebnis ['Jazz', 'Accord'] zurück.

json

Gibt den JSON-Typwert oder das JSON-Objekt (JavaScript Object Notation) einer Zeichenfolge oder eines XML-Codes 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>	Zeichenfolge	Das resultierende JSON-Objekt, das aus der angegebenen Zeichenfolge oder XML erstellt wurde.

Beispiel 1

Dieses Beispiel konvertiert eine Zeichenfolge in JSON:

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

Dieses Ergebnis wird zurückgegeben:

{
  "fullName": "Sophia Owen"
}

Beispiel 2

Dieses Beispiel konvertiert XML in JSON:

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

Dieses Ergebnis wird zurückgegeben:

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

jsonStringify

Gibt die JSON-Zeichenfolge eines Werts zurück.

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Objekt	Das Objekt, das in eine JSON-Zeichenfolge konvertiert werden soll

Rückgabewert	type	BESCHREIBUNG
<JSON-result>	Zeichenfolge	Kopieren Sie die resultierende JSON-Zeichenfolge.

Beispiele

Diese Beispiele zeigen Objekte, die in JSON-Zeichenfolgen konvertiert wurden:

jsonStringify(null)
jsonStringify({a:'b'})

Es werden jeweils die folgenden Zeichenfolgen-Ergebnisse zurückgegeben:

• null
• {"a": "b"}

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, in der das letzte Element gesucht 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))

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• d
• 3

lastIndexOf

Gibt die Anfangsposition oder den Anfangsindexwert 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	Zeichenfolge oder Array	Die Zeichenfolge, die die Teilzeichenfolge enthält, nach der gesucht werden soll
<searchText>	Ja	Zeichenfolge	Die Teilzeichenfolge, nach der gesucht werden soll

Rückgabewert	type	BESCHREIBUNG
<ending-index-value>	integer	Die Anfangsposition oder der Anfangsindexwert des letzten Vorkommens der angegebenen Teilzeichenfolge. Wird die Zeichenfolge nicht gefunden, wird die Zahl -1 zurückgegeben.

Beispiel 1

Dieses Beispiel sucht nach dem Anfangsindexwert des letzten Vorkommens der Teilzeichenfolge world in der Zeichenfolge hello world:

lastIndexOf('hello world', 'world')

Das Ergebnis 6 wird zurückgegeben.

Beispiel 2

Dieses Beispiel sucht nach dem Anfangsindexwert des letzten Vorkommens der Teilzeichenfolge def im Array ['abc', 'def', 'ghi', 'def'].

lastIndexOf(createArray('abc', 'def', 'ghi', 'def'), 'def')

Das Ergebnis 3 wird zurückgegeben.

length

Gibt die Länge einer Zeichenfolge zurück.

length('<str>')

Parameter	Erforderlich	Type	Beschreibung
<str>	Ja	Zeichenfolge	Die Zeichenfolge, deren Länge berechnet werden soll

Rückgabewert	type	Beschreibung
<length>	integer	Die Länge dieser Zeichenfolge

Beispiele

Diese Beispiele rufen die Länge von Zeichenfolgen ab:

length('hello')
length('hello world')

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• 5
• 11

less

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

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Ganzzahl, Gleitkommazahl oder Zeichenfolge	Der Wert (erster Wert), für den überprüft werden soll, ob er kleiner ist als der zweite Wert
<compareTo>	Ja	Ganzzahl, Gleitkommazahl bzw. Zeichenfolge	Das Vergleichselement

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

Beispiele

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

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

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• true
• 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	Ganzzahl, Gleitkommazahl oder Zeichenfolge	Der Wert (erster Wert), für den überprüft werden soll, ob er kleiner gleich dem zweiten Wert ist.
<compareTo>	Ja	Ganzzahl, Gleitkommazahl 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

Dieses Beispiel überprüft, ob der erste Wert kleiner gleich dem zweiten Wert ist.

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

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• true
• false

max

Gibt den höchsten Wert aus einer Liste oder einem Array zurück. Die ersten und letzten Werte der Liste bzw. des Arrays werden einbezogen.

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

Parameter	Erforderlich	Type	Beschreibung
<number1>, <number2>, ...	Ja	Zahl	Die Menge der Zahlen, aus denen Sie den größten Wert abrufen möchten
[<number1>, <number2>, ...]	Ja	Array aus Zahlen	Das Array mit den Zahlen, aus denen Sie den größten Wert abrufen möchten

Rückgabewert	type	BESCHREIBUNG
<max-value>	Zahl	Der größte Wert in dem angegebenen Array oder in der angegebenen Menge von Zahlen

Beispiele

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

Das Ergebnis 3 wird zurückgegeben.

merge

Führt mehrere JSON-Objekte oder ein Array von Objekten zusammen.

merge(<json1>, <json2>, ...)

Parameter	Erforderlich	Type	Beschreibung
<json1>, <json2>, ...	Ja	Objekte oder Array	Der Satz von JSON-Objekten oder Arrays, die zusammengeführt werden sollen.

Rückgabewert	type	Beschreibung des Dataflows
<result>	Objekt	Das kombinierte JSON-Objekt oder kombinierte Arrayobjekte.

Beispiele

Angenommen, Sie verfügen über folgende JSON-Objekte:

json1 = @"{
            'FirstName': 'John',
            'LastName': 'Smith',
            'Enabled': false,
            'Roles': [ 'User' ]
          }"
json2 =@"{
            'Enabled': true,
            'Roles': [ 'User', 'Admin' ]
          }"

In diesem Beispiel werden die JSON-Objekte zusammengeführt:

string(merge(json(json1), json(json2)))

Das Ergebnis ist das Objekt {"FirstName":"John","LastName":"Smith","Enabled":true,"Roles":["User","Admin"]}.

Angenommen, Sie möchten Objekte und eine Liste von Objekten zusammen kombinieren. Im folgenden Beispiel werden JSON-Objekte und ein Array von Objekten kombiniert:

merge({k1:'v1'}, [{k2:'v2'}, {k3: 'v3'}], {k4:'v4'})

Das Ergebnis ist das Objekt { "k1": "v1", "k2": "v2", "k3": "v3", "k4": "v4" }.

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	Zahl	Die Menge der Zahlen, aus denen Sie den kleinsten Wert abrufen möchten
[<number1>, <number2>, ...]	Ja	Array aus Zahlen	Das Array mit den Zahlen, aus denen Sie den kleinsten Wert abrufen möchten

Rückgabewert	type	BESCHREIBUNG
<min-value>	Zahl	Der kleinste Wert im angegebenen Array oder in der angegebenen Zahlenmenge

Beispiele

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

Das Ergebnis 1 wird zurückgegeben.

mod

Gibt den Restwert aus der Division zweier Zahlen zurück. Informationen zum Abrufen des Ganzzahlergebnisses finden Sie unter div().

mod(<dividend>, <divisor>)

Parameter	Erforderlich	Type	BESCHREIBUNG
<dividend>	Ja	Zahl	Die Zahl, die durch den Divisor dividiert werden soll.
<divisor>	Ja	Zahl	Die Zahl, durch die der Dividend geteilt wird. Darf nicht null (0) sein.

Rückgabewert	type	BESCHREIBUNG
<modulo-result>	Zahl	Der Rest aus der Division der ersten Zahl durch die zweite Zahl

Beispiel

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

mod(3, 2)

Das Ergebnis 1 wird zurückgegeben.

Monat

Gibt den Tag des Monats des angegebenen Zeitstempels zurück.

month('<timestamp>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält

Rückgabewert	type	Beschreibung
<number-of-month>	integer	Die Nummer des Monats im angegebenen Zeitstempel

Beispiel

month('2018-03-15T13:01:00.000Z')

Das Ergebnis 3 wird zurückgegeben.

mul

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

mul(<multiplicand1>, <multiplicand2>)

Parameter	Erforderlich	Type	BESCHREIBUNG
<multiplicand1>	Ja	Ganzzahl oder Gleitkommazahl	Die Zahl, mit der multiplicand2 multipliziert werden soll.
<multiplicand2>	Ja	Ganzzahl oder Gleitkommazahl	Die Zahl, mit der multiplicand1 multipliziert werden soll.

Rückgabewert	type	BESCHREIBUNG
<product-result>	Ganzzahl oder Gleitkommazahl	Das Produkt aus der Multiplikation der ersten Zahl mit der zweiten Zahl

Beispiele

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

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

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• 2
• 3

newGuid

Gibt eine neue GUID-Zeichenfolge zurück.

newGuid()

Rückgabewert	type	Beschreibung
<Guid-string>	Zeichenfolge	Eine neue GUID-Zeichenfolge mit der Länge 36 und dem Format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx

Beispiel

newGuid()

Es wird ein Ergebnis im Format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx zurückgegeben.

not

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

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 als „false“ ausgewertet wird. Gibt false zurück, wenn der Ausdruck als „true“ ausgewertet wird.

Beispiel 1

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

not(false)
not(true)

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Der Ausdruck ist gleich „false“, weshalb die Funktion true zurückgibt.
• 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))

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

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

or

Überprüft, ob mindestens ein Ausdruck gleich „true“ ist. Gibt true zurück, wenn mindestens ein Ausdruck als „true“ ausgewertet wird, gibt false zurück, wenn alle Ausdrücke als „false“ ausgewertet werden.

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 „true“ ist. Gibt false zurück, wenn alle Ausdrücke „false“ sind.

Beispiel 1

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

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

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Mindestens ein Ausdruck ist gleich „true“, weshalb die Funktion true zurückgibt.
• 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))

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Mindestens ein Ausdruck ist gleich „true“, weshalb die Funktion true zurückgibt.
• 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

Beispiel

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

rand(1, 5)

Als Ergebnis werden 1, 2, 3 oder 4 zurückgegeben.

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>	integer	Das Array mit ganzen Zahlen ab dem angegebenen Index

Beispiel

Dieses Beispiel erstellt ein ganzzahliges Array, das beim angegebenen Index 1 beginnt und dessen Anzahl von ganzen Zahlen als 4 angegeben ist:

range(1, 4)

Das Ergebnis [1, 2, 3, 4] wird zurückgegeben.

removeProperty

Entfernt eine Eigenschaft aus einem Objekt und gibt das aktualisierte Objekt zurück.

removeProperty(<object>, '<property>')

Parameter	Erforderlich	Type	Beschreibung
<object>	Ja	Objekt	Das JSON-Objekt, aus dem Sie eine Eigenschaft entfernen möchten
<property>	Ja	Zeichenfolge	Der Name der zu entfernenden Eigenschaft

Rückgabewert	type	BESCHREIBUNG
<updated-object>	Objekt	Das aktualisierte JSON-Objekt ohne die angegebene Eigenschaft

Beispiel

Dieses Beispiel entfernt die accountLocation-Eigenschaft aus einem customerProfile-Objekt, das mit der json()-Funktion in JSON konvertiert wird, und gibt das aktualisierte Objekt zurück:

removeProperty(json('customerProfile'), 'accountLocation')

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	Zeichenfolge	Die Zeichenfolge, die die Teilzeichenfolge enthält, die ersetzt werden soll
<oldText>	Ja	Zeichenfolge	Die Teilzeichenfolge, die ersetzt werden soll
<newText>	Ja	Zeichenfolge	Die Ersatzzeichenfolge

Rückgabewert	type	BESCHREIBUNG
<updated-text>	Zeichenfolge	Die aktualisierte Zeichenfolge, nachdem die Teilzeichenfolge ersetzt wurde. Wenn die Teilzeichenfolge nicht gefunden wird, gibt die Funktion die ursprüngliche Zeichenfolge zurück.

Beispiel 1

Dieses Beispiel sucht in the old string nach der Teilzeichenfolge old und ersetzt old durch new:

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

Das Ergebnis ist die Zeichenfolge the new string.

Beispiel 2

Wenn Escapezeichen verwendet werden, verarbeitet die Ausdrucks-Engine die Entfernung dieser Zeichen für Sie. Diese Funktion ersetzt Zeichenfolgen mit Escapezeichen.

replace('hello\"', '\"', '\n')
replace('hello\n', '\n', '\\\\')
@"replace('hello\\', '\\', '\\\\')"
@"replace('hello\n', '\n', '\\\\')"

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• hello\n
• hello\\
• @"hello\\"
• @"hello\\"

replaceIgnoreCase

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

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<text>	Ja	Zeichenfolge	Die Zeichenfolge, die die Teilzeichenfolge enthält, die ersetzt werden soll
<oldText>	Ja	Zeichenfolge	Die Teilzeichenfolge, die ersetzt werden soll
<newText>	Ja	Zeichenfolge	Die Ersatzzeichenfolge

Rückgabewert	type	BESCHREIBUNG
<updated-text>	Zeichenfolge	Die aktualisierte Zeichenfolge, nachdem die Teilzeichenfolge ersetzt wurde. Wenn die Teilzeichenfolge nicht gefunden wird, wird die ursprüngliche Zeichenfolge zurückgegeben.

Beispiel

Dieses Beispiel sucht in der Zeichenfolge the old string nach der Teilzeichenfolge old und ersetzt old durch new:

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

Das Ergebnis the new string wird zurückgegeben.

rresolve

Gibt Zeichenfolge zurück, wenn eine angegebene Timex-Eigenschaft oder -Ausdruck sich auf eine gültige Uhrzeit bezieht. Gültige Uhrzeiten enthalten Stunden, Minuten und Sekunden.

resolve('<timestamp')

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält

Rückgabewert	type	Beschreibung
<return>	Zeichenfolge	Eine Zeichenfolge der zu bewertenden Timex-Eigenschaft oder des Timex-Ausdrucks.

Beispiele

Diese Beispiele zeigen, ob die angegebenen Zeichenfolgen auf gültige Uhrzeiten verweisen:

resolve(T14)
resolve(2020-12-20)
resolve(2020-12-20T14:20)

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• 14:00:00
• 2020-12-20
• 2020-12-20 14:20:00

reverse

Kehrt die Reihenfolge der Elemente in einer Zeichenfolge oder einem Array um.

reverse(<value>)

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Zeichenfolge oder Array	Die umzukehrende Zeichenfolge des Arrays.

Rückgabewert	type	Beschreibung
<return>	Zeichenfolge oder Array	Die umgekehrten Elemente einer Zeichenfolge oder eines Arrays.

Beispiele

Kehrt die Reihenfolge der Elemente in einer Zeichenfolge oder einem Array umgekehrt.

reverse(hello)
reverse(concat(hello,world))

Und geben die folgenden Werte zurück:

-Die Zeichenfolge olleh. -Die Zeichenfolge dlrowolleh.

round

Rundet einen Wert auf die nächste Ganzzahl oder auf die angegebene Anzahl von Bruchstellen.

round('<number>', '<precision-digits>')

Parameter	Erforderlich	Type	Beschreibung
<number>	Ja	Zahl	Eine Eingabenummer
<precision-digits>	No	integer	Eine angegebene Anzahl von Dezimalstellen. Der Standardwert ist 0.

Rückgabewert	type	Beschreibung
<Rückgabewert>	Zahl	Der Rückgabewert der Eingabe, die auf eine angegebene Anzahl von Dezimalstellen gerundet wurde

Beispiel 1

In diesem Beispiel wird die Zahl 10,333 gerundet:

round(10.333)

Und gibt die Zahl 10 zurück.

Beispiel 2

In diesem Beispiel wird die Zahl 10,3313 auf 2 Bruchstellen gerundet:

round(10.3313, 2)

Und gibt die Zahl 10,33 zurück.

select

Wird für jedes Element ausgeführt und gibt die neue Sammlung transformierter Elemente zurück.

select([<collection/instance>], <iteratorName>, <function>)

Parameter	Erforderlich	Type	Beschreibung
<collection/instance>	Ja	array	Die Sammlung mit den Elementen
<iteratorName>	Ja	Name des Iterators	Das Schlüsselelement
<function>	Ja	expression	Die Funktion, die iteratorName enthält

Rückgabewert	type	Beschreibung
<new-collection>	array	Die neue Sammlung, in der jedes Element mit der Funktion ausgewertet wurde

Beispiel 1

Dieses Beispiel generiert eine neue Sammlung:

select(createArray(0, 1, 2, 3), x, x + 1)

Das Ergebnis [1, 2, 3, 4] wird zurückgegeben.

Beispiel 2

Diese Beispiele generiert eine neue Sammlung:

select(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
select(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))

Das Ergebnis ['name:jack', 'age:15'] wird zurückgegeben. Beachten Sie, dass der zweite Ausdruck ein Lambda-Ausdruck ist, den einige besser lesbar finden.

sentenceCase

Großschreibung des ersten Buchstabens des ersten Worts in einer Zeichenfolge in einem optionalen Gebietsschemaformat.

sentenceCase('<text>', '<locale>'?)

Parameter	Erforderlich	Type	BESCHREIBUNG
<text>	Ja	Zeichenfolge	Die ursprüngliche Zeichenfolge
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	Beschreibung
result string	string	Gibt das Ergebnis der Groß-/Kleinschreibung des Satzes zurück.

Beispiel 1

In diesen Beispielen wird der erste Buchstabe in einer Zeichenfolge großgeschrieben:

sentenceCase('a')
sentenceCase('abc def')
sentenceCase('aBC dEF')

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• A
• Abc def
• Abc def

Beispiel 2

In diesen Beispielen wird der erste Buchstabe in einer Zeichenfolge im angegebenen Gebietsschemaformat großgeschrieben:

sentenceCase('a', 'fr-FR')
sentenceCase('abc', 'en-US')
sentenceCase('aBC', 'fr-FR')

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• A
• Abc
• Abc

setPathToValue

Ruft den Wert der angegebenen Eigenschaft aus dem JSON-Objekt ab.

setPathToValue(<path>, <value>)

Parameter	Erforderlich	Type	Beschreibung
<Pfad>	Ja	Objekt	Der Pfad, den Sie festlegen möchten
<value>	Ja	Objekt	Der Wert, den Sie für den Pfad festlegen möchten

Rückgabewert	type	BESCHREIBUNG
value	Objekt	Der festzulegende Wert

Beispiel 1

Das folgende Beispiel legt den Wert 1 auf den Pfad fest:

setPathToValue(path.x, 1)

Das Ergebnis 1 wird zurückgegeben. path.x ist auf 1 festgelegt.

Beispiel 2

Dieses Beispiel legt den Wert fest:

setPathToValue(path.array[0], 7) + path.array[0]

Das Ergebnis 14 wird zurückgegeben.

setProperty

Legt den Wert der Eigenschaft eines Objekts fest und gibt das aktualisierte Objekt zurück. Um eine neue Eigenschaft hinzuzufügen, verwenden Sie diese Funktion oder die addProperty()-Funktion.

setProperty(<object>, '<property>', <value>)

Parameter	Erforderlich	Type	Beschreibung
<object>	Ja	Objekt	Das JSON-Objekt, in dem Sie eine Eigenschaft festlegen möchten
<property>	Ja	Zeichenfolge	Der Name der festzulegenden Eigenschaft
<value>	Ja	any	Der Wert, auf den die angegebene Eigenschaft festgelegt werden soll

Rückgabewert	type	BESCHREIBUNG
<updated-object>	Objekt	Das aktualisierte JSON-Objekt, dessen Eigenschaft Sie festlegen

Beispiel

Dieses Beispiel legt die accountNumber-Eigenschaft in einem customerProfile-Objekts fest, das mit der json()-Funktion in JSON konvertiert wird. Die Funktion weist einen Wert zu, der von der newGuid()-Funktion generiert wird, und gibt das aktualisierte JSON-Objekt zurück:

setProperty(json('customerProfile'), 'accountNumber', newGuid())

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
<updatedCollection>	array	Die aktualisierte Auflistung, nachdem die angegebenen Elemente entfernt wurden

Beispiel

Dieses Beispiel entfernt ein Element – die Zahl 1 – vom Anfang des angegebenen Arrays:

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

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

sortBy

Sortiert Elemente in der Sammlung in aufsteigender Reihenfolge und gibt die sortierte Sammlung zurück.

sortBy([<collection>], '<property>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<collection>	Ja	Zeichenfolge oder Array	Die zu sortierende Sammlung
<property>	Nein	Zeichenfolge	Sortiert nach dieser bestimmten Eigenschaft des Objektelements in der Sammlung, sofern festgelegt

Rückgabewert	type	Beschreibung
<new-collection>	array	Die neue Sammlung, deren Elemente sortiert wurden

Beispiel 1

Dieses Beispiel generiert die folgende sortierte Sammlung:

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

Das Ergebnis [0, 1, 2, 3] wird zurückgegeben.

Beispiel 2

Angenommen, Sie verfügen über die folgende Sammlung:

{
  'nestedItems': [
    {'x': 2},
    {'x': 1},
    {'x': 3}
  ]
}

Dieses Beispiel generiert eine neue sortierte Sammlung basierend auf der Objekteigenschaft x

sortBy(nestedItems, 'x')

Dieses Ergebnis wird zurückgegeben:

{
  'nestedItems': [
    {'x': 1},
    {'x': 2},
    {'x': 3}
  ]
}

sortByDescending

Sortiert Elemente in der Sammlung in absteigender Reihenfolge und gibt die sortierte Sammlung zurück.

sortBy([<collection>], '<property>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<collection>	Ja	Zeichenfolge oder Array	Die zu sortierende Sammlung
<property>	Nein	Zeichenfolge	Sortiert nach dieser bestimmten Eigenschaft des Objektelements in der Sammlung, sofern festgelegt

Rückgabewert	type	Beschreibung
<new-collection>	array	Die neue Sammlung, deren Elemente sortiert wurden

Beispiel 1

Dieses Beispiel generiert eine neue sortierte Sammlung:

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

Das Ergebnis [3, 2, 1, 0] wird zurückgegeben.

Beispiel 2

Angenommen, Sie verfügen über die folgende Sammlung:

{
  'nestedItems': [
    {'x': 2},
    {'x': 1},
    {'x': 3}
  ]
}

Dieses Beispiel generiert eine neue sortierte Sammlung basierend auf der Objekteigenschaft x:

sortByDescending(nestedItems, 'x')

Dies ist das zurückgegebene Ergebnis:

{
  'nestedItems': [
    {'x': 3},
    {'x': 2},
    {'x': 1}
  ]
}

split

Gibt ein Array mit Teilzeichenfolgen, die durch Trennzeichen getrennt sind, basierend auf einem angegebenen Trennzeichen in der ursprünglichen Zeichenfolge zurück.

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<text>	Ja	Zeichenfolge	Die Zeichenfolge, die anhand des angegebenen Trennzeichens in der ursprünglichen Zeichenfolge in Teilzeichenfolgen unterteilt wird. Wenn der Text ein NULL-Wert ist, wird er als leere Zeichenfolge betrachtet.
<delimiter>	No	Zeichenfolge	Das Zeichen in der ursprünglichen Zeichenfolge, das als Trennzeichen verwendet wird. Wenn kein Trennzeichen angegeben wurde oder das Trennzeichen ein NULL-Wert ist, ist der Standardwert eine leere Zeichenfolge.

Rückgabewert	type	Beschreibung
[<substring1>,<substring2>,...]	array	Ein Array mit Teilzeichenfolgen aus der ursprünglichen Zeichenfolge, das durch Trennzeichen getrennt ist

Beispiele

Dieses Beispiel erstellt ein Array mit Teilzeichenfolgen aus der angegebenen Zeichenfolge, basierend auf dem angegebenen Trennzeichen:

split('a**b**c', '**')
split('hello', '')
split('', 'e')
split('', '')
split('hello')

Es werden jeweils die folgenden Arrays als Ergebnis zurückgegeben:

• ["a", "b", "c"]
• ["h", "e", "l", "l", "o"]
• [""], [ ]
• ["h", "e", "l", "l", "o"]

sqrt

Gibt die Quadratwurzel einer angegebenen Zahl zurück.

sqrt(<number>)

Parameter	Erforderlich	Type	Beschreibung
<number>	Ja	Zahl	Zahl zum Abrufen der Quadratwurzel von

Rückgabewert	type	Beschreibung des Dataflows
<result>	Zahl	Das Ergebnis aus der Berechnung der Quadratwurzel.

Beispiele

In diesen Beispielen wird die Quadratwurzel der angegebenen Zahlen berechnet:

sqrt(9)
sqrt(0)

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• 3
• 0

startOfDay

Gibt den Anfang des Tages für einen Zeitstempel in einem optionalen Gebietsschemaformat zurück.

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	Beschreibung
'<updated-timestamp>'	Zeichenfolge	Der angegebene Zeitstempel, der bei Stunde 0 für den Tag beginnt

Beispiel 1

Dieses Beispiel sucht nach dem Anfang des Tags:

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

Das Ergebnis 2018-03-15T00:00:00.000Z wird zurückgegeben.

Beispiel 2

In diesem Beispiel wird der Anfang des Tages mit dem Gebietsschema fr-FR gefunden:

startOfDay('2018-03-15T13:30:30.000Z', '', 'fr-FR')

Das Ergebnis ist 15/03/2018 00:00:00.

startOfHour

Gibt den Anfang der Stunde für einen Zeitstempel in einem optionalen Gebietsschemaformat zurück.

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	Beschreibung
'<updated-timestamp>'	Zeichenfolge	Der angegebene Zeitstempel, der bei Minute 0 für die Stunde beginnt

Beispiel 1

Dieses Beispiel sucht nach dem Anfang der Stunde:

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

Das Ergebnis 2018-03-15T13:00:00.000Z wird zurückgegeben.

Beispiel 2

In diesem Beispiel wird der Anfang der Stunde mit dem Gebietsschema fr-FR gefunden:

startOfHour('2018-03-15T13:30:30.000Z', '', 'fr-FR')

Das Ergebnis ist 15/03/2018 00:00:00.

startOfMonth

Gibt den Beginn des Monats für einen Zeitstempel in einem optionalen Gebietsschemaformat zurück.

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	Beschreibung
'<updated-timestamp>'	Zeichenfolge	Der angegebene Zeitstempel, der am ersten Tag des Monats bei Stunde 0 beginnt

Beispiel 1

Dieses Beispiel sucht nach dem Anfang des Monats:

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

Das Ergebnis 2018-03-01T00:00:00.000Z wird zurückgegeben.

Beispiel 2

Dieses Beispiel sucht nach dem Anfang des Monats mit dem Gebietsschema fr-FR:

startOfMonth('2018-03-15T13:30:30.000Z', '', 'fr-FR')

Das Ergebnis ist 01/03/2018 00:00:00.

startsWith

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

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<text>	Ja	Zeichenfolge	Die Zeichenfolge, die überprüft werden soll
<searchText>	Ja	Zeichenfolge	Die beginnende Teilzeichenfolge, nach der gesucht werden soll

Rückgabewert	type	BESCHREIBUNG
true oder false	Boolean	Gibt true zurück, wenn die beginnende Teilzeichenfolge gefunden wurde. Andernfalls wird false zurückgegeben.

Beispiel 1

Dieses Beispiel überprüft, ob die Zeichenfolge hello world mit der Teilzeichenfolge hello beginnt:

startsWith('hello world', 'hello')

Das Ergebnis true wird zurückgegeben.

Beispiel 2

Dieses Beispiel überprüft, ob die Zeichenfolge hello world mit der Teilzeichenfolge greeting beginnt:

startsWith('hello world', 'greeting')

Das Ergebnis false wird zurückgegeben.

Zeichenfolge

Gibt die Zeichenfolgen-Version eines Werts in einem optionalen Gebietsschemaformat zurück.

string(<value>, '<locale>'?)

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	any	Der zu konvertierende Wert
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<string-value>	Zeichenfolge	Die Zeichenfolgenversion des angegebenen Werts

Beispiel 1

Dieses Beispiel erstellt die Zeichenfolgenversion der Zahl 10:

string(10)

Das Zeichenfolgenergebnis 10 wird zurückgegeben.

Beispiel 2

Dieses Beispiel erstellt eine Zeichenfolge für das angegebene JSON-Objekt und verwendet den umgekehrten Schrägstrich (\\) als Escapezeichen für das doppelte gerade Anführungszeichen (").

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

Das Ergebnis ist { "name": "Sophie Owen" }

Beispiel 3

In diesem Beispiel wird eine Zeichenfolgen-Version der Zahl 10 in einem bestimmten Gebietsschema erstellt:

string(100.1, 'fr-FR')
string(100.1, 'en-US')

Und gibt die folgenden Zeichenfolgen zurück:

• 100,1
• 100.1

stringOrValue

Zeichenfolgen-Interpolation umbrechen, um echten Wert zu erhalten. Zum Beispiel gibt stringOrValue('${1}') die Zahl 1 zurück, während stringOrValue('${1} item') die Zeichenfolge „1 Element“ zurückgibt.

stringOrValue(<string>)

Parameter	Erforderlich	Type	Beschreibung
<string>	Ja	Zeichenfolge	Die Zeichenfolge, aus der der reale Wert abgerufen werden soll.

Rückgabewert	type	Beschreibung des Dataflows
<result>	any	Das Ergebnis dessen, den tatsächlichen Wert der angegebenen Zeichenfolge abzurufen.

Beispiele

In diesen Beispielen wird der reale Wert aus der Zeichenfolge abgerufen:

stringOrValue('${one}')
stringOrValue('${one} item')

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• Die Zahl 1.0.
• Die Zeichenfolge 1 Element.

sub

Gibt das Ergebnis aus der Subtraktion der zweiten Zahl von der ersten Zahl zurück.

sub(<minuend>, <subtrahend>)

Parameter	Erforderlich	Type	BESCHREIBUNG
<minuend>	Ja	Zahl	Die Zahl, von der subtrahend subtrahiert werden soll
<subtrahend>	Ja	Zahl	Die Zahl, die von minuend subtrahiert werden soll

Rückgabewert	type	Beschreibung des Dataflows
<result>	Zahl	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)

Das Ergebnis 10 wird zurückgegeben.

subArray

Gibt ein Teilarray von der angegebenen Anfangs- und Endposition zurück. Indexwerte beginnen bei 0.

subArray(<Array>, <startIndex>, <endIndex>)

Parameter	Erforderlich	Type	BESCHREIBUNG
<array>	Ja	array	Das Array, aus dem das Teilarray erstellt werden soll
<startIndex>	Ja	integer	Eine positive Zahl größer oder gleich 0, die als Anfangsposition oder Anfangsindexwert verwendet werden soll
<endIndex>	Ja	integer	Eine positive Zahl größer oder gleich 0, die als Endposition oder Endindexwert verwendet werden soll

Rückgabewert	type	Beschreibung
<subarray-result>	array	Ein Teilarray mit der angegebenen Anzahl von Elementen, das an der angegebenen Indexposition in der Quellzeichenfolge beginnt

Beispiel

Dieses Beispiel erstellt ein Teilarray aus dem angegebenen Array:

subArray(createArray('H','e','l','l','o'), 2, 5)

Das Ergebnis ["l", "l", "o"] wird zurückgegeben.

substring

Gibt Zeichen aus einer Zeichenfolge zurück, beginnend bei der angegebenen Position oder dem angegebenen Indexwert. Indexwerte beginnen bei 0.

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<text>	Ja	Zeichenfolge	Die Zeichenfolge, aus der die Teilzeichenfolge erstellt werden soll
<startIndex>	Ja	integer	Eine positive Zahl größer oder gleich 0, die als Anfangsposition oder Anfangsindexwert verwendet werden soll
<length>	Ja	integer	Eine positive Anzahl von Zeichen, die in der Teilzeichenfolge enthalten sein sollen

Rückgabewert	type	BESCHREIBUNG
<substring-result>	Zeichenfolge	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)

Das Ergebnis world wird zurückgegeben.

subtractFromTime

Subtrahiert eine Anzahl von Zeiteinheiten von einem Zeitstempel in einem optionalen Gebietsschemaformat. Siehe auch getPastTime().

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält
<interval>	Ja	integer	Die Anzahl der angegebenen Zeiteinheiten, die subtrahiert werden sollen
<timeUnit>	Ja	Zeichenfolge	Die mit interval zu verwendende Zeiteinheit. Mögliche Einheiten sind „Second“, „Minute“, „Hour“, „Day“, „Week“, „Month“ und „Year“.
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<updated-timestamp>	Zeichenfolge	Der Zeitstempel abzüglich der angegebenen Anzahl von Zeiteinheiten

Beispiel 1

Dieses Beispiel subtrahiert einen Tag von folgendem Zeitstempel:

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

Das Ergebnis 2018-01-01T00:00:00.000Z wird zurückgegeben.

Beispiel 2

Dieses Beispiel subtrahiert mithilfe des D-Formats einen Tag von folgendem Zeitstempel:

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

Und gibt das Ergebnis Montag, 1. Januar 2018 zurück.

Beispiel 3

In diesem Beispiel wird 1 Stunde von einem Zeitstempel im Gebietsschema de-DE subtrahiert:

subtractFromTime('2018-03-15T13:00:00.000Z', 1, 'Hour', '', 'de-DE')

Das Ergebnis ist 15.03.18 12:00:00.

Sum

Gibt das Ergebnis der Addition von Zahlen in einer Liste zurück.

sum([<list of numbers>])

Parameter	Erforderlich	Type	Beschreibung
[<list of numbers>]	Ja	Array aus Zahlen	Die zu addierenden Zahlen

Rückgabewert	type	BESCHREIBUNG
<result-sum>	Zahl	Das Ergebnis der Addition der angegebenen Zahlen

Beispiel

In diesem Beispiel werden die angegebenen Zahlen addiert:

sum(createArray(1, 1.5))

Das Ergebnis 2.5 wird zurückgegeben.

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)

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• abc
• [0, 1, 2]

ticks

Gibt den Wert der Ticks-Eigenschaftswert eines angegebenen Zeitstempels zurück. Ein „tick“ ist ein Intervall von 100 Nanosekunden.

ticks('<timestamp>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge für einen Zeitstempel

Rückgabewert	type	BESCHREIBUNG
<ticks-number>	Integer (bigint in JavaScript)	Die Anzahl von Ticks seit dem angegebenen Zeitstempel

Beispiel

Das Beispiel konvertiert einen Zeitstempel in die ticks-Eigenschaft

ticks('2018-01-01T08:00:00.000Z')

Das Ergebnis 636503904000000000 wird zurückgegeben.

ticksToDays

Wandeln Sie einen Ticks-Eigenschaftswert in die Anzahl der Tage um.

ticksToDays('ticks')

Parameter	Erforderlich	Type	Beschreibung
<ticks>	Ja	integer	Der zu konvertierende Ticks-Eigenschaftswert

Rückgabewert	type	Beschreibung
<number-of-days>	Zahl	Die Anzahl der Tage, die aus dem Ticks-Eigenschaftswert konvertiert wurden

Beispiel

In diesem Beispiel wird ein Ticks-Eigenschaftswert in eine Anzahl von Tagen konvertiert:

ticksToDays(2193385800000000)

Und gibt die Zahl 2538.64097222 zurück.

ticksToHours

Wandeln Sie einen Ticks-Eigenschaftswert in die Anzahl der Stunden um.

ticksToHours('ticks')

Parameter	Erforderlich	Type	Beschreibung
<ticks>	Ja	Ganzzahl	Der zu konvertierende Ticks-Eigenschaftswert

Rückgabewert	type	Beschreibung
<number-of-hours>	Zahl	Die Anzahl der Stunden, die aus dem Ticks-Eigenschaftswert konvertiert wurden

Beispiel

In diesem Beispiel wird ein Ticks-Eigenschaftswert in eine Anzahl von Stunden konvertiert:

ticksToHours(2193385800000000)

Und gibt die Zahl 60927,383333333331 zurück.

ticksToMinutes

Wandeln Sie einen Ticks-Eigenschaftswert in die Anzahl der Minuten um.

ticksToMinutes('ticks')

Parameter	Erforderlich	Type	Beschreibung
<ticks>	Ja	integer	Der zu konvertierende Ticks-Eigenschaftswert

Rückgabewert	type	Beschreibung
<number-of-minutes>	Zahl	Die Anzahl der Minuten, die aus dem Ticks-Eigenschaftswert konvertiert wurden

Beispiel

In diesem Beispiel wird ein Ticks-Eigenschaftswert in eine Anzahl von Minuten konvertiert:

ticksToMinutes(2193385800000000)

Und gibt die Zahl 3655643,0185 zurück.

titleCase

Großschreibung des ersten Buchstabens jedes Worts in einer Zeichenfolge in einem optionalen lokalen Format.

titleCase('<text>', '<locale>'?)

Parameter	Erforderlich	Type	BESCHREIBUNG
<text>	Ja	Zeichenfolge	Die ursprüngliche Zeichenfolge
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	Beschreibung
result string	Zeichenfolge	Das Titelformat-Ergebnis

Beispiel 1

In diesen Beispielen wird der erste Buchstabe jedes Worts in einer Zeichenfolge großgeschrieben:

titleCase('a')
titleCase('abc def')
titleCase('aBC dEF')

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• A
• Abc Def
• Abc Def

Beispiel 2

In diesen Beispielen wird der erste Buchstabe in einer Zeichenfolge im en-US-Format großgeschrieben:

titleCase('a', 'en-US')
titleCase('aBC dEF', 'en-US')

Es werden jeweils die folgenden Ergebnisse zurückgegeben:

• A
• Abc Def

toLower

Zurückgeben einer Zeichenfolge in Kleinbuchstaben in einem optionalen Gebietsschemaformat. Gibt es für ein Zeichen in der Zeichenfolge keine Kleinschreibungsversion, verbleibt dieses Zeichen unverändert in der zurückgegebenen Zeichenfolge.

toLower('<text>', '<locale>'?)

Parameter	Erforderlich	Type	BESCHREIBUNG
<text>	Ja	Zeichenfolge	Die Zeichenfolge, die in Kleinbuchstaben zurückgegeben werden soll
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<lowercase-text>	Zeichenfolge	Die ursprüngliche Zeichenfolge in Kleinbuchstaben

Beispiel 1

Dieses Beispiel konvertiert eine Zeichenfolge in Kleinbuchstaben:

toLower('Hello World')

Das Ergebnis hello world wird zurückgegeben.

Beispiel 2

In diesem Beispiel wird eine Zeichenfolge in Kleinbuchstaben in das fr-FR-Format konvertiert:

toUpper('Hello World', 'fr-FR')

Das Ergebnis hello world wird zurückgegeben.

toUpper

Zurückgeben einer Zeichenfolge in Großbuchstaben in einem optionalen Gebietsschemaformat. Gibt es für ein Zeichen in der Zeichenfolge keine Großschreibungsversion, verbleibt dieses Zeichen unverändert in der zurückgegebenen Zeichenfolge.

toUpper('<text>', '<locale>'?)

Parameter	Erforderlich	Type	BESCHREIBUNG
<text>	Ja	Zeichenfolge	Die Zeichenfolge, die in Großbuchstaben zurückgegeben werden soll
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<uppercase-text>	Zeichenfolge	Die ursprüngliche Zeichenfolge in Großbuchstaben

Beispiel 1

Dieses Beispiel konvertiert eine Zeichenfolge in Großbuchstaben:

toUpper('Hello World')

Das Ergebnis HELLO WORLD wird zurückgegeben.

Beispiel 2

In diesem Beispiel wird eine Zeichenfolge in Großbuchstaben in das fr-FR-Format konvertiert:

toUpper('Hello World', 'fr-FR')

Das Ergebnis HELLO WORLD wird zurückgegeben.

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	Zeichenfolge	Die Zeichenfolge, in der sich die führenden und nachfolgende Leerzeichen befinden, die entfernt werden sollen

Rückgabewert	type	BESCHREIBUNG
<updatedText>	Zeichenfolge	Eine aktualisierte Version der ursprünglichen Zeichenfolge ohne führende oder nachfolgende Leerzeichen

Beispiel

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

trim(' Hello World  ')

Das zugeschnittene Ergebnis Hello World wird zurückgegeben.

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 beides	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. Es werden keine Duplikate hinzugefügt.

Beispiel

Dieses Beispiel ruft alle Elemente aus den folgenden Sammlungen ab:

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

Das Ergebnis [1, 2, 3, 10, 101] wird zurückgegeben.

unique

Entfernt alle Duplikate aus einem Array.

unique([<collection>])

Parameter	Erforderlich	Type	BESCHREIBUNG
<collection>	Ja	array	Die zu ändernde Sammlung

Rückgabewert	type	Beschreibung
<new-collection>	array	Neue Sammlung, aus der doppelte Elemente entfernt wurden

Beispiel 1

Dieses Beispiel entfernt doppelte Elemente aus dem folgenden Array:

unique(createArray(1, 2, 1))

Das Ergebnis [1, 2] wird zurückgegeben.

uriComponent

Gibt die Binärversion einer URI-Komponente (Uniform Resource Identifier) zurück.

uriComponent('<value>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Zeichenfolge	Die Zeichenfolge, die in das URI-codierte Format konvertiert werden soll

Rückgabewert	type	BESCHREIBUNG
<encoded-uri>	Zeichenfolge	Die URI-codierte Zeichenfolge mit Escapezeichen

Beispiel

Dieses Beispiel erstellt eine URI-codierte Version einer Zeichenfolge:

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

Das Ergebnis http%3A%2F%2Fcontoso.com wird zurückgegeben.

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	Zeichenfolge	Die URI-codierte Zeichenfolge, die decodiert werden soll

Rückgabewert	type	BESCHREIBUNG
<binary-for-encoded-uri>	Zeichenfolge	Die decodierte Version für die URI-codierte Zeichenfolge

Beispiel

Dieses Beispiel erstellt die decodierte Zeichenfolgenversion einer URI-codierten Zeichenfolge:

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

Das Ergebnis https://contoso.com wird zurückgegeben.

uriHost

Gibt den Wert für den Host eines Uniform Resource Identifier (URI) zurück.

uriHost('<uri>')

Parameter	Erforderlich	Type	Beschreibung
<uri>	Ja	Zeichenfolge	Der URI, dessen Wert für den Host Sie abrufen möchten

Rückgabewert	type	BESCHREIBUNG
<host-value>	Zeichenfolge	Der Wert für den Host des angegebenen URI

Beispiel

Dieses Beispiel sucht den Wert für den Host des folgenden URI:

uriHost('https://www.localhost.com:8080')

Das Ergebnis www.localhost.com wird zurückgegeben.

uriPath

Gibt den Wert für den Pfad eines Uniform Resource Identifier (URI) zurück.

uriPath('<uri>')

Parameter	Erforderlich	Type	Beschreibung
<uri>	Ja	Zeichenfolge	Der URI, dessen Wert für den Port Sie abrufen möchten

Rückgabewert	type	BESCHREIBUNG
<path-value>	Zeichenfolge	Der Wert für den Pfad des angegebenen URI

Beispiel

Dieses Beispiel sucht den Wert für den Pfad des folgenden URI:

uriPath('http://www.contoso.com/catalog/shownew.htm?date=today')

Das Ergebnis /catalog/shownew.htm wird zurückgegeben.

uriPathAndQuery

Gibt die Werte für den Pfad und die Abfrage eines Uniform Resource Identifier (URI) zurück.

uriPathAndQuery('<uri>')

Parameter	Erforderlich	Type	Beschreibung
<uri>	Ja	Zeichenfolge	Der URI, dessen Werte für Pfad und Abfrage Sie abrufen möchten

Rückgabewert	type	BESCHREIBUNG
<path-query-value>	Zeichenfolge	Die Wert für den Pfad und die Abfrage des angegebenen URI

Beispiel

Dieses Beispiel sucht dem Wert für den Pfad und nach dem Wert für die Abfrage des folgenden URI:

uriPathAndQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Das Ergebnis /catalog/shownew.htm?date=today wird zurückgegeben.

uriPort

Gibt den Wert für den Port eines Uniform Resource Identifier (URI) zurück.

uriPort('<uri>')

Parameter	Erforderlich	Type	Beschreibung
<uri>	Ja	Zeichenfolge	Der URI, dessen Wert für den Port Sie abrufen möchten

Rückgabewert	type	BESCHREIBUNG
<port-value>	Zeichenfolge	Der Wert für den Port des angegebenen URI

Beispiel

Dieses Beispiel sucht den Wert für den Port des folgenden URI:

uriPort('http://www.localhost:8080')

Das Ergebnis 8080 wird zurückgegeben.

uriQuery

Gibt den Wert für die Abfrage eines Uniform Resource Identifier (URI) zurück.

uriQuery('<uri>')

Parameter	Erforderlich	Type	Beschreibung
<uri>	Ja	Zeichenfolge	Der URI, dessen Wert für die Abfrage Sie abrufen möchten

Rückgabewert	type	BESCHREIBUNG
<query-value>	Zeichenfolge	Der Wert für die Abfrage des angegebenen URI

Beispiel

Dieses Beispiel sucht den Wert für die Abfrage des folgenden URI:

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Das Ergebnis ?date=today wird zurückgegeben.

uriScheme

Gibt den Wert für das Schema eines Uniform Resource Identifier (URI) zurück.

uriScheme('<uri>')

Parameter	Erforderlich	Type	Beschreibung
<uri>	Ja	Zeichenfolge	Der URI, dessen Wert für die Abfrage Sie abrufen möchten

Rückgabewert	type	BESCHREIBUNG
<scheme-value>	Zeichenfolge	Der Wert für das Schema des angegebenen URI

Beispiel

Dieses Beispiel sucht den Wert für das Schema des folgenden URI:

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Das Ergebnis http wird zurückgegeben.

utcNow

Gibt den Zeitstempel als Zeichenfolge in optionalem Gebietsschemaformat zurück.

utcNow('<format>', '<locale>'?)

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

Parameter	Erforderlich	Type	BESCHREIBUNG
<format>	Nein	Zeichenfolge	Ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist das UTC-ISO-Format YYYY-MM-DDTHH:mm:ss.fffZ, das ISO 8601-konform ist.
<locale>	Nein	Zeichenfolge	Ein optionales Gebietsschema der Kulturinformationen

Rückgabewert	type	BESCHREIBUNG
<current-timestamp>	Zeichenfolge	Das aktuelle Datum und die aktuelle Uhrzeit

Beispiel 1

Angenommen, das Datum lautet April 15, 2018 und die Uhrzeit 1:00:00 PM. Dieses Beispiel ruft den Zeitstempel ab:

utcNow()

Das Ergebnis 2018-04-15T13:00:00.000Z wird zurückgegeben.

Beispiel 2

Angenommen, das Datum lautet April 15, 2018 und die Uhrzeit 1:00:00 PM. Dieses Beispiel ruft den aktuellen Zeitstempel im optionalen D-Format ab:

utcNow('D')

Das Ergebnis Sunday, April 15, 2018 wird zurückgegeben.

Beispiel 3

Angenommen, das Datum lautet April 15, 2018 und die Uhrzeit 1:00:00 PM. Dieses Beispiel ruft den aktuellen Zeitstempel im optionalen de–DE-Gebietsschema ab:

utcNow('', 'de-DE')

Das Ergebnis ist 15.04.18 13:00:00.

where

Filtert nach jedem Element und gibt die neue Sammlung gefilterter Elemente zurück, die einer angegebenen Bedingung entsprechen.

where([<collection/instance>], <iteratorName>, <function>)

Parameter	Erforderlich	Type	Beschreibung
<collection/instance>	Ja	array	Die Sammlung mit den Elementen
<iteratorName>	Ja	Name des Iterators	Das Schlüsselelement
<function>	Ja	expression	Bedingungsfunktion zum Filtern von Elementen

Rückgabewert	type	Beschreibung
<new-collection/new-object>	Array/Objekt	Die neue Sammlung, in der jedes Element mit der Funktion gefiltert wurde

Beispiel 1

Dieses Beispiel generiert eine neue Sammlung:

where(createArray(0, 1, 2, 3), x, x > 1)

Das Ergebnis [2, 3] wird zurückgegeben.

Beispiel 2

Diese Beispiele generiert eine neue Sammlung:

where(json("{'name': 'jack', 'age': '15'}"), x, x.value == 'jack')
where(json("{'name': 'jack', 'age': '15'}"), x=> x.value == 'jack')

Das Ergebnis ['name:jack', 'age:15'] wird zurückgegeben. Beachten Sie, dass der zweite Ausdruck ein Lambda-Ausdruck ist, den einige besser lesbar finden.

xml

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

xml('<value>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<value>	Ja	Zeichenfolge	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 \ als Escapezeichen für das doppelte gerade Anführungszeichen (").

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

Beispiel 1

Dieses Beispiel erstellt die XML-Version für eine Zeichenfolge, die ein JSON-Objekt enthält:

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

Das XML-Ergebnis wird zurückgegeben:

<name>Sophia Owen</name>

Beispiel 2

Im Folgenden sehen Sie ein Beispiel für ein person-JSON-Objekt:

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

Dieses Beispiel erstellt die XML-Version einer Zeichenfolge, die dieses JSON-Objekt enthält:

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

Das XML-Ergebnis wird zurückgegeben:

<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“) hilft beim 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>, ...] -or- [<value1>, <value2>, ...]>	array	Ein Array mit XML-Knoten oder -Werten, die mit den angegebenen XPath-Ausdruck übereinstimmen

Beispiel 1

In diesem Beispiel wird nach Knoten gesucht,die mit dem <name></name>-Knoten in den angegebenen Argumenten übereinstimmen, und es wird ein Array mit diesen Knotenwerten zurückgegeben:

xPath(items, '/produce/item/name')

Die Argumente umfassen die items-Zeichenfolge mit diesem XML-Inhalt:

"<?xml version="1.0"?> <produce> <item> <name>Gala</name> <type>apple</type> <count>20</count> </item> <item> <name>Honeycrisp</name> <type>apple</type> <count>10</count> </item> </produce>"

Dies ist das Ergebnisarray mit den Knoten, die mit <name></name> übereinstimmen:

[ <name>Gala</name>, <name>Honeycrisp</name> ]

Beispiel 2

Ähnlich wie in 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)')

Das Ergebnis 30 wird zurückgegeben.

year

Gibt das Jahr des angegebenen Zeitstempels zurück.

year('<timestamp>')

Parameter	Erforderlich	Type	BESCHREIBUNG
<timestamp>	Ja	Zeichenfolge	Die Zeichenfolge, die den Zeitstempel enthält

Rückgabewert	type	Beschreibung
<year>	integer	Das Jahr im angegebenen Zeitstempel

Beispiel

Dieses Beispiel wertet den Zeitstempel für das Jahr aus:

year('2018-03-15T00:00:00.000Z')

Das Ergebnis 2018 wird zurückgegeben.