Wstępnie utworzone funkcje wyrażeń adaptacyjnych

DOTYCZY: ZESTAW SDK w wersji 4

W tym artykule wymieniono dostępne wstępnie utworzone funkcje uporządkowane według ogólnego przeznaczenia. Aby uzyskać informacje na temat operatorów używanych w wstępnie utworzonych funkcji i składni wyrażeń, zobacz Operatory.

Wstępnie utworzone wyrażenia są podzielone na następujące typy funkcji:

• ciąg
• Kolekcja
• Porównanie logiczne
• Konwersja
• Matematyka
• Data
• Timex
• Analizowanie identyfikatora URI
• Manipulowanie obiektami i konstruowanie
• Wyrażenie regularne
• Sprawdzanie typów

Listę można również wyświetlić w kolejności alfabetycznej.

Funkcje ciągów

Function	Wyjaśnienie
length	Zwraca długość ciągu.
replace	Zastąp podciąg określonym ciągiem i zwróć zaktualizowany ciąg. Ta funkcja uwzględnia wielkość liter.
replaceIgnoreCase	Zastąp podciąg określonym ciągiem i zwróć zaktualizowany ciąg. Ta funkcja nie uwzględnia wielkości liter.
split	Zwraca tablicę zawierającą podciągi na podstawie określonego ogranicznika.
Podciąg	Zwraca znaki z ciągu.
toLower	Zwraca ciąg w małych literach w opcjonalnym formacie ustawień regionalnych.
toUpper	Zwraca ciąg w wielkich literach w opcjonalnym formacie ustawień regionalnych.
przycinać	Usuń wiodące i końcowe białe spacje z ciągu.
addOrdinal	Zwraca liczbę porządkową numeru wejściowego.
endsWith	Sprawdź, czy ciąg kończy się określonym podciągem. Zwróć, true jeśli podciąg zostanie znaleziony, lub zwróć false wartość , jeśli nie zostanie znaleziona. Ta funkcja nie uwzględnia wielkości liter.
startsWith	Sprawdź, czy ciąg rozpoczyna się od określonego podciągu. Zwróć, true jeśli podciąg zostanie znaleziony, lub zwróć false wartość , jeśli nie zostanie znaleziona. Ta funkcja nie uwzględnia wielkości liter.
countWord	Zwraca liczbę wyrazów w danym ciągu.
concat	Połącz co najmniej dwa ciągi i zwróć wynikowy ciąg.
newGuid	Zwróć nowy ciąg Guid.
indexOf	Zwraca wartość pozycji początkowej lub indeksu podciągów lub wyszukuje określony obiekt i zwraca indeks zera pierwszego wystąpienia na całej liście. Ta funkcja jest niewrażliwa na wielkość liter, a indeksy zaczynają się od liczby 0.
lastIndexOf	Zwróć wartość pozycji początkowej lub indeksu ostatniego wystąpienia podciągów lub wyszukaj określony obiekt i zwróć indeks zerowy ostatniego wystąpienia w zakresie elementów na liście. Ta funkcja jest niewrażliwa na wielkość liter, a indeksy zaczynają się od liczby 0.
sentenceCase	Wielką literą pierwszego wyrazu w ciągu w opcjonalnym formacie lokalnym.
titleCase	Wielką literą każdego wyrazu w ciągu w opcjonalnym formacie ustawień regionalnych.
reverse	Odwraca kolejność elementów w ciągu lub tablicy.

Funkcje odbioru

Function	Wyjaśnienie
Contains	Działa w celu znalezienia elementu w ciągu, znalezienia elementu w tablicy lub znalezienia parametru w obiekcie złożonym. Przykłady: contains('hello world', 'hello') contains(createArray('1','2'), '1') contains(json("{'foo':'bar'}"), 'foo')
pierwszy	Zwróć pierwszy element z kolekcji.
join	Zwróć ciąg, który zawiera wszystkie elementy z tablicy i ma każdy znak oddzielony ogranicznikiem. Przykład: join(createArray('a','b'), '.') = "a.b"
ostatni	Zwróć ostatni element z kolekcji.
count	Zwróć liczbę elementów w kolekcji.
foreach	Operuj na każdym elemecie i zwracaj nową kolekcję.
unia	Zwróć kolekcję zawierającą wszystkie elementy z określonych kolekcji.
pominąć	Usuń elementy z przodu kolekcji i zwróć pozostałe elementy.
brać	Zwracanie elementów z przodu kolekcji.
skrzyżowanie	Zwróć kolekcję zawierającą tylko wspólne elementy w określonych kolekcjach.
subArray	Zwróć podarraj z określonej pozycji początkowej i końcowej. Wartości indeksu zaczynają się od liczby 0.
wybrać	Działanie na każdym elemecie i zwracanie nowej kolekcji przekształconych elementów.
gdzie	Odfiltruj każdy element i zwróć nową kolekcję filtrowanych elementów, które pasują do określonego warunku.
sortBy	Sortuj elementy w kolekcji w kolejności rosnącej i zwracają posortowaną kolekcję.
sortByDescending	Sortuj elementy w kolekcji w kolejności malejącej i zwracają posortowaną kolekcję.
indeksyAndValues	Przekształcanie tablicy lub obiektu w tablicę obiektów z właściwością indeksu i wartości.
spłaszczyć	Spłaszczanie tablic do tablicy z wartościami bez tablicy.
unique	Usuń wszystkie duplikaty z tablicy.
jakikolwiek	Określa, czy dowolne elementy sekwencji spełniają warunek.
wszystkie	Ustal, czy wszystkie elementy sekwencji spełniają warunek.
reverse	Odwraca kolejność elementów w ciągu lub tablicy.
połączyć	Scala wiele obiektów JSON lub elementów w tablicy razem.

Logiczne funkcje porównywania

Function	Wyjaśnienie
and	Logiczne i. Zwraca wartość true, jeśli wszystkie określone wyrażenia mają wartość true.
equals	Porównanie równe. Zwraca wartość true, jeśli określone wartości są równe.
empty	Sprawdź, czy element docelowy jest pusty.
greater	Porównanie większe niż. Zwróć true , jeśli pierwsza wartość jest większa lub zwracana false , jeśli jest mniejsza.
greaterOrEquals	Porównanie większe niż lub równe. Zwróć true , jeśli pierwsza wartość jest większa lub równa, lub zwraca false , jeśli pierwsza wartość jest mniejsza.
jeśli	Sprawdź, czy wyrażenie ma wartość true, czy false. Na podstawie wyniku zwróć określoną wartość.
less	Porównanie mniejsze niż operacja. Zwróć, true jeśli pierwsza wartość jest mniejsza lub zwracana false , jeśli pierwsza wartość jest większa.
lessOrEquals	Porównanie mniejszej niż lub równej operacji. Zwróć true , jeśli pierwsza wartość jest mniejsza lub równa, lub zwracana false , jeśli pierwsza wartość jest większa.
nie	Operator nie logiczny. Zwróć, true jeśli wyrażenie ma wartość false lub zwraca false wartość true.
or	Operacja lub logiczna. Zwracaj true , jeśli co najmniej jedno wyrażenie ma wartość true, lub zwraca wartość false , jeśli wszystkie są fałszywe.
Istnieje	Oceń wyrażenie pod kątem prawdy.

Funkcje konwersji

Function	Wyjaśnienie
float	Zwraca reprezentację zmiennoprzecinkową określonego ciągu.
int	Zwraca reprezentację całkowitą określonego ciągu.
string	Zwraca wersję ciągu określonej wartości w opcjonalnym formacie ustawień regionalnych.
bool	Zwróć reprezentację logiczną określonego ciągu.
createArray	Utwórz tablicę na podstawie wielu danych wejściowych.
JSON	Zwróć wartość typu JavaScript Object Notation (JSON) lub obiekt ciągu lub XML.
base64	Zwróć zakodowaną w formacie base64 wersję ciągu lub tablicy bajtów.
base64ToBinary	Zwróć wersję binarną dla ciągu zakodowanego w formacie base64.
base64ToString	Zwraca wersję ciągu zakodowanego w formacie base64.
dwójkowy	Zwraca wersję binarną dla wartości wejściowej.
dataUri	Zwróć identyfikator URI dla wartości wejściowej.
dataUriToBinary	Zwraca wersję binarną identyfikatora URI danych.
dataUriToString	Zwraca wersję ciągu identyfikatora URI danych.
uriComponent	Zwróć wersję zakodowaną w formacie URI dla wartości wejściowej, zastępując znaki niebezpieczne adresu URL znakami ucieczki.
uriComponentToString	Zwraca wersję ciągu zakodowanego w identyfikatorze URI.
xml	Zwraca wersję XML ciągu.
formatNumber	Sformatuj wartość na najbliższą liczbę z określoną liczbą cyfr ułamkowych i opcjonalnymi określonymi ustawieniami regionalnymi.
jsonStringify	Zwróć ciąg JSON wartości.
stringOrValue Wrap interpolacja ciągów w celu uzyskania rzeczywistej wartości. Na przykład stringOrValue('${1}') zwraca liczbę 1, a funkcja stringOrValue('${1} item') zwraca ciąg "1 element".

Funkcje matematyczne

Function	Wyjaśnienie
Abs	Zwraca wartość bezwzględną określonej liczby.
add	Matematyczne i. Zwróć wynik z dodania dwóch liczb (czysty przypadek liczbowy) lub łączenia co najmniej dwóch ciągów.
div	Podział matematyczny. Zwróć wynik liczby całkowitej z dzielenia dwóch liczb.
Max	Zwraca największą wartość z kolekcji.
Min	Zwraca najmniejszą wartość z kolekcji.
mod	Zwróć resztę z dzielenia dwóch liczb.
mul	Mnożenie matematyczne. Zwróć produkt z mnożenia dwóch liczb.
rand	Zwraca liczbę losową między określoną minimalną i maksymalną wartością.
Sqrt	Zwraca pierwiastek kwadratowy określonej liczby.
Sub	Odejmowanie matematyczne. Zwróć wynik odejmowania drugiej liczby z pierwszej liczby.
suma	Zwraca sumę liczb w tablicy.
range	Zwraca tablicę całkowitą rozpoczynającą się od określonej liczby całkowitej.
Exp	Zwraca wykładnik jednej liczby do innej.
średnia	Zwraca średnią liczbę tablicy liczbowej.
piętro	Zwraca największą wartość całkowitą mniejszą lub równą określonej liczbie.
sufit	Zwraca najmniejszą wartość całkowitą większą lub równą określonej liczbie.
okrągły	Zaokrąglij wartość do najbliższej liczby całkowitej lub do określonej liczby cyfr ułamkowych.

Funkcje daty i godziny

Function	Wyjaśnienie
addDays	Dodaj liczbę określonych dni do danego znacznika czasu w opcjonalnym formacie ustawień regionalnych.
addHours	Dodaj określoną liczbę godzin do danego znacznika czasu w opcjonalnym formacie ustawień regionalnych.
addMinutes	Dodaj określoną liczbę minut do danego znacznika czasu w opcjonalnym formacie ustawień regionalnych.
addSeconds	Dodaj określoną liczbę sekund do danego znacznika czasu.
dayOfMonth	Zwraca dzień miesiąca dla danego znacznika czasu lub wyrażenia Timex.
dayOfWeek	Zwróć dzień tygodnia dla danego znacznika czasu.
dayOfYear	Zwraca dzień roku dla danego znacznika czasu.
formatDateTime	Zwraca znacznik czasu w opcjonalnym formacie ustawień regionalnych.
formatEpoch	Zwraca znacznik czasu w opcjonalnym formacie ustawień regionalnych z czasu epoki systemu UNIX (czas systemu Unix, czas POSIX).
formatTicks	Zwraca znacznik czasu w opcjonalnym formacie ustawień regionalnych z znaczników.
odejmowanieFromTime	Odejmij liczbę jednostek czasu ze znacznika czasu w opcjonalnym formacie ustawień regionalnych.
utcNow	Zwraca bieżący znacznik czasu w opcjonalnym formacie ustawień regionalnych jako ciąg.
dateReadBack	Użyj biblioteki daty i godziny, aby podać odczyt zwrotny daty.
miesiąc	Zwróć miesiąc podanego znacznika czasu.
data	Zwraca datę dla danego znacznika czasu.
rok	Zwróć rok dla danego znacznika czasu.
getTimeOfDay	Zwróć godzinę dnia dla danego znacznika czasu.
getFutureTime	Zwróć bieżący znacznik czasu w opcjonalnym formacie ustawień regionalnych oraz określoną liczbę jednostek czasu.
getPastTime	Zwróć bieżący znacznik czasu w opcjonalnym formacie ustawień regionalnych minus określone jednostki czasu.
addToTime	Dodaj liczbę jednostek czasu do znacznika czasu w opcjonalnym formacie ustawień regionalnych.
convertFromUTC	Konwertowanie znacznika czasu w opcjonalnym formacie ustawień regionalnych z uniwersalnego czasu koordynowanego (UTC).
convertToUTC	Przekonwertuj znacznik czasu w opcjonalnym formacie ustawień regionalnych na uniwersalny czas koordynowany (UTC).
startOfDay	Zwróć początek dnia dla znacznika czasu w opcjonalnym formacie ustawień regionalnych.
startOfHour	Zwróć początek godziny dla znacznika czasu w opcjonalnym formacie ustawień regionalnych.
startOfMonth	Zwróć początek miesiąca dla znacznika czasu w opcjonalnym formacie ustawień regionalnych.
Kleszcze	Zwraca wartość właściwości znacznika czasu.
ticksToDays	Przekonwertuj wartość właściwości znacznika na liczbę dni.
ticksToHours	Przekonwertuj wartość właściwości znacznika na liczbę godzin.
ticksToMinutes	Przekonwertuj wartość właściwości znacznika na liczbę minut.
dateTimeDiff	Zwróć różnicę w znacznikach czasu między dwoma znacznikami czasu.
getPreviousViableDate	Zwróć poprzednią realną datę wyrażenia Timex na podstawie bieżącej daty i opcjonalnej określonej strefy czasowej.
getNextViableDate	Zwróć kolejną realną datę wyrażenia Timex na podstawie bieżącej daty i opcjonalnej określonej strefy czasowej.
getPreviousViableTime	Zwróć poprzedni realny czas wyrażenia Timex na podstawie bieżącej godziny i opcjonalnie określonej strefy czasowej.
getNextViableTime	Zwróć następny realny czas wyrażenia Timex na podstawie bieżącej godziny i opcjonalnie określonej strefy czasowej.

Funkcje Timex

Function	Wyjaśnienie
isPresent	Zwraca wartość true, jeśli wyrażenie TimexProperty lub Timex odwołuje się do obecnej.
isDuration	Zwraca wartość true, jeśli wyrażenie TimexProperty lub Timex odnosi się do czasu trwania.
isTime	Zwraca wartość true, jeśli wyrażenie TimexProperty lub Timex odwołuje się do godziny.
isDate	Zwraca wartość true, jeśli wyrażenie TimexProperty lub Timex odwołuje się do daty.
isTimeRange	Zwraca wartość true, jeśli wyrażenie TimexProperty lub Timex odwołuje się do zakresu czasu.
isDateRange	Zwraca wartość true, jeśli wyrażenie TimexProperty lub Timex odwołuje się do zakresu dat.
isDefinite	Zwraca wartość true, jeśli wyrażenie TimexProperty lub Timex odnosi się do określonego dnia.
rozwiązać	Zwraca ciąg danego wyrażenia TimexProperty lub Timex, jeśli odwołuje się do prawidłowego czasu. Prawidłowy czas zawiera godziny, minuty i sekundy.

Funkcje analizowania URI

Function	Wyjaśnienie
uriHost	Zwraca wartość hosta identyfikatora URI (Uniform Resource Identifier).
uriPath	Zwraca wartość ścieżki jednolitego identyfikatora zasobu (URI).
uriPathAndQuery	Zwróć ścieżkę i wartości zapytania dla identyfikatora URI (Uniform Resource Identifier).
uriPort	Zwraca wartość portu identyfikatora URI (Uniform Resource Identifier).
uriQuery	Zmień wartość zapytania identyfikatora URI (uniform resource identifier).
uriScheme	Zwraca wartość schematu identyfikatora URI (Uniform Resource Identifier).

Manipulowanie obiektami i funkcje konstrukcyjne

Function	Wyjaśnienie
addProperty	Dodaj właściwość i jej wartość lub parę name-value do obiektu JSON i zwróć zaktualizowany obiekt.
removeProperty	Usuń właściwość z obiektu JSON i zwróć zaktualizowany obiekt.
setProperty	Ustaw wartość właściwości obiektu JSON i zwróć zaktualizowany obiekt.
getProperty	Zwraca wartość określonej właściwości lub właściwości głównej z obiektu JSON.
Łączonej	Zwraca pierwszą wartość inną niż null z co najmniej jednego parametru.
xPath	Sprawdź kod XML dla węzłów lub wartości, które są zgodne z wyrażeniem XPath (XML Path Language) i zwraca pasujące węzły lub wartości.
jPath	Sprawdź kod JSON lub ciąg JSON dla węzłów lub wartości, które pasują do wyrażenia ścieżki, i zwróć pasujące węzły.
setPathToValue	Ustaw wartość określonej ścieżki i zwróć wartość.

Funkcje wyrażeń regularnych

Function	Wyjaśnienie
isMatch	Zwraca wartość true, jeśli ciąg pasuje do wspólnego wzorca wyrażeń regularnych.

Funkcje kontroli typów

Function	Wyjaśnienie
EOL	Zwróć tekst sekwencji końca wiersza (EOL).
isInteger	Zwraca wartość true, jeśli podane dane wejściowe są liczbą całkowitą
isFloat	Zwraca wartość true, jeśli dane wejściowe są liczbą punktów zmiennoprzecinkowych
isBoolean	Zwraca wartość true, jeśli dane wejściowe są wartością logiczną.
isArray	Zwraca wartość true, jeśli dane wejściowe są tablicą.
isObject	Zwraca wartość true, jeśli dane wejściowe są obiektem.
isDateTime	Zwraca wartość true, jeśli podane dane wejściowe są sygnaturą czasową formatu ISO UTC.
isString	Zwraca wartość true , jeśli dane wejściowe są ciągiem.

Wstępnie utworzone funkcje sortowane alfabetycznie

Abs

Zwraca wartość bezwzględną określonej liczby.

abs(<number>)

Parametr	Wymagania	Type	Opis
<numer>	Tak	Liczba	Liczba, która ma uzyskać wartość bezwzględną

Wartość zwracana	Type	opis
<wynik>	Liczba	Wynik przetwarzania wartości bezwzględnej.

Przykłady

Te przykłady obliczają wartość bezwzględną:

abs(3.12134)
abs(-3.12134)

I oba zwracają wynik 3.12134.

add

Zwróć wynik z dodania co najmniej dwóch liczb (czysty przypadek liczbowy) lub łączenia co najmniej dwóch ciągów (w innym przypadku).

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

Parametr	Wymagania	Type	Opis
<item1>, <item2>,...	Tak	dowolny	elementy

Wartość zwracana	Type	Opis
<wynik-suma>	liczba lub ciąg	Wynik z dodawania określonych liczb lub wyniku concat.

Przykład

W tym przykładzie dodano określone liczby:

add(1, 1.5)

Zwraca wynik 2,5.

Ten przykład łączy określone elementy:

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

Zwraca wyniki

• Witam
• helloworld

addDays

Dodaj liczbę dni do znacznika czasu w opcjonalnym formacie ustawień regionalnych.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu, który musi być standardowym formatem ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ
<Dni>	Tak	integer	Dodatnia lub ujemna liczba dni do dodania
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<sygnatura czasowa aktualizacji>	string	Znacznik czasu plus określona liczba dni

Przykład 1

W tym przykładzie dodano 10 dni do określonego znacznika czasu:

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

Zwraca wynik 2018-03-25T00:00:00.000Z.

Przykład 2

W tym przykładzie odejmuje pięć dni od określonego znacznika czasu:

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

Zwraca wynik 2018-03-10T00:00:00.000Z.

Przykład 3

W tym przykładzie dodano 1 dzień do określonego znacznika czasu w ustawieniach regionalnych de-DE :

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

Zwraca wynik 16.03.18 13:00:00.

addHours

Dodaj liczbę godzin do znacznika czasu w opcjonalnym formacie ustawień regionalnych.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu
<hours>	Tak	integer	Dodatnia lub ujemna liczba godzin do dodania
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<sygnatura czasowa aktualizacji>	string	Znacznik czasu plus określona liczba godzin

Przykład 1

W tym przykładzie dodano 10 godzin do określonego znacznika czasu:

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

Zwraca wynik 2018-03-15T10:00:00.000Z.

Przykład 2

W tym przykładzie odejmuje pięć godzin od określonego znacznika czasu:

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

Zwraca wynik 2018-03-15T10:00:00.000Z.

Przykład 3

W tym przykładzie dodano 2 godziny do określonego znacznika czasu w ustawieniach regionalnych de-DE :

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

Zwraca wynik 15.03.18 15:00:00.

addMinutes

Dodaj liczbę minut do znacznika czasu w opcjonalnym formacie ustawień regionalnych.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu
<minutes>	Tak	integer	Dodatnia lub ujemna liczba minut do dodania
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<sygnatura czasowa aktualizacji>	string	Znacznik czasu plus określona liczba minut

Przykład 1

W tym przykładzie dodano 10 minut do określonego znacznika czasu:

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

Zwraca wynik 2018-03-15T00:20:00.000Z.

Przykład 2

W tym przykładzie odejmuje pięć minut od określonego znacznika czasu:

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

Zwraca wynik 2018-03-15T00:15:00.000Z.

Przykład 3

W tym przykładzie dodano 30 minut do określonego znacznika czasu w ustawieniach regionalnych de-DE :

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

Zwraca wynik 15.03.18 13:30:00.

addOrdinal

Zwraca liczbę porządkową numeru wejściowego.

addOrdinal(<number>)

Parametr	Wymagania	Type	Opis
<numer>	Tak	integer	Liczby do konwersji na liczbę porządkową

Wartość zwracana	Type	opis
<wynik>	string	Liczba porządkowa przekonwertowana z numeru wejściowego

Przykład

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

I zwraca odpowiednio następujące wyniki:

• 11.
• 12.
• 13.
• 21.
• 22.
• 23.

addProperty

Dodaj właściwość i jej wartość lub parę name-value do obiektu JSON i zwróć zaktualizowany obiekt. Jeśli obiekt już istnieje w czasie wykonywania, funkcja zgłasza błąd.

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

Parametr	Wymagania	Type	Opis
<object>	Tak	obiekt	Obiekt JSON, w którym chcesz dodać właściwość
<właściwość>	Tak	string	Nazwa właściwości do dodania
<wartość>	Tak	dowolny	Wartość właściwości

Wartość zwracana	Type	Opis
<zaktualizowany obiekt>	obiekt	Zaktualizowany obiekt JSON po dodaniu nowej właściwości

Przykład

W tym przykładzie dodano właściwość accountNumber do obiektu customerProfile, który jest konwertowany na kod JSON za pomocą funkcji json(). Funkcja przypisuje wartość wygenerowaną przez funkcję newGuid() i zwraca zaktualizowany obiekt:

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

addSeconds

Dodaj liczbę sekund do znacznika czasu.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu
<Sekund>	Tak	integer	Dodatnia lub ujemna liczba sekund do dodania
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.

Wartość zwracana	Type	Opis
<sygnatura czasowa aktualizacji>	string	Sygnatura czasowa plus określona liczba sekund

Przykład 1

W tym przykładzie dodano 10 sekund do określonego znacznika czasu:

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

Zwraca wynik 2018-03-15T00:00:10.000Z.

Przykład 2

W tym przykładzie odejmuje pięć sekund do określonego znacznika czasu:

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

Zwraca wynik 2018-03-15T00:00:25.000Z.

addToTime

Dodaj liczbę jednostek czasu do znacznika czasu w opcjonalnym formacie ustawień regionalnych. Zobacz również getFutureTime().

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu
<interval>	Tak	integer	Liczba określonych jednostek czasu do dodania
<timeUnit>	Tak	string	Jednostka czasu do użycia z interwałem. Możliwe jednostki to "Second", "Minute", "Hour", "Day", "Week", "Month" i "Year".
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<sygnatura czasowa aktualizacji>	string	Sygnatura czasowa plus liczba określonych jednostek czasu z danym formatem.

Przykład 1

Ten przykład dodaje jeden dzień do określonego znacznika czasu.

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

Zwraca wynik 2018-01-02T00:00:00.000Z.

Przykład 2

W tym przykładzie dodano dwa tygodnie do określonego znacznika czasu.

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

Zwraca wynik w formacie "MM-DD-RR" jako 01-15-18.

wszystkie

Ustal, czy wszystkie elementy sekwencji spełniają warunek.

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

Parametr	Wymagania	Type	Opis
<kolejność>	Tak	obiekt	Sekwencja do oceny.
<przedmiot>	Tak	string	Odwołuje się do elementów do oceny w sekwencji.
<warunek>	Tak	wyrażenie	Wyrażenie do oceny warunku.

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwróć, true jeśli wszystkie elementy spełniają warunek. Zwróć wartość false , jeśli co najmniej jedna nie.

Przykłady

Te przykłady określają, czy wszystkie elementy sekwencji spełniają warunek:

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

I zwróć odpowiednio następujące wyniki:

• false, ponieważ oba elementy w sekwencji nie są liczbami całkowitymi.
• true, ponieważ oba elementy w sekwencji są liczbami całkowitymi.

oraz

Sprawdź, czy wszystkie wyrażenia są prawdziwe. Zwróć, true jeśli wszystkie wyrażenia mają wartość true, lub zwróć false , jeśli co najmniej jedno wyrażenie ma wartość false.

and(<expression1>, <expression2>, ...)

Parametr	Wymagania	Type	Opis
<expression1>, <expression2>, ...	Tak	Wartość logiczna	Wyrażenia do sprawdzenia

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwracaj true , jeśli wszystkie wyrażenia mają wartość true. Zwracaj, false jeśli co najmniej jedno wyrażenie ma wartość false.

Przykład 1

Te przykłady sprawdzają, czy określone wartości logiczne są prawdziwe:

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

I zwraca odpowiednio następujące wyniki:

• Oba wyrażenia są prawdziwe, więc funkcje zwracają wartość true.
• Jedno wyrażenie jest fałszywe, więc funkcje zwracają wartość false.
• Oba wyrażenia są fałszywe, więc funkcja zwraca falsewartość .

Przykład 2

Te przykłady sprawdzają, czy określone wyrażenia są prawdziwe:

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

I zwraca odpowiednio następujące wyniki:

• Oba wyrażenia są prawdziwe, więc funkcje zwracają wartość true.
• Jedno wyrażenie jest fałszywe, więc funkcje zwracają wartość false.
• Oba wyrażenia są fałszywe, więc funkcje zwracają wartość false.

dowolny

Ustal, czy dowolne elementy sekwencji spełniają warunek.

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

Parametr	Wymagania	Type	Opis
<kolejność>	Tak	obiekt	Sekwencja do oceny.
<przedmiot>	Tak	string	Odwołuje się do elementów do oceny w sekwencji.
<warunek>	Tak	wyrażenie	Wyrażenie do oceny warunku.

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwróć, true jeśli wszystkie elementy spełniają warunek. Zwróć wartość false , jeśli co najmniej jedna nie.

Przykłady

Te przykłady określają, czy wszystkie elementy sekwencji spełniają warunek:

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

I zwróć odpowiednio następujące wyniki:

• true, ponieważ co najmniej jeden element w sekwencji jest liczbą całkowitą
• false, ponieważ żaden element w sekwencji nie jest liczbą całkowitą.

średnia

Zwraca średnią liczbową tablicy liczbowej.

average(<numericArray>)

Parametr	Wymagania	Type	Opis
<numericArray>	Tak	tablica liczb	Tablica wejściowa do obliczenia średniej

Wartość zwracana	Type	Opis
<average-of-array>	Liczba	Średnia wartość danej tablicy

Przykład

W tym przykładzie obliczana jest średnia tablicy w pliku createArray():

average(createArray(1,2,3))

Zwraca wynik 2.

base64

Zwróć zakodowaną w formacie base64 wersję ciągu lub tablicy bajtów.

base64('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	ciąg lub tablica bajtów	Ciąg wejściowy

Wartość zwracana	Type	Opis
<ciąg base64>	string	Zakodowana w formacie base64 wersja ciągu wejściowego

Przykład 1

W tym przykładzie ciąg jest konwertowany na ciąg zakodowany w formacie base64:

base64('hello')

Zwraca wynik "aGVsbG8=".

Przykład 2

W tym przykładzie przyjmuje wartość byteArr, która jest new byte[] { 3, 5, 1, 12 }równa :

base64('byteArr')

Zwraca wynik "AwUBDA==".

base64ToBinary

Zwróć tablicę binarną ciągu zakodowanego w formacie base64.

base64ToBinary('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	string	Ciąg zakodowany w formacie base64 do konwersji

Wartość zwracana	Type	Opis
<binary-for-base64-string>	tablica bajtów	Wersja binarna ciągu zakodowanego w formacie base64

Przykład

W tym przykładzie ciąg zakodowany w formacie base64 awUBDA== jest konwertowany na ciąg binarny:

base64ToBinary('AwUBDA==')

Zwraca wynik nowy bajt[] { 3, 5, 1, 12 }.

base64ToString

Zwraca wersję ciągu zakodowanego w formacie base64, co skutecznie dekoduje ciąg base64.

base64ToString('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	string	Ciąg zakodowany w formacie base64 do dekodowania

Wartość zwracana	Type	Opis
<dekodowany-base64-string>	string	Wersja ciągu zakodowanego w formacie base64

Przykład

Ten przykład konwertuje ciąg zakodowany w formacie base64 aGVsbG8= na zdekodowany ciąg:

base64ToString('aGVsbG8=')

I zwraca wynik hello.

dane binarne

Zwraca wersję binarną ciągu.

binary('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	string	Ciąg do konwersji

Wartość zwracana	Type	Opis
<binary-for-input-value>	tablica bajtów	Wersja binarna określonego ciągu

Przykład

W tym przykładzie ciąg jest konwertowany na ciąg binarny:

binary('hello')

Zwraca wynik nowy bajt[] { 104, 101, 108, 108, 108, 111 }.

bool

Zwróć wersję logiczną wartości.

bool(<value>)

Parametr	Wymagania	Type	Opis
<wartość>	Tak	dowolny	Wartość do konwersji

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Wersja logiczna określonej wartości

Przykład

Te przykłady konwertują określone wartości na wartości logiczne:

bool(1)
bool(0)

I zwraca odpowiednio następujące wyniki:

• true
• false

sufit

Zwraca największą wartość całkowitą mniejszą lub równą określonej liczbie.

ceiling('<number>')

Parametr	Wymagania	Type	Opis
<numer>	Tak	Liczba	Numer wejściowy

Wartość zwracana	Type	Opis
<liczba całkowita — wartość>	integer	Największa wartość całkowita większa lub równa liczbie wejściowej

Przykład

Ten przykład zwraca największą wartość całkowitą mniejszą lub równą liczbie 10,333:

ceiling(10.333)

Zwraca liczbę całkowitą 11.

Łączonej

Zwraca pierwszą wartość inną niż null z co najmniej jednego parametru. Puste ciągi, puste tablice i puste obiekty nie mają wartości null.

coalesce(<object**1>, <object**2>, ...)

Parametr	Wymagania	Type	Opis
<object**1>, <object**2>, ...	Tak	dowolne (dopuszczalne typy mieszane)	Co najmniej jeden element do sprawdzenia pod kątem wartości null

Wartość zwracana	Type	Opis
<pierwszy element o wartości innej niż null>	dowolny	Pierwszy element lub wartość, która nie ma wartości null. Jeśli wszystkie parametry mają wartość null, ta funkcja zwraca wartość null.

Przykład

Te przykłady zwracają pierwszą wartość inną niż null z określonych wartości lub null, gdy wszystkie wartości mają wartość null:

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

I odpowiednio zwracają:

• true
• Witam
• null

concat

Połącz co najmniej dwa obiekty i zwróć połączone obiekty na liście lub w ciągu.

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

Parametr	Wymagania	Type	Opis
<object1>, <object2>, ...	Tak	dowolny	Co najmniej dwa obiekty do łączenia.

Wartość zwracana	Type	Opis
<object1object2...>	ciąg lub lista	Połączony ciąg lub lista. Wartości null są pomijane.

Oczekiwane wartości zwracane:

• Jeśli wszystkie elementy są listami, zostanie zwrócona lista.
• Jeśli istnieje element, który nie jest listą, zostanie zwrócony ciąg.
• Jeśli wartość ma wartość null, zostanie pominięta i nie zostanie połączona.

Przykład

Ten przykład łączy ciągi Hello i World:

concat('Hello', 'World')

Zwraca wynik HelloWorld.

Przykład 2

Ten przykład łączy listy [1,2] i [3,4]:

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

I zwraca wynik [1,2,3,4].

Przykład 3

Te przykłady łączą obiekty różnych typów:

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

I zwróć odpowiednio następujące wyniki:

• Ciąg ab12.
• Obiekt aSystem.Collections.Generic.List 1[System.Object]. Jest to nieczytelne i najlepiej unikać.

Przykład 4

Te przykłady łączą obiekty:null

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

I zwróć odpowiednio następujące wyniki:

• Lista [1,2].
• Ciąg a1.

zawiera

Sprawdź, czy kolekcja ma określony element. Zwróć wartość true , jeśli element zostanie znaleziony, lub wróć false , jeśli nie zostanie znaleziony. Ta funkcja uwzględnia wielkość liter.

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

Ta funkcja działa na następujących typach kolekcji:

• Ciąg do znalezienia podciągów
• Tablica do znalezienia wartości
• Słownik do znalezienia klucza

Parametr	Wymagania	Type	Opis
<kolekcja>	Tak	ciąg, tablica lub słownik	Kolekcja do sprawdzenia
<wartość>	Tak	ciąg, tablica lub słownik, odpowiednio	Element do znalezienia

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Wróć true , jeśli element zostanie znaleziony. Zwróć wartość false , jeśli nie zostanie znaleziona.

Przykład 1

W tym przykładzie sprawdzamy świecie hello ciągu dla świata podciągów:

contains('hello world', 'world')

Zwraca wynik true.

Przykład 2

W tym przykładzie sprawdzamy świecie hello ciągu dla wszechświata podciągów:

contains('hello world', 'universe')

Zwraca wynik false.

count

Zwróć liczbę elementów w kolekcji.

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

Parametr	Wymagania	Type	Opis
<kolekcja>	Tak	ciąg lub tablica	Kolekcja z elementami do zliczenia

Wartość zwracana	Type	Opis
<długość lub liczba>	integer	Liczba elementów w kolekcji

Przykłady:

Te przykłady zliczają liczbę elementów w tych kolekcjach:

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

I oba zwracają wynik 4.

countWord

Zwracanie liczby wyrazów w ciągu

countWord('<text>')

Parametr	Wymagania	Type	Opis
<text>	Tak	string	Ciąg do zliczenia

Wartość zwracana	Type	Opis
<count>	integer	Liczba wyrazów w ciągu

Przykład

W tym przykładzie zliczamy liczbę wyrazów w świecie hello ciągu:

countWord("hello word")

I zwraca wynik 2.

convertFromUTC

Przekonwertuj znacznik czasu w opcjonalnym formacie ustawień regionalnych z uniwersalnego czasu koordynowanego (UTC) na docelową strefę czasową.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu
<destinationTimeZone>	Tak	string	Nazwa docelowej strefy czasowej. Obsługuje strefy czasowe systemu Windows i IANA.
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format "o", rrrr-MM-ddTHH:mm:ss.fffffffK, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<przekonwertowana sygnatura czasowa>	string	Sygnatura czasowa przekonwertowana na docelową strefę czasową

Przykłady:

Te przykłady umożliwiają konwersję z czasu UTC na pacyficzny (czas standardowy):

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

I zwróć odpowiednio następujące wyniki:

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

Przykład 2

Ten przykład konwertuje znacznik czasu w ustawieniach regionalnych en-US z UTC na Pacyficzny Standardowy czas:

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

Zwraca wynik poniedziałek, 1 stycznia 2018 r.

convertToUTC

Przekonwertuj znacznik czasu w opcjonalnym formacie ustawień regionalnych na uniwersalny czas koordynowany (UTC) ze źródłowej strefy czasowej.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu
<sourceTimeZone>	Tak	string	Nazwa docelowej strefy czasowej. Obsługuje strefy czasowe systemu Windows i IANA.
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<przekonwertowana sygnatura czasowa>	string	Sygnatura czasowa przekonwertowana na docelową strefę czasową

Przykład

W tym przykładzie sygnatura czasowa jest konwertowana na czas UTC z czasu pacyficznego (czas standardowy)

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

Zwraca wynik 2018-01-01T08:00:00.000Z.

Przykład 2

Ten przykład konwertuje znacznik czasu w ustawieniach regionalnych de-DE na UTC z czasu pacyficznego (czas standardowy):

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

Zwraca wynik 01.01.18 08:00:00.

createArray

Zwraca tablicę z wielu danych wejściowych.

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

Parametr	Wymagania	Type	Opis
<object1>, <object2>, ...	Tak	dowolny, ale nie mieszany	Co najmniej dwa elementy do utworzenia tablicy

Wartość zwracana	Type	Opis
[<object1>, <object2>, ...]	tablica	Tablica utworzona na podstawie wszystkich elementów wejściowych

Przykład

W tym przykładzie zostanie utworzona tablica z następujących danych wejściowych:

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

Zwraca wynik [h ,e, l, l, o].

dataUri

Zwracanie identyfikatora URI (URI) danych ciągu.

dataUri('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	string	Ciąg do konwersji

Wartość zwracana	Type	Opis
[<date-uri>]	string	Identyfikator URI danych dla ciągu wejściowego

Przykład

dataUri('hello')

Zwraca dane wynikowe :text/plain; charset=utf-8; base64,aGVsbG8=.

dataUriToBinary

Zwraca wersję binarną identyfikatora URI (Data Uniform Resource Identifier).

dataUriToBinary('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	string	Identyfikator URI danych do konwersji

Wartość zwracana	Type	Opis
[<binary-for-data-uri>]	tablica bajtów	Wersja binarna identyfikatora URI danych

Przykład

W tym przykładzie zostanie utworzona wersja binarna dla następującego identyfikatora URI danych:

dataUriToBinary('aGVsbG8=')

Zwraca wynik nowy bajt[] { 97, 71, 86, 115, 98, 71, 56, 61 }.

dataUriToString

Zwraca wersję ciągu identyfikatora URI (URI).

dataUriToString('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	string	Identyfikator URI danych do konwersji

Wartość zwracana	Type	Opis
[<string-for-data-uri>]	string	Wersja ciągu identyfikatora URI danych

Przykład

W tym przykładzie zostanie utworzony ciąg z następującego identyfikatora URI danych:

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

I zwraca wynik hello.

data

Zwraca datę określonego znacznika czasu w formacie m/dd/rrrr .

date('<timestramp>')

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu

Wartość zwracana	Type	Opis
<data>	string	Data określonego znacznika czasu

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

Zwraca wynik 3-15-2018.

dateReadBack

Używa biblioteki daty i godziny, aby zapewnić odczyt zwrotny daty.

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

Parametr	Wymagania	Type	Opis
<currentDate>	Tak	string	Ciąg zawierający bieżącą datę
<targetDate>	Tak	string	Ciąg zawierający datę docelową

Wartość zwracana	Type	Opis
<date-readback>	string	Odczyt zwrotny między bieżącą datą a datą docelową

Przykład 1

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

Zwraca wynik jutro.

dateTimeDiff

Zwróć różnicę w znacznikach czasu między dwoma znacznikami czasu.

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

Parametr	Wymagania	Type	Opis
<sygnatura czasowa1>	Tak	string	Pierwszy ciąg znacznika czasu do porównania
<sygnatura czasowa 2>	Tak	string	Drugi ciąg znacznika czasu do porównania

Wartość zwracana	Type	Opis
<Kleszcze>	Liczba	Różnica w znacznikach czasu między dwoma znacznikami czasu

Przykład 1

Ten przykład zwraca różnicę w znacznikach czasu między dwoma znacznikami czasu:

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

Zwraca liczbę 3153600000000000000.

Przykład 2

Ten przykład zwraca różnicę w znacznikach czasu między dwoma znacznikami czasu:

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

Zwraca wynik -315360000000000000. Wartość jest liczbą ujemną.

dayOfMonth

Zwróć dzień miesiąca z znacznika czasu.

dayOfMonth('<timestamp>')

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu

Wartość zwracana	Type	Opis
<dzień miesiąca>	integer	Dzień miesiąca z określonego znacznika czasu

Przykład

Ten przykład zwraca liczbę dla dnia miesiąca z następującego znacznika czasu:

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

I zwraca wynik 15.

dayOfWeek

Zwróć dzień tygodnia z znacznika czasu.

dayOfWeek('<timestamp>')

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu

Wartość zwracana	Type	Opis
<dzień tygodnia>	integer	Dzień tygodnia od określonego znacznika czasu. Niedziela jest 0, poniedziałek jest 1, i tak dalej.

Przykład

Ten przykład zwraca liczbę dla dnia tygodnia z następującego znacznika czasu:

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

I zwraca wynik 3.

dayOfYear

Zwraca dzień roku ze znacznika czasu.

dayOfYear('<timestamp>')

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu

Wartość zwracana	Type	Opis
<dzień roku>	integer	Dzień roku z określonego znacznika czasu

Przykład

Ten przykład zwraca liczbę dni roku z następującego znacznika czasu:

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

I zwraca wynik 74.

div

Zwróć wynik liczby całkowitej z dzielenia dwóch liczb. Aby zwrócić resztę, zobacz mod().

div(<dividend>, <divisor>)

Parametr	Wymagania	Type	Opis
<dywidenda>	Tak	Liczba	Liczba do podzielenia przez dzielnik
<dzielnik>	Tak	Liczba	Liczba dzieląca dywidendę. Nie można mieć 0.

Wartość zwracana	Type	Opis
<quotient-result>	Liczba	Wynik dzielenia pierwszej liczby przez drugą liczbę

Przykład

Oba przykłady dzielą pierwszą liczbę przez drugą liczbę:

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

I zwróć wynik 2.

Istnieje pewna luka między językiem JavaScript i zestawem .NET SDK. Na przykład następujące wyrażenie zwróci różne wyniki w językach Javascript i .NET SDK:

Jeśli jeden z parametrów jest zmiennoprzecinkowym, wynik będzie również zmiennoprzecinkowy z zestawem SDK platformy .NET.

Przykład

div(11.2, 2)

Zwraca wynik 5,6.

Jeśli jeden z parametrów jest zmiennoprzecinkowym, wynikiem będzie INT z zestawem JAVAscript SDK.

Przykład

div(11.2, 2)

Zwraca wynik 5.

Obejściem dla języka Javascript, aby zachować pewną liczbę miejsc dziesiętnych w wynikach, jest użycie takiego wyrażenia. Aby na przykład zachować 3 miejsca dziesiętne:

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

empty

Sprawdź, czy wystąpienie jest puste. Zwróć, true jeśli dane wejściowe są puste. Puste oznacza:

• dane wejściowe mają wartość null lub niezdefiniowane
• input jest ciągiem o wartości null lub pustym
• dane wejściowe to kolekcja o zerowym rozmiarze
• input jest obiektem bez właściwości.

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

Parametr	Wymagania	Type	Opis
<instancja>	Tak	dowolny	Wystąpienie do sprawdzenia

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwracany true , gdy wystąpienie jest puste.

Przykład

Te przykłady sprawdzają, czy określone wystąpienie jest puste:

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

I zwróć te wyniki odpowiednio:

• Przekazuje pusty ciąg, więc funkcja zwraca wartość true.
• Przekazuje ciąg abc, więc funkcja zwraca wartość false.
• Przekazuje kolekcję z jednym elementem, więc funkcja zwraca wartość false.
• Przekazuje obiekt o wartości null, więc funkcja zwraca truewartość .

endsWith

Sprawdź, czy ciąg kończy się określonym podciągem. Zwróć, true jeśli podciąg zostanie znaleziony, lub zwróć false wartość , jeśli nie zostanie znaleziona. Ta funkcja nie uwzględnia wielkości liter.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	string	Ciąg do sprawdzenia
<tekst wyszukiwania>	Tak	string	Kończenie podciągów do znalezienia

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwracany true po znalezieniu końcowego podciągu. Zwracanie false , jeśli nie znaleziono

Przykład 1

W tym przykładzie sprawdza się, czy ciąg hello world kończy się światem ciągów:

endsWith('hello world', 'world')

Zwraca wynik true.

Przykład 2

W tym przykładzie sprawdza się, czy ciąg hello world kończy się uniwersum ciągu:

endsWith('hello world', 'universe')

Zwraca wynik false.

EOL

Zwróć tekst sekwencji końca wiersza (EOL).

EOL()

Wartość zwracana	Type	Opis
<IsOSPlatform>	string	Zwróć \r\n w systemach Windows i \n w systemach Mac i Linux.

Przykład

W tym przykładzie sprawdza się koniec tekstu sekwencji wierszy:

EOL()

I zwraca następujące ciągi:

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

equals

Sprawdź, czy obie wartości, wyrażenia lub obiekty są równoważne. Zwróć wartość true , jeśli obie są równoważne, lub zwracają false , jeśli nie są równoważne.

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

Parametr	Wymagania	Type	Opis
<object1>, <object2>	Tak	dowolny	Wartości, wyrażenia lub obiekty do porównania

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwracaj true , gdy oba są równoważne. Zwróć wartość false , jeśli nie jest równoważna.

Przykład

Te przykłady sprawdzają, czy określone dane wejściowe są równoważne:

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

I zwraca odpowiednio następujące wyniki:

• Obie wartości są równoważne, więc funkcja zwraca truewartość .
• Obie wartości nie są równoważne, więc funkcja zwraca falsewartość .

istnieje

Ocenia wyrażenie pod kątem prawdy.

exists(expression)

Parametr	Wymagania	Type	Opis
wyrażenie	Tak	wyrażenie	Wyrażenie do oceny prawdy

Wartość zwracana	Type	Opis
<prawda lub fałsz>	Wartość logiczna	Wynik oceny wyrażenia

Przykład

W tym przykładzie przedstawiono ocenę prawdziwości elementu foo = {"bar":"value"}:

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

I zwróć te wyniki odpowiednio:

• true
• false

exp

Zwraca wykładnik jednej liczby do innej.

exp(realNumber, exponentNumber)

Parametr	Wymagania	Type	Opis
realNumber	Tak	Liczba	Liczba rzeczywista do obliczenia wykładnika
exponentNumber	Tak	Liczba	Liczba wykładnicza

Wartość zwracana	Type	Opis
<wyrażenie-wynik>	Liczba	Wynik przetwarzania wykładnika realNumber

Przykład

W tym przykładzie obliczany jest wykładnik:

exp(2, 2)

I zwraca wynik 4.

pierwszy

Zwraca pierwszy element z ciągu lub tablicy.

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

Parametr	Wymagania	Type	Opis
<kolekcja>	Tak	ciąg lub tablica	Kolekcja, w której należy znaleźć pierwszy element

Wartość zwracana	Type	Opis
<first-collection-item>	dowolny	Pierwszy element w kolekcji

Przykład

Te przykłady zawierają pierwszy element w następujących kolekcjach:

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

I zwróć te wyniki odpowiednio:

• h
• 0

spłaszczyć

Spłaszczanie tablicy do wartości innych niż tablica. Opcjonalnie można ustawić maksymalną głębokość na spłaszczoną.

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

Parametr	Wymagania	Type	Opis
<kolekcja>	Tak	tablica	Kolekcja do spłaszczania
<głębokość>	Nie.	Liczba	Maksymalna głębokość do spłaszczania. Wartość domyślna to nieskończoność.

Wartość zwracana	Type	Opis
<nowa kolekcja>	tablica	Nowa kolekcja, której elementy zostały spłaszczone do tablicy innej niż określona głębokość

Przykład 1

Przykład THis spłaszcza następującą tablicę:

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

Zwraca wynik [1, 2, 3, 4, 5, 6].

Przykład 2

W tym przykładzie spłaszcza tablicę do głębokości 1:

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

Zwraca wynik [1, 2, [3, 4], [5, 6]].

liczba zmiennoprzecinkowa

Przekonwertuj wersję ciągu numeru zmiennoprzecinkowego na liczbę zmiennoprzecinkową. Tej funkcji można używać tylko podczas przekazywania parametrów niestandardowych do aplikacji, takiej jak aplikacja logiki. Wyjątek zostanie zgłoszony, jeśli nie można przekonwertować ciągu na zmiennoprzecinkowy.

float('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	string	Ciąg, który ma prawidłową liczbę zmiennoprzecinkową do konwersji na

Wartość zwracana	Type	Opis
<wartość zmiennoprzecinkowa>	liczba zmiennoprzecinkowa	Liczba zmiennoprzecinkowa określonego ciągu

Przykład

W tym przykładzie jest konwertowana wersja zmiennoprzecinkowa ciągu:

float('10.333')

Zwraca zmiennoprzecinkowy 10,333.

floor

Zwraca największą wartość całkowitą mniejszą lub równą określonej liczbie.

floor('<number>')

Parametr	Wymagania	Type	Opis
<numer>	Tak	Liczba	Numer wejściowy

Wartość zwracana	Type	Opis
<liczba całkowita — wartość>	integer	Największa wartość całkowita mniejsza lub równa liczbie wejściowej

Przykład

W tym przykładzie obliczana jest wartość podłogi liczby 10,333:

floor(10.333)

Zwraca liczbę całkowitą 10.

foreach

Operuj na każdym elemecie i zwracaj nową kolekcję.

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

Parametr	Wymagania	Type	Opis
<kolekcja/wystąpienie>	Tak	tablica lub obiekt	Kolekcja z elementami
<iteratorName>	Tak	nazwa iteratora	Kluczowy element funkcji strzałki
<funkcja>	Tak	wyrażenie	Funkcja zawierająca iteratorName

Wartość zwracana	Type	Opis
<nowa kolekcja>	tablica	Nowa kolekcja, w której każdy element został oceniony przez funkcję

Przykład 1

W tym przykładzie jest generowana nowa kolekcja:

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

Zwraca wynik [1, 2, 3, 4].

Przykład 2

Te przykłady generują nową kolekcję:

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

I zwróć wynik ['name:jack', 'age:15']. Zwróć uwagę, że drugie wyrażenie jest wyrażeniem lambda, które jest bardziej czytelne.

formatDateTime

Zwraca znacznik czasu w opcjonalnym formacie ustawień regionalnych.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<ponownie sformatowany znacznik czasu>	string	Zaktualizowany znacznik czasu w określonym formacie

Przykład 1

W tym przykładzie znacznik czasu jest konwertowany na określony format:

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

Zwraca wynik 2018-03-15T12:00:00.

Przykład 2

Ten przykład konwertuje znacznik czasu w ustawieniach regionalnych de-DE :

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

Zwraca wynik 15.03.18 00:00:00.

formatEpoch

Zwraca znacznik czasu w opcjonalnym formacie ustawień regionalnych w określonym formacie z czasu systemu UNIX (znany również jako czas epoki, czas POSIX, czas SYSTEMU UNIX).

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

Parametr	Wymagania	Type	Opis
<epoka>	Tak	Liczba	Numer epoki
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<ponownie sformatowany znacznik czasu>	string	Zaktualizowany znacznik czasu w określonym formacie

Przykład

W tym przykładzie sygnatura czasowa systemu Unix jest konwertowana na określony format:

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

Zwraca wynik 2018-03-15T12:00:00.000Z.

Przykład

W tym przykładzie sygnatura czasowa systemu Unix jest konwertowana na ustawienia regionalne de-DE :

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

Zwraca wynik 15.03.18 13:00:00.

formatNumber

Sformatuj wartość na określoną liczbę cyfr ułamkowych i opcjonalne określone ustawienia regionalne.

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

Parametr	Wymagania	Type	Opis
<numer>	Tak	Liczba	Numer wejściowy
<cyfry precyzji>	Tak	integer	Określona liczba cyfr ułamkowych
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<return-value>	Liczba	Wartość zwracana danych wejściowych sformatowanych w określonej liczbie cyfr ułamkowych i określonych ustawień regionalnych

Przykład 1

Ten przykład formatuje liczbę od 10,333 do 2 cyfr ułamkowych:

formatNumber(10.333, 2)

I zwraca ciąg 10.33.

Przykład 2

Te przykłady formatują liczby na określoną liczbę cyfr w ustawieniach regionalnych en-US :

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

I zwróć odpowiednio następujące wyniki:

• 12.12
• 1.55
• 12.1230

formatTicks

Zwraca znacznik czasu w opcjonalnym formacie ustawień regionalnych w określonym formacie z znaczników.

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

Parametr	Wymagania	Type	Opis
<epoka>	Tak	number (lub bigint w języku JavaScript)	Liczba znaczników
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<ponownie sformatowany znacznik czasu>	string	Zaktualizowany znacznik czasu w określonym formacie

Przykład 1

W tym przykładzie znaczniki są konwertowane na określony format:

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

Zwraca wynik 2020-05-06T11:47:00.000Z.

Przykład 2

W tym przykładzie znaczniki są konwertowane na określony format w ustawieniach regionalnych de-DE :

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

Zwraca wynik 06.05.20 11:47:00.

getFutureTime

Zwróć bieżący znacznik czasu w opcjonalnym formacie ustawień regionalnych oraz określoną liczbę jednostek czasu.

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

Parametr	Wymagania	Type	Opis
<interval>	Tak	integer	Liczba określonych jednostek czasu do dodania
<timeUnit>	Tak	string	Jednostka czasu do użycia z interwałem. Możliwe jednostki to "Second", "Minute", "Hour", "Day", "Week", "Month" i "Year".
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<sygnatura czasowa aktualizacji>	string	Bieżący znacznik czasu plus określona liczba jednostek czasu

Przykład 1

Załóżmy, że bieżąca sygnatura czasowa to 2019-03-01T00:00:00.000Z. Poniższy przykład dodaje pięć dni do tego znacznika czasu:

getFutureTime(2, 'Week')

Zwraca wynik 2019-03-15T00:00:00.000Z.

Przykład 2

Załóżmy, że bieżący znacznik czasu to 2018-03-01T00:00:00.000Z. Poniższy przykład dodaje pięć dni do znacznika czasu i konwertuje wynik na format MM-DD-RRRR :

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

Zwraca wynik 03-06-18.

Przykład 3

Załóżmy, że bieżący znacznik czasu to 2020-05-01T00:00:00.000Z , a ustawienia regionalne są de-DE. Poniższy przykład dodaje 1 dzień do znacznika czasu:

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

Zwraca wynik 02.05.20 00:00:00.

getNextViableDate

Zwróć kolejną realną datę wyrażenia Timex na podstawie bieżącej daty i opcjonalnej określonej strefy czasowej.

getNextViableDate(<timexString>, <timezone>?)

Parametr	Wymagania	Type	Opis
<timexString>	Tak	string	Ciąg timex daty do obliczenia.
<strefa czasowa>	Nie.	string	Opcjonalna strefa czasowa.

Wartość zwracana	Type	Opis
<nextViableTime>	string	Następna realna data.

Przykłady

Załóżmy, że data to 2020-06-12 , a bieżąca godzina to 15:42:21.

Te przykłady umożliwiają ocenę ciągu Timex dla następnej możliwej daty na podstawie powyższej daty i godziny:

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

I zwróć odpowiednio następujące ciągi:

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

getNextViableTime

Zwróć następny realny czas wyrażenia Timex na podstawie bieżącej godziny i opcjonalnie określonej strefy czasowej.

getNextViableTime(<timexString>, <timezone>?)

Parametr	Wymagania	Type	Opis
<timexString>	Tak	string	Ciąg timex czasu do obliczenia.
<strefa czasowa>	Nie.	string	Opcjonalna strefa czasowa.

Wartość zwracana	Type	Opis
<nextViableTime>	string	Następny realny czas.

Przykłady

Załóżmy, że data to 2020-06-12 , a bieżąca godzina to 15:42:21.

Te przykłady umożliwiają ocenę ciągu Timex dla następnej opłacalnej godziny na podstawie powyższej daty i godziny:

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

I zwróć odpowiednio następujące ciągi:

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

getPastTime

Zwróć bieżący znacznik czasu minus określoną liczbę jednostek czasu.

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

Parametr	Wymagania	Type	Opis
<interval>	Tak	integer	Liczba określonych jednostek czasu do odejmowania
<timeUnit>	Tak	string	Jednostka czasu do użycia z interwałem. Możliwe jednostki to "Second", "Minute", "Hour", "Day", "Week", "Month" i "Year".
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.

Wartość zwracana	Type	Opis
<sygnatura czasowa aktualizacji>	string	Bieżący znacznik czasu minus określona liczba jednostek czasu

Przykład 1

Załóżmy, że bieżący znacznik czasu to 2018-02-01T00:00:00.000Z. W tym przykładzie odejmuje pięć dni od tego znacznika czasu:

getPastTime(5, 'Day')

Zwraca wynik 2019-01-27T00:00:00.000Z.

Przykład 2

Załóżmy, że bieżący znacznik czasu to 2018-03-01T00:00:00.000Z. W tym przykładzie odejmuje pięć dni do znacznika czasu w formacie MM-DD-RR :

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

Zwraca wynik 02-26-18.

Przykład 3

Załóżmy, że bieżący znacznik czasu to 2020-05-01T00:00:00.000Z , a ustawienia regionalne są de-DE. Poniższy przykład odejmuje 1 dzień od znacznika czasu:

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

Zwraca wynik 31.04.20 00:00:00.

getPreviousViableDate

Zwróć poprzednią realną datę wyrażenia Timex na podstawie bieżącej daty i opcjonalnej określonej strefy czasowej.

getPreviousViableDate(<timexString>, <timezone>?)

Parametr	Wymagania	Type	Opis
<timexString>	Tak	string	Ciąg timex daty do obliczenia.
<strefa czasowa>	Nie.	string	Opcjonalna strefa czasowa.

Wartość zwracana	Type	Opis
<previousViableDate>	string	Poprzednia realna data.

Przykłady

Załóżmy, że data to 2020-06-12 , a bieżąca godzina to 15:42:21.

Te przykłady umożliwiają ocenę ciągu Timex dla poprzedniej możliwej daty na podstawie powyższej daty i godziny:

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

I zwróć odpowiednio następujące ciągi:

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

getPreviousViableTime

Zwróć poprzedni realny czas wyrażenia Timex na podstawie bieżącej daty i opcjonalnie określonej strefy czasowej.

getPreviousViableTime(<timexString>, <timezone>?)

Parametr	Wymagania	Type	Opis
<timexString>	Tak	string	Ciąg timex czasu do obliczenia.
<strefa czasowa>	Nie.	string	Opcjonalna strefa czasowa.

Wartość zwracana	Type	Opis
<previousViableTime>	string	Poprzedni realny czas.

Przykłady

Załóżmy, że data to 2020-06-12 , a bieżąca godzina to 15:42:21.

Te przykłady oceniają ciąg Timex dla poprzedniej realnej godziny na podstawie powyższej daty i godziny:

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

I zwróć odpowiednio następujące ciągi:

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

getProperty

Zwraca wartość określonej właściwości lub właściwości głównej z obiektu JSON.

Zwraca wartość określonej właściwości

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

Parametr	Wymagania	Type	Opis
<JSONObject>	Tak	obiekt	Obiekt JSON zawierający właściwość i wartości.
<propertyName>	Nie.	string	Nazwa właściwości opcjonalnej w celu uzyskania dostępu do wartości z.

Wartość zwracana	Type	Opis
wartość	string	Wartość określonej właściwości w obiekcie JSON.

Przykład

Załóżmy, że masz następujący obiekt JSON:

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

W tym przykładzie pobrano określoną właściwość z powyższego obiektu JSON:

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

I zwróć odpowiednio następujące ciągi:

• a:b wartość
• d klucza

Zwracanie właściwości głównej

getProperty('<propertyName>')

Parametr	Wymagania	Type	Opis
<propertyName>	Tak	string	Nazwa właściwości opcjonalnej, aby uzyskać dostęp do wartości z zakresu pamięci głównej.

Wartość zwracana	Type	Opis
wartość	string	Wartość właściwości głównej w obiekcie JSON.

Przykład

Załóżmy, że masz następujący obiekt JSON:

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

W tym przykładzie pobrano właściwość root z powyższego obiektu JSON:

getProperty("a:b")

Zwraca wartość a:b ciągu.

getTimeOfDay

Zwraca godzinę dnia dla danego znacznika czasu.

getTimeOfDay('<timestamp>')

Zwracany czas jest jednym z następujących ciągów:

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający określony znacznik czasu

Wartość zwracana	Type	Opis
<godzina dnia>	string	Godzina dnia dla określonego znacznika czasu

Poniżej przedstawiono ciągi skojarzone z godziną dnia:

Godzina dnia	Sygnatura czasowa
Północ	12:00
Rano	12:01–11:59
Popołudnie	12PM
Wieczór	18:00–10:00
Noc	10:01–11:59

Przykład

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

Zwraca wynik rano.

greater

Sprawdź, czy pierwsza wartość jest większa niż druga wartość. Zwróć true , jeśli pierwsza wartość jest większa lub zwracana false , jeśli jest mniejsza.

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

Parametr	Wymagania	Type	Opis
<wartość>	Tak	liczba całkowita, zmiennoprzecinkowa lub ciąg	Pierwsza wartość do sprawdzenia, czy większa niż druga wartość
<compareTo>	Tak	liczba całkowita, zmiennoprzecinkowa lub ciąg, odpowiednio	Wartość porównania

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwracaj true , jeśli pierwsza wartość jest większa niż druga wartość. Zwracaj false , jeśli pierwsza wartość jest równa lub mniejsza niż druga wartość.

Przykład

Te przykłady sprawdzają, czy pierwsza wartość jest większa niż druga wartość:

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

I zwróć odpowiednio następujące wyniki:

• true
• false

greaterOrEquals

Sprawdź, czy pierwsza wartość jest większa, czy równa drugiej wartości. Zwracaj true , gdy pierwsza wartość jest większa lub równa, lub zwraca false , jeśli pierwsza wartość jest mniejsza.

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

Parametr	Wymagania	Type	Opis
<wartość>	Tak	liczba całkowita, zmiennoprzecinkowa lub ciąg	Pierwsza wartość do sprawdzenia, czy wartość większa niż lub równa drugiej wartości
<compareTo>	Tak	liczba całkowita, zmiennoprzecinkowa lub ciąg, odpowiednio	Wartość porównania

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwracaj true , jeśli pierwsza wartość jest większa lub równa drugiej wartości. Zwróć, false jeśli pierwsza wartość jest mniejsza niż druga wartość.

Przykład

Te przykłady sprawdzają, czy pierwsza wartość jest większa, czy równa drugiej wartości:

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

I zwróć odpowiednio następujące wyniki:

• true
• false

jeżeli

Sprawdź, czy wyrażenie ma wartość true, czy false. Na podstawie wyniku zwróć określoną wartość.

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

Parametr	Wymagania	Type	Opis
<wyrażenie>	Tak	Wartość logiczna	Wyrażenie do sprawdzenia
<valueIfTrue>	Tak	dowolny	Wartość, która ma być zwracana, jeśli wyrażenie ma wartość true
<valueIfFalse>	Tak	dowolny	Wartość, która ma być zwracana, jeśli wyrażenie ma wartość false

Wartość zwracana	Type	Opis
<określona wartość zwracana>	dowolny	Określona wartość zwracana na podstawie tego, czy wyrażenie jest true , czy false

Przykład

W tym przykładzie ocenisz, czy equals(1,1) wartość jest prawdziwa:

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

Zwraca wartość tak , ponieważ określone wyrażenie zwraca wartość true. W przeciwnym razie przykład zwraca wartość nie.

indexOf

Zwraca wartość pozycji początkowej lub indeksu podciągów. Ta funkcja jest niewrażliwa na wielkość liter, a indeksy zaczynają się od liczby 0.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	ciąg lub tablica	Ciąg zawierający podciąg do znalezienia
<tekst wyszukiwania>	Tak	string	Podciąg do znalezienia

Wartość zwracana	Type	Opis
<index-value>	integer	Pozycja początkowa lub wartość indeksu określonego podciągu.
Jeśli ciąg nie zostanie znaleziony, zwróć liczbę -1.

Przykład 1

W tym przykładzie znajduje wartość indeksu początkowego świata podciągów w świecie hello ciągu:

indexOf('hello world', 'world')

I zwraca wynik 6.

Przykład 2

W tym przykładzie znajduje wartość indeksu początkowego def podciągów w tablicy ["abc", "def", "ghi"]:

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

Zwraca wynik 1.

indeksyAndValues

Przekształcanie tablicy lub obiektu w tablicę obiektów za pomocą właściwości indeksu (bieżącego indeksu) i wartości. W przypadku tablic indeks jest pozycją w tablicy. W przypadku obiektów jest to klucz dla wartości.

indicesAndValues('<collection or object>')

Parametr	Wymagania	Type	Opis
<kolekcja lub obiekt>	Tak	tablica lub obiekt	Oryginalna tablica lub obiekt

Wartość zwracana	Type	Opis
<kolekcja>	tablica	Nowa tablica. Każdy element ma dwie właściwości: indeks z pozycją w tablicy lub kluczem obiektu oraz odpowiednią wartością.

Przykład 1

Załóżmy, że masz listę { items: ["zero", "one", "two"] }. Poniższa funkcja przyjmuje tę listę:

indicesAndValues(items)

I zwraca nową listę:

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

Przykład 2

Załóżmy, że masz listę { items: ["zero", "one", "two"] }. Poniższa funkcja przyjmuje tę listę:

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

I zwraca nową listę:

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

Przykład 3

Załóżmy, że masz listę { items: ["zero", "one", "two"] }. Poniższa funkcja przyjmuje tę listę:

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

I zwraca wynik zero,jeden,dwa. To wyrażenie ma taki sam efekt jak join(items, ',)).

Przykład 4

Załóżmy, że masz obiekt { użytkownik: {name: "jack", wiek: 20} }. Następująca funkcja przyjmuje ten obiekt:

indicesAndValues(user)

I zwraca nowy obiekt:

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

int

Zwraca wersję całkowitą ciągu. Wyjątek zostanie zgłoszony, jeśli nie można przekonwertować ciągu na liczbę całkowitą.

int('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	string	Ciąg do konwersji

Wartość zwracana	Type	Opis
<wynik liczby całkowitej>	integer	Wersja całkowita określonego ciągu

Przykład

W tym przykładzie zostanie utworzona wersja całkowita dla ciągu 10:

int('10')

Zwraca wynik jako liczbę całkowitą 10.

skrzyżowanie

Zwróć kolekcję zawierającą tylko wspólne elementy w określonych kolekcjach. Aby wyświetlić wynik, element musi pojawić się we wszystkich kolekcjach przekazanych do tej funkcji. Jeśli co najmniej jeden element ma taką samą nazwę, w wyniku pojawi się ostatni element o tej nazwie.

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

Parametr	Wymagania	Type	Opis
<kolekcja1>, <kolekcja2>	Tak	tablica lub obiekt, ale nie oba	Kolekcje, z których mają być używane tylko wspólne elementy

Wartość zwracana	Type	Opis
<wspólne elementy>	tablica lub obiekt, odpowiednio	Kolekcja zawierająca tylko wspólne elementy w określonych kolekcjach

Przykład

W tym przykładzie znaleziono typowe elementy w następujących tablicach:

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

Zwraca tablicę z tylko elementami [1, 2].

isArray

Zwróć, true jeśli dane wejściowe są tablicą.

isArray('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	dowolny	Dane wejściowe do przetestowania

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwróć, true jeśli dane wejściowe są tablicą lub zwracają false , jeśli nie jest to tablica.

Przykłady

Poniższe przykłady sprawdzają, czy dane wejściowe są tablicą:

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

I zwróć odpowiednio następujące wyniki:

• Dane wejściowe są ciągiem, więc funkcja zwraca falsewartość .
• Dane wejściowe są tablicą, więc funkcja zwraca wartość true.

isBoolean

Zwróć, true jeśli dane wejściowe są wartością logiczną.

isBoolean('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	dowolny	Dane wejściowe do przetestowania

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwróć true , jeśli dane wejściowe są wartością logiczną lub zwracają false wartość logiczną, jeśli nie jest to wartość logiczna.

Przykłady

Poniższe przykłady sprawdzają, czy dane wejściowe są wartością logiczną:

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

I zwróć odpowiednio następujące wyniki:

• Dane wejściowe są ciągiem, więc funkcja zwraca falsewartość .
• Dane wejściowe są wartością logiczną, więc funkcja zwraca wartość true.

isDate

Zwróć, true jeśli dana wartość timexProperty lub timex wyrażenie odwołuje się do prawidłowej daty. Prawidłowe daty zawierają miesiąc i dzieńOfMonth lub zawierają dzieńOfWeek.

isDate('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	obiekt lub ciąg	Wejściowy obiekt TimexProperty lub ciąg wyrażenia Timex.

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwróć, true jeśli dane wejściowe odwołują się do prawidłowej daty lub zwracają false , czy data jest nieprawidłowa.

Przykłady

Te przykłady sprawdzają, czy następujące dane wejściowe są prawidłowymi datami:

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

I zwróć następujące wyniki:

• false
• true

isDateRange

Zwróć true , jeśli dane wyrażenie TimexProperty lub Timex odwołuje się do prawidłowego zakresu dat.

isDateRange('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	obiekt lub ciąg	Wejściowy obiekt TimexProperty ciąg wyrażenia Timex.

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwróć, true jeśli dane wejściowe odwołują się do prawidłowego zakresu dat lub zwracają false , jeśli nie jest to prawidłowy zakres dat.

Przykłady

Te przykłady sprawdzają, czy następujące dane wejściowe są prawidłowym zakresem dat:

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

I zwróć następujące wyniki:

• false
• true

isDateTime

Zwróć true , jeśli dane wejściowe są formatem ISO UTC (RRRR-MM-DDTHH:mm:ss.fffZ) ciąg znacznika czasu.

isDateTime('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	dowolny	Dane wejściowe do przetestowania

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwróć true wartość, jeśli dane wejściowe są ciągiem znacznika czasu formatu ISO UTC lub zwróć false , jeśli nie jest to ciąg znacznika czasu formatu ISO UTC.

Przykłady

Poniższe przykłady sprawdzają, czy dane wejściowe są ciągiem formatu ISO UTC:

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

I zwróć odpowiednio następujące wyniki:

• Dane wejściowe są ciągiem, więc funkcja zwraca falsewartość .
• Dane wejściowe są ciągiem formatu ISO UTC, więc funkcja zwraca wartość true.

isDefinite

Zwróć, true jeśli dana wartość timexProperty lub timex wyrażenie odwołuje się do prawidłowej daty. Prawidłowe daty zawierają rok, miesiąc i dzieńMonth.

isDefinite('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	obiekt lub ciąg	Wejściowy obiekt TimexProperty ciąg wyrażenia Timex.

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwróć true , jeśli dane wejściowe odnoszą się do prawidłowej pełnej daty lub zwracają false , jeśli nie odnoszą się do prawidłowej pełnej daty.

Przykłady

Załóżmy, że istnieje obiekt TimexProperty validFullDate = new TimexProperty("2020-02-20") i Now właściwość jest ustawiona na truewartość . Poniższe przykłady sprawdzają, czy obiekt odwołuje się do prawidłowej pełnej daty:

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

I zwróć odpowiednio następujące wyniki:

• false
• true

isDuration

Zwróć, true jeśli dane wyrażenie TimexProperty lub Timex odnosi się do prawidłowego czasu trwania.

isDuration('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	obiekt lub ciąg	Wejściowy obiekt TimexProperty ciąg wyrażenia Timex.

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwróć, true jeśli dane wejściowe odnoszą się do prawidłowego czasu trwania lub zwracają false , jeśli dane wejściowe nie odnoszą się do prawidłowego czasu trwania.

Przykłady

Poniższe przykłady sprawdzają, czy następujące dane wejściowe odnoszą się do prawidłowego czasu trwania:

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

I zwróć odpowiednio następujące wyniki:

• true
• false

isFloat

Zwracaj true , jeśli dane wejściowe są liczbą zmiennoprzecinkową. Ze względu na wyrównanie między językami C# i JavaScript liczba z niezerową pozostałością modulo 1 będzie traktowana jako liczba zmiennoprzecinkowa.

isFloat('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	dowolny	Dane wejściowe do przetestowania

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwróć true , jeśli dane wejściowe są liczbą zmiennoprzecinkową lub zwracają false , jeśli dane wejściowe nie są liczbą zmiennoprzecinkową.

Przykłady

Poniższe przykłady sprawdzają, czy dane wejściowe są liczbą zmiennoprzecinkową:

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

I zwróć odpowiednio następujące wyniki:

• Dane wejściowe są ciągiem, więc funkcja zwraca falsewartość .
• Dane wejściowe mają modulo równe 0, więc funkcja zwraca wartość false.
• Dane wejściowe są liczbą zmiennoprzecinkową, więc funkcja zwraca truewartość .

isInteger

Zwracaj true , jeśli dane wejściowe są liczbą całkowitą. Ze względu na wyrównanie między językami C# i JavaScript liczba z zerową pozostałością modulo 1 będzie traktowana jako liczba całkowita.

isInteger('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	dowolny	Dane wejściowe do przetestowania

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Czy dane wejściowe są liczbą całkowitą

Przykłady

Poniższe przykłady sprawdzają, czy dane wejściowe są liczbą całkowitą:

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

I zwróć odpowiednio następujące wyniki:

• Dane wejściowe są ciągiem, więc funkcja zwraca falsewartość .
• Dane wejściowe mają modulo równe 0, więc funkcja zwraca wartość true.
• Dane wejściowe są liczbą całkowitą, więc funkcja zwraca wartość true.

isMatch

Zwracaj true , jeśli dany ciąg jest zgodny z określonym wzorcem wyrażenia regularnego.

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

Parametr	Wymagania	Type	Opis
<docelowy**ciąg>	Tak	string	Ciąg do dopasowania
<deseń>	Tak	string	Wzorzec wyrażenia regularnego

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwróć, true jeśli dany ciąg jest zgodny ze wspólnym wzorcem wyrażenia regularnego lub zwraca false , jeśli nie jest zgodny ze wzorcem.

Przykłady

Poniższe przykłady sprawdzają, czy dane wejściowe są zgodne ze wzorcem określonego wyrażenia regularnego:

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

I zwróć ten sam wynik true.

isObject

Zwróć, true jeśli dane wejściowe są obiektem złożonym lub zwracane false , jeśli jest to obiekt pierwotny. Obiekty pierwotne obejmują ciągi, liczby i wartości logiczne; typy złożone, takie jak klasy, zawierają właściwości.

isObject('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	dowolny	Dane wejściowe do przetestowania

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwracaj true , jeśli dane wejściowe są obiektem złożonym lub zwracają false , czy jest to obiekt pierwotny.

Przykłady

Poniższe przykłady sprawdzają, czy dane wejściowe są obiektem:

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

I zwróć odpowiednio następujące wyniki:

• Dane wejściowe są ciągiem, więc funkcja zwraca falsewartość .
• Dane wejściowe są obiektem, więc funkcja zwraca wartość true.

isPresent

Zwróć true , jeśli dane wyrażenie TimexProperty lub Timex odwołuje się do obecnej.

isPresent('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	obiekt lub ciąg	Wejściowy obiekt TimexProperty ciąg wyrażenia Timex

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwróć, true jeśli dane wejściowe odwołują się do obecnej, lub zwracają wartość false, jeśli nie odwołują się do obecnej.

Przykłady załóżmy, że mamy obiekt TimexProperty validNow = new TimexProperty() { Now = true } i ustaw Now właściwość na true. Poniższe przykłady sprawdzają, czy następujące dane wejściowe odnoszą się do obecnych:

isPresent('PT30M')
isPresent(validNow)

I zwróć odpowiednio następujące wyniki:

• false
• true

isString

Zwracaj true , jeśli dane wejściowe są ciągiem.

isString('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	dowolny	Dane wejściowe do przetestowania

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwracaj true , jeśli dane wejściowe są ciągiem lub zwracają false ciąg, jeśli nie jest to ciąg.

Przykłady

Poniższe przykłady sprawdzają, czy dane wejściowe są ciągiem:

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

I zwróć odpowiednio następujące wyniki:

• Dane wejściowe są ciągiem, więc funkcja zwraca truewartość .
• Dane wejściowe są zmiennoprzecinkowe, więc funkcja zwraca wartość false.

isTime

Zwróć, true jeśli dane wyrażenie TimexProperty lub Timex odnosi się do prawidłowego czasu. Prawidłowy czas zawiera godziny, minuty i sekundy.

isTime('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	obiekt lub ciąg	Wejściowy obiekt TimexProperty ciąg wyrażenia Timex

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwróć true , jeśli dane wejściowe odnoszą się do prawidłowego czasu lub zwracają false , jeśli nie odwołują się do prawidłowego czasu.

Przykłady

Te przykłady sprawdzają, czy następujące dane wejściowe odnoszą się do prawidłowego czasu:

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

I zwróć odpowiednio następujące wyniki:

• false
• true

isTimeRange

Zwróć, true jeśli dane wyrażenie TimexProperty lub Timex odwołuje się do prawidłowego zakresu czasu Prawidłowe zakresy czasu zawierają partOfDay.

isTime('<input>')

Parametr	Wymagania	Type	Opis
<wkład>	Tak	obiekt lub ciąg	Wejściowy obiekt TimexProperty ciąg wyrażenia Timex.

Wartość zwracana	Type	Opis
<Wynik logiczny>	Wartość logiczna	Zwróć true , jeśli dane wejściowe odwołują się do prawidłowego zakresu czasu lub zwracają false , jeśli nie odwołują się do prawidłowego zakresu czasu.

Przykłady

Załóżmy, że mamy obiekt TimexProperty validTimeRange = new TimexProperty() { PartOfDay = "morning" } i ustaw Now właściwość na true. Te przykłady sprawdzają, czy następujące dane wejściowe są prawidłowymi zakresami czasu:

isTimeRange('PT30M')
isTimeRange(validTimeRange)

I zwróć odpowiednio następujące wyniki:

• false
• true

join

Zwróć ciąg, który zawiera wszystkie elementy z tablicy, z każdym znakiem oddzielonym ogranicznikiem.

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

Parametr	Wymagania	Type	Opis
<kolekcja>	Tak	tablica	Tablica zawierająca elementy do sprzężenia
<Ogranicznik>	Tak	string	Separator, który pojawia się między poszczególnymi znakami w wynikowym ciągu

Wartość zwracana	Type	Opis
<ogranicznik><char1><char2><ogranicznik...>	string	Wynikowy ciąg utworzony na podstawie wszystkich elementów w określonej tablicy

Przykład

W tym przykładzie zostanie utworzony ciąg ze wszystkich elementów tej tablicy z określonym znakiem . Jako ogranicznik:

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

Zwraca wynik a.b.c.

jPath

Sprawdź dane JSON lub ciąg JSON dla węzłów lub wartości pasujących do wyrażenia ścieżki i zwracają pasujące węzły.

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

Parametr	Wymagania	Type	Opis
<JSON>	Tak	dowolny	Obiekt JSON lub ciąg do wyszukiwania węzłów lub wartości, które są zgodne z wartością wyrażenia ścieżki
<path>	Tak	dowolny	Wyrażenie ścieżki używane do znajdowania pasujących węzłów lub wartości JSON

Wartość zwracana	Type	Opis
[ <json-node>]	tablica	Lista węzłów lub wartości JSON pasujących do określonego wyrażenia ścieżki

Przykład w języku C#

Załóżmy, że masz następujący kod 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
                }
            ]
        }
    ]
}

Wyrażenie ścieżki to $.. Products[?( @. Cena >= 50)]. Nazwa

jPath(jsonStr, path)

I zwraca wynik ["Anvil", "Łokieć Smar"].

Przykład języka JavaScript

Załóżmy, że masz następujący kod 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
        }
    ]
}

Wyrażenie ścieżki to .automobiles{.maker } "Honda" && .year > 2009}.model.

jPath(jsonStr, path)

I zwraca wynik ['Jazz', 'Accord'].

json

Zwróć wartość typu JavaScript Object Notation (JSON) lub obiekt ciągu lub XML.

json('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	ciąg lub xml	Ciąg lub kod XML do konwersji

Wartość zwracana	Type	Opis
<Wynik JSON>	string	Wynikowy obiekt JSON utworzony na podstawie określonego ciągu lub kodu XML.

Przykład 1

W tym przykładzie ciąg jest konwertowany na format JSON:

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

I zwraca wynik:

{
  "fullName": "Sophia Owen"
}

Przykład 2

W tym przykładzie kod XML jest konwertowany na format JSON:

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

I zwraca wynik:

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

jsonStringify

Zwróć ciąg JSON wartości.

Parametr	Wymagania	Type	Opis
<wartość>	Tak	obiekt	Obiekt do konwersji na ciąg JSON

Wartość zwracana	Type	Opis
<Wynik JSON>	string	Wynikowy ciąg JSON.

Przykłady

W poniższych przykładach pokazano obiekty przekonwertowane na ciągi JSON:

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

I zwróć odpowiednio następujące wyniki ciągu:

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

ostatni

Zwróć ostatni element z kolekcji.

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

Parametr	Wymagania	Type	Opis
<kolekcja>	Tak	ciąg lub tablica	Kolekcja, w której należy znaleźć ostatni element

Wartość zwracana	Type	Opis
<ostatni element kolekcji>	ciąg lub tablica, odpowiednio	Ostatni element w kolekcji

Przykład

Te przykłady znajdują ostatni element w tych kolekcjach:

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

I zwraca odpowiednio następujące wyniki:

• d
• 3

lastIndexOf

Zwraca wartość pozycji początkowej lub indeksu ostatniego wystąpienia podciągów. Ta funkcja jest niewrażliwa na wielkość liter, a indeksy zaczynają się od liczby 0.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	ciąg lub tablica	Ciąg zawierający podciąg do znalezienia
<tekst wyszukiwania>	Tak	string	Podciąg do znalezienia

Wartość zwracana	Type	Opis
<end-index-value>	integer	Początkowa pozycja lub wartość indeksu ostatniego wystąpienia określonego podciągu. Jeśli ciąg nie zostanie znaleziony, zwróć liczbę -1.

Przykład 1

W tym przykładzie znajduje wartość indeksu początkowego ostatniego wystąpienia świata podciągów w ciągu hello world:

lastIndexOf('hello world', 'world')

I zwraca wynik 6.

Przykład 2

W tym przykładzie znajduje wartość indeksu początkowego ostatniego wystąpienia def podciągów w tablicy ["abc", "def", "ghi", "def"].

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

I zwraca wynik 3.

length

Zwraca długość ciągu.

length('<str>')

Parametr	Wymagania	Type	Opis
<Str>	Tak	string	Ciąg, który ma być obliczany pod kątem długości

Wartość zwracana	Type	Opis
<length>	integer	Długość tego ciągu

Przykłady

Te przykłady umożliwiają uzyskanie długości ciągów:

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

I zwraca odpowiednio następujące wyniki:

• 5
• 11

less

Sprawdź, czy pierwsza wartość jest mniejsza niż druga wartość. Zwróć, true jeśli pierwsza wartość jest mniejsza lub zwracana false , jeśli pierwsza wartość jest większa.

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

Parametr	Wymagania	Type	Opis
<wartość>	Tak	liczba całkowita, zmiennoprzecinkowa lub ciąg	Pierwsza wartość do sprawdzenia, czy wartość mniejsza niż druga
<compareTo>	Tak	liczba całkowita, zmiennoprzecinkowa lub ciąg, odpowiednio	Element porównania

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwróć, true jeśli pierwsza wartość jest mniejsza niż druga wartość. Zwracaj false , jeśli pierwsza wartość jest równa lub większa niż druga wartość.

Przykłady

Te przykłady sprawdzają, czy pierwsza wartość jest mniejsza niż druga wartość.

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

I zwróć odpowiednio następujące wyniki:

• true
• false

lessOrEquals

Sprawdź, czy pierwsza wartość jest mniejsza, czy równa drugiej wartości. Zwróć true , jeśli pierwsza wartość jest mniejsza lub równa, lub zwracana false , jeśli pierwsza wartość jest większa.

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

Parametr	Wymagania	Type	Opis
<wartość>	Tak	liczba całkowita, zmiennoprzecinkowa lub ciąg	Pierwsza wartość do sprawdzenia, czy wartość mniejsza niż lub równa drugiej wartości
<compareTo>	Tak	liczba całkowita, zmiennoprzecinkowa lub ciąg, odpowiednio	Element porównania

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwracaj true , jeśli pierwsza wartość jest mniejsza lub równa drugiej wartości. Zwracaj false , jeśli pierwsza wartość jest większa niż druga wartość.

Przykład

Te przykłady sprawdzają, czy pierwsza wartość jest mniejsza, czy równa drugiej wartości.

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

I zwróć odpowiednio następujące wyniki:

• true
• false

max

Zwraca najwyższą wartość z listy lub tablicy. Lista lub tablica jest inkluzywna na obu końcach.

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

Parametr	Wymagania	Type	Opis
<liczba1>, <liczba2>, ...	Tak	Liczba	Zestaw liczb, z których chcesz uzyskać najwyższą wartość
[<number1>, <number2>, ...]	Tak	tablica liczb	Tablica liczb, z której ma być najwyższa wartość

Wartość zwracana	Type	Opis
<wartość maksymalna>	Liczba	Najwyższa wartość w określonej tablicy lub zestawie liczb

Przykłady

Te przykłady pobierają najwyższą wartość z zestawu liczb i tablicy:

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

I zwróć wynik 3.

Scalanie

Scala wiele obiektów JSON lub tablicę obiektów razem.

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

Parametr	Wymagania	Type	Opis
<json1>, <json2>, ...	Tak	obiekty lub tablica	Zestaw obiektów JSON lub tablicy do scalenia.

Wartość zwracana	Type	opis
<wynik>	obiekt	Połączony obiekt JSON lub połączone obiekty tablicowe.

Przykłady

Załóżmy, że masz następujące obiekty JSON:

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

W tym przykładzie scalane są obiekty JSON:

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

Zwraca wynikowy obiekt {"FirstName":"John","LastName":"Smith","Enabled":true,"Roles":"User","Admin"]}.

Załóżmy, że chcesz połączyć obiekty i listę obiektów razem. Poniższy przykład łączy obiekt JSON i tablicę obiektów:

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

Zwraca obiekt { "k1": "v1", "k2": "v2", "k3": "v3", "k4": "v4" }.

min

Zwraca najniższą wartość z zestawu liczb lub tablicy.

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

Parametr	Wymagania	Type	Opis
<liczba1>, <liczba2>, ...	Tak	Liczba	Zestaw liczb, z których ma być najniższa wartość
[<number1>, <number2>, ...]	Tak	tablica liczb	Tablica liczb, z której ma być najniższa wartość

Wartość zwracana	Type	Opis
<minimalna wartość>	Liczba	Najniższa wartość w określonej tablicy lub zestawie liczb

Przykłady

Te przykłady pobierają najniższą wartość w zestawie liczb i tablicy:

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

I zwróć wynik 1.

mod

Zwróć resztę z dzielenia dwóch liczb. Aby uzyskać wynik liczby całkowitej, zobacz div().

mod(<dividend>, <divisor>)

Parametr	Wymagania	Type	Opis
<dywidenda>	Tak	Liczba	Liczba do podzielenia przez dzielnik
<dzielnik>	Tak	Liczba	Liczba dzieląca dywidendę. Nie można mieć 0.

Wartość zwracana	Type	Opis
<modulo-wynik>	Liczba	Pozostała część z dzielenia pierwszej liczby przez drugą liczbę

Przykład

W tym przykładzie pierwsza liczba jest podzielona przez drugą liczbę:

mod(3, 2)

Zwraca wynik 1.

miesiąca

Zwróć miesiąc określonego znacznika czasu.

month('<timestamp>')

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu

Wartość zwracana	Type	Opis
<liczba miesięcy>	integer	Liczba miesięcy w określonym znaczniku czasu

Przykład

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

I zwraca wynik 3.

mul

Zwróć produkt z mnożenia dwóch liczb.

mul(<multiplicand1>, <multiplicand2>)

Parametr	Wymagania	Type	Opis
<multiplicand1>	Tak	liczba całkowita lub zmiennoprzecinkowa	Liczba, która ma być mnożna przez mnożenie i 2
<multiplicand2>	Tak	liczba całkowita lub zmiennoprzecinkowa	Liczba wielokrotna mnożenia i1

Wartość zwracana	Type	Opis
<wynik produktu>	liczba całkowita lub zmiennoprzecinkowa	Produkt z mnożenia pierwszej liczby przez drugą liczbę

Przykłady

W tych przykładach wiele pierwszej liczby według drugiej liczby:

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

I zwróć odpowiednio następujące wyniki:

• 2
• 3

newGuid

Zwróć nowy ciąg Guid.

newGuid()

Wartość zwracana	Type	Opis
<Ciąg guid>	string	Nowy ciąg Guid, długość to 36 i wygląda jak xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxx

Przykład

newGuid()

Zwraca wynik, który jest zgodny z formatem xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx.

not

Sprawdź, czy wyrażenie jest fałszywe. Zwróć, true jeśli wyrażenie ma wartość false lub zwraca false wartość true.

not(<expression>)

Parametr	Wymagania	Type	Opis
<wyrażenie>	Tak	Wartość logiczna	Wyrażenie do sprawdzenia

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwróć wartość true , jeśli wyrażenie ma wartość false. Zwróć wartość false , jeśli wyrażenie ma wartość true.

Przykład 1

Te przykłady sprawdzają, czy określone wyrażenia są fałszywe:

not(false)
not(true)

I zwróć odpowiednio następujące wyniki:

• Wyrażenie jest fałszywe, więc funkcja zwraca truewartość .
• Wyrażenie ma wartość true, więc funkcja zwraca falsewartość .

Przykład 2

Te przykłady sprawdzają, czy określone wyrażenia są fałszywe:

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

I zwróć odpowiednio następujące wyniki:

• Wyrażenie jest fałszywe, więc funkcja zwraca truewartość .
• Wyrażenie ma wartość true, więc funkcja zwraca falsewartość .

lub

Sprawdź, czy co najmniej jedno wyrażenie ma wartość true. Zwracaj true , jeśli co najmniej jedno wyrażenie ma wartość true, lub zwraca wartość false , jeśli wszystkie są fałszywe.

or(<expression1>, <expression2>, ...)

Parametr	Wymagania	Type	Opis
<expression1>, <expression2>, ...	Tak	Wartość logiczna	Wyrażenia do sprawdzenia

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwracaj, true jeśli co najmniej jedno wyrażenie ma wartość true. Zwróć, false jeśli wszystkie wyrażenia są fałszywe.

Przykład 1

Te przykłady sprawdzają, czy co najmniej jedno wyrażenie ma wartość true:

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

I zwróć odpowiednio następujące wyniki:

• Co najmniej jedno wyrażenie ma wartość true, więc funkcja zwraca truewartość .
• Oba wyrażenia są fałszywe, więc funkcja zwraca falsewartość .

Przykład 2

Te przykłady sprawdzają, czy co najmniej jedno wyrażenie ma wartość true:

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

I zwróć odpowiednio następujące wyniki:

• Co najmniej jedno wyrażenie ma wartość true, więc funkcja zwraca truewartość .
• Oba wyrażenia są fałszywe, więc funkcja zwraca falsewartość .

rand

Zwraca losową liczbę całkowitą z określonego zakresu, który jest uwzględniany tylko na końcu początkowym.

rand(<minValue>, <maxValue>)

Parametr	Wymagania	Type	Opis
<minValue>	Tak	integer	Najniższa liczba całkowita w zakresie
<maxValue>	Tak	integer	Liczba całkowita, która jest zgodna z najwyższą liczbą całkowitą w zakresie, który może zwrócić funkcja

Wartość zwracana	Type	Opis
<wynik losowy>	integer	Losowa liczba całkowita zwrócona z określonego zakresu

Przykład

W tym przykładzie jest pobierana losowa liczba całkowita z określonego zakresu, z wyłączeniem maksymalnej wartości:

rand(1, 5)

W wyniku zwraca wartość 1, 2, 3 lub 4 .

range

Zwraca tablicę całkowitą rozpoczynającą się od określonej liczby całkowitej.

range(<startIndex>, <count>)

Parametr	Wymagania	Type	Opis
<startIndex>	Tak	integer	Wartość całkowita, która uruchamia tablicę jako pierwszy element
<count>	Tak	integer	Liczba liczb całkowitych w tablicy

Wartość zwracana	Type	Opis
<wynik-zakres>	integer	Tablica z liczbami całkowitymi rozpoczynającymi się od określonego indeksu

Przykład

W tym przykładzie jest tworzona tablica całkowita, która rozpoczyna się od określonego indeksu 1 i ma określoną liczbę liczb całkowitych jako 4:

range(1, 4)

Zwraca wynik [1, 2, 3, 4].

removeProperty

Usuń właściwość z obiektu i zwróć zaktualizowany obiekt.

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

Parametr	Wymagania	Type	Opis
<object>	Tak	obiekt	Obiekt JSON, w którym chcesz usunąć właściwość
<właściwość>	Tak	string	Nazwa właściwości do usunięcia

Wartość zwracana	Type	Opis
<zaktualizowany obiekt>	obiekt	Zaktualizowany obiekt JSON bez określonej właściwości

Przykład

W tym przykładzie właściwość jest usuwana accountLocation z customerProfile obiektu, który jest konwertowany na format JSON za pomocą funkcji json() i zwraca zaktualizowany obiekt:

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

replace

Zastąp podciąg określonym ciągiem i zwróć ciąg wynikowy. Ta funkcja uwzględnia wielkość liter.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	string	Ciąg, który ma podciąg, który ma zastąpić
<oldText>	Tak	string	Podciąg do zastąpienia
<newText>	Tak	string	Ciąg zastępczy

Wartość zwracana	Type	Opis
<zaktualizowany tekst>	string	Zaktualizowany ciąg po zastąpieniu podciągu. Jeśli podciąg nie zostanie znaleziony, funkcja zwróci oryginalny ciąg.

Przykład 1

Ten przykład znajduje podciąg stary w starym ciągu i zastępuje stary nowym:

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

Wynikiem jest ciąg nowego ciągu.

Przykład 2

W przypadku czynienia z znakami ucieczki aparat wyrażeń obsługuje dla Ciebie niewysonego krajobrazu. Ta funkcja zastępuje ciągi znakami ucieczki.

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

I zwraca odpowiednio następujące wyniki:

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

replaceIgnoreCase

Zastąp podciąg określonym ciągiem i zwróć ciąg wynikowy. Ta funkcja nie uwzględnia wielkości liter.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	string	Ciąg, który ma podciąg, który ma zastąpić
<oldText>	Tak	string	Podciąg do zastąpienia
<newText>	Tak	string	Ciąg zastępczy

Wartość zwracana	Type	Opis
<zaktualizowany tekst>	string	Zaktualizowany ciąg po zastąpieniu podciągu. Jeśli podciąg nie zostanie znaleziony, zwróć oryginalny ciąg.

Przykład

W tym przykładzie w ciągu znajduje się stary podciąg w starym ciągu i zamienia stary na nowy:

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

Zwraca wynik nowego ciągu.

rozwiązać

Zwracany ciąg danego wyrażenia TimexProperty lub Timex, jeśli odwołuje się do prawidłowego czasu. Prawidłowy czas zawiera godziny, minuty i sekundy.

resolve('<timestamp')

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu.

Wartość zwracana	Type	Opis
<return>	string	Ciąg obliczonego wyrażenia TimexProperty lub Timex.

Przykłady

Te przykłady pokazują, czy podane ciągi odwołują się do prawidłowego czasu:

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

I zwraca odpowiednio następujące wyniki:

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

reverse

Odwraca kolejność elementów w ciągu lub tablicy.

reverse(<value>)

Parametr	Wymagania	Type	Opis
<wartość>	Tak	ciąg lub tablica	Ciąg do tablicy, aby odwrócić.

Wartość zwracana	Type	Opis
<return>	ciąg lub tablica	Odwrócone elementy ciągu lub tablicy.

Przykłady

Te przykłady odwracają elementy ciągu lub tablicy:

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

I zwróć odpowiednio następujące wartości:

-Ciąg olleh. -Ciąg dlrowolleh.

round

Zaokrąglij wartość do najbliższej liczby całkowitej lub do określonej liczby cyfr ułamkowych.

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

Parametr	Wymagania	Type	Opis
<numer>	Tak	Liczba	Numer wejściowy
<cyfry precyzji>	Nie.	integer	Określona liczba cyfr ułamkowych. Wartość domyślna to 0.

Wartość zwracana	Type	Opis
<return-value>	Liczba	Wartość zwracana danych wejściowych zaokrąglona przy określonej liczbie cyfr ułamkowych

Przykład 1

W tym przykładzie zaokrągla liczbę 10,333:

round(10.333)

Zwraca liczbę 10.

Przykład 2

W tym przykładzie liczba 10,3313 do 2 cyfr ułamkowych:

round(10.3313, 2)

Zwraca liczbę 10,33.

select

Działanie na każdym elemecie i zwracanie nowej kolekcji przekształconych elementów.

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

Parametr	Wymagania	Type	Opis
<kolekcja/wystąpienie>	Tak	tablica	Kolekcja z elementami
<iteratorName>	Tak	nazwa iteratora	Element klucza
<funkcja>	Tak	wyrażenie	Funkcja Th, która może zawierać iteratorName

Wartość zwracana	Type	Opis
<nowa kolekcja>	tablica	Nowa kolekcja, w której każdy element został oceniony za pomocą funkcji

Przykład 1

W tym przykładzie jest generowana nowa kolekcja:

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

Zwraca wynik [1, 2, 3, 4].

Przykład 2

Te przykłady generują nową kolekcję:

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

I zwróć wynik ['name:jack', 'age:15']. Zwróć uwagę, że drugie wyrażenie jest wyrażeniem lambda, które jest bardziej czytelne.

sentenceCase

Wielką literą pierwszego wyrazu w ciągu w opcjonalnym formacie ustawień regionalnych.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	string	Oryginalny ciąg
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
ciąg wyniku	string	Zwraca wynik przypadku zdania

Przykład 1

Te przykłady wielką literą w ciągu:

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

I zwróć odpowiednio następujące wyniki:

• A
• Abc def
• Abc def

Przykład 2

Te przykłady wielkich liter w ciągu w określonym formacie ustawień regionalnych:

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

I zwróć odpowiednio następujące wyniki:

• A
• Abecadło
• Abecadło

setPathToValue

Pobierz wartość określonej właściwości z obiektu JSON.

setPathToValue(<path>, <value>)

Parametr	Wymagania	Type	Opis
<Ścieżka>	Tak	obiekt	Ścieżka, którą chcesz ustawić
<wartość>	Tak	obiekt	Wartość, którą chcesz ustawić na ścieżkę

Wartość zwracana	Type	Opis
wartość	obiekt	Należy ustawić wartość

Przykład 1

Poniższy przykład ustawia wartość 1 na ścieżkę:

setPathToValue(path.x, 1)

Zwraca wynik 1. path.x jest ustawiona na wartość 1.

Przykład 2

W poniższym przykładzie ustawiono wartość:

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

Zwraca wynik 14.

setProperty

Ustaw wartość właściwości obiektu i zwróć zaktualizowany obiekt. Aby dodać nową właściwość, użyj tej funkcji lub funkcji addProperty().

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

Parametr	Wymagania	Type	Opis
<object>	Tak	obiekt	Obiekt JSON, w którym chcesz ustawić właściwość
<właściwość>	Tak	string	Nazwa właściwości do ustawienia
<wartość>	Tak	dowolny	Wartość ustawiona dla określonej właściwości

Wartość zwracana	Type	Opis
<zaktualizowany obiekt>	obiekt	Zaktualizowany obiekt JSON, którego właściwość została ustawiona

Przykład

W tym przykładzie accountNumber właściwość ustawia obiektcustomerProfile, który jest konwertowany na format JSON za pomocą funkcji json(). Funkcja przypisuje wartość wygenerowaną przez funkcję newGuid() i zwraca zaktualizowany obiekt JSON:

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

skip

Usuń elementy z przodu kolekcji i zwróć wszystkie inne elementy.

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

Parametr	Wymagania	Type	Opis
<kolekcja>	Tak	tablica	Kolekcja, której elementy chcesz usunąć
<count>	Tak	integer	Dodatnia liczba całkowita dla liczby elementów do usunięcia z przodu

Wartość zwracana	Type	Opis
<updatedCollection>	tablica	Zaktualizowana kolekcja po usunięciu określonych elementów

Przykład

W tym przykładzie usunięto jeden element ( liczbę 1) z przodu określonej tablicy:

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

Zwraca tablicę z pozostałymi elementami: [1,2,3].

sortBy

Sortuj elementy w kolekcji w kolejności rosnącej i zwracają posortowaną kolekcję.

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

Parametr	Wymagania	Type	Opis
<kolekcja>	Tak	ciąg lub tablica	Kolekcja do sortowania
<właściwość>	Nie.	string	Sortuj według tej konkretnej właściwości elementu obiektu w kolekcji, jeśli ustawiono

Wartość zwracana	Type	Opis
<nowa kolekcja>	tablica	Nowa kolekcja, której elementy zostały posortowane

Przykład 1

Ten przykład generuje następującą kolekcję:

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

I zwróć wynik [0, 1, 2, 3].

Przykład 2

Załóżmy, że masz następującą kolekcję:

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

W tym przykładzie jest generowana nowa posortowana kolekcja na podstawie właściwości obiektu x

sortBy(nestedItems, 'x')

I zwraca wynik:

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

sortByDescending

Sortuj elementy w kolekcji w kolejności malejącej i zwracają posortowaną kolekcję.

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

Parametr	Wymagania	Type	Opis
<kolekcja>	Tak	ciąg lub tablica	Kolekcja do sortowania
<właściwość>	Nie.	string	Sortuj według tej konkretnej właściwości elementu obiektu w kolekcji, jeśli ustawiono

Wartość zwracana	Type	Opis
<nowa kolekcja>	tablica	Nowa kolekcja, której elementy zostały posortowane

Przykład 1

W tym przykładzie jest generowana nowa posortowana kolekcja:

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

Zwraca wynik [3, 2, 1, 0].

Przykład 2

Załóżmy, że masz następującą kolekcję:

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

W tym przykładzie jest generowana nowa posortowana kolekcja na podstawie właściwości x obiektu:

sortByDescending(nestedItems, 'x')

I zwraca ten wynik:

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

split

Zwraca tablicę zawierającą podciągi oddzielone przecinkami na podstawie określonego znaku ogranicznika w oryginalnym ciągu.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	string	Ciąg do oddzielenia od podciągów na podstawie określonego ogranicznika w oryginalnym ciągu. Jeśli tekst jest wartością null, zostanie on pobrany jako pusty ciąg.
<Ogranicznik>	Nie.	string	Znak w oryginalnym ciągu, który ma być używany jako ogranicznik. Jeśli ogranicznik nie jest podany lub ogranicznik jest wartością null, wartość domyślna będzie pustym ciągiem.

Wartość zwracana	Type	Opis
[<podciąg1,podciąg2>><,...]	tablica	Tablica zawierająca podciągy z oryginalnego ciągu oddzielona przecinkami

Przykłady

Te przykłady tworzą tablicę z podciągami z określonego ciągu na podstawie określonego znaku ogranicznika:

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

I zwraca następujące tablice odpowiednio w wyniku:

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

Sqrt

Zwraca pierwiastek kwadratowy określonej liczby.

sqrt(<number>)

Parametr	Wymagania	Type	Opis
<numer>	Tak	Liczba	Liczba, aby uzyskać pierwiastek kwadratowy z

Wartość zwracana	Type	opis
<wynik>	Liczba	Wynik przetwarzania pierwiastek kwadratowy.

Przykłady

Te przykłady obliczają pierwiastek kwadratowy określonych liczb:

sqrt(9)
sqrt(0)

I zwróć odpowiednio następujące wyniki:

• 3
• 0

startOfDay

Zwróć początek dnia dla znacznika czasu w opcjonalnym formacie ustawień regionalnych.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
"<updated-timestamp>"	string	Określony znacznik czasu rozpoczynający się od znacznika zero-godzinnego dla dnia

Przykład 1

W tym przykładzie znajduje się początek dnia:

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

Zwraca wynik 2018-03-15T00:00:00.000Z.

Przykład 2

W tym przykładzie znajduje się początek dnia z ustawieniami regionalnymi fr-FR:

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

Zwraca wynik 15.03.2018 00:00:00.

startOfHour

Zwróć początek godziny dla znacznika czasu w opcjonalnym formacie ustawień regionalnych.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
"<updated-timestamp>"	string	Określony znacznik czasu rozpoczynający się od znacznika zero-minutowego dla dnia

Przykład 1

W tym przykładzie znajduje się początek godziny:

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

Zwraca wynik 2018-03-15T13:00:00.000Z.

Przykład 2

W tym przykładzie znajduje się początek godziny z ustawieniami regionalnymi fr-FR:

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

Zwraca wynik 15.03.2018 13:00:00.

startOfMonth

Zwróć początek miesiąca dla znacznika czasu w opcjonalnym formacie ustawień regionalnych.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
"<updated-timestamp>"	string	Określony znacznik czasu rozpoczynający się w pierwszym dniu miesiąca na znaczniku zero-godzinnym

Przykład 1

W tym przykładzie znajduje się początek miesiąca:

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

Zwraca wynik 2018-03-01T00:00:00.000Z.

Przykład 2

W tym przykładzie znajduje się początek miesiąca z ustawieniami regionalnymi fr-FR:

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

Zwraca wynik 01/03/2018 00:00:00.

startsWith

Sprawdź, czy ciąg rozpoczyna się od określonego podciągu. Zwróć, true jeśli podciąg zostanie znaleziony, lub zwróć false wartość , jeśli nie zostanie znaleziona. Ta funkcja nie uwzględnia wielkości liter.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	string	Ciąg do sprawdzenia
<tekst wyszukiwania>	Tak	string	Początkowy podciąg do znalezienia

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwróć, true jeśli zostanie znaleziony podciąg początkowy. Zwracanie false , jeśli nie znaleziono

Przykład 1

W tym przykładzie sprawdza się, czy ciąg hello world rozpoczyna się od ciągu hello:

startsWith('hello world', 'hello')

Zwraca wynik true.

Przykład 2

W tym przykładzie sprawdza się, czy ciąg hello world zaczyna się od powitania ciągu:

startsWith('hello world', 'greeting')

Zwraca wynik false.

string

Zwraca wersję ciągu wartości w opcjonalnym formacie ustawień regionalnych.

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

Parametr	Wymagania	Type	Opis
<wartość>	Tak	dowolny	Wartość do konwersji
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<ciąg-wartość>	string	Wersja ciągu określonej wartości

Przykład 1

W tym przykładzie jest tworzona wersja ciągu numeru 10:

string(10)

Zwraca wynik ciągu 10.

Przykład 2

W tym przykładzie jest tworzony ciąg dla określonego obiektu JSON i używa znaku\\ ukośnika odwrotnego, jako znaku ucieczki dla znaku podwójnego cudzysłowu ".

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

Zwraca wynik { "name": "Sophie Owen" }

Przykład 3

W tym przykładzie zostanie utworzona wersja ciągu numeru 10 w określonych ustawieniach regionalnych:

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

I zwraca odpowiednio następujące ciągi:

• 100,1
• 100.1

stringOrValue

Zawijanie interpolacji ciągów w celu uzyskania rzeczywistej wartości. Na przykład stringOrValue('${1}') zwraca liczbę 1, a funkcja stringOrValue('${1} item') zwraca ciąg "1 element".

stringOrValue(<string>)

Parametr	Wymagania	Type	opis
<string>	Tak	string	Ciąg umożliwiający uzyskanie rzeczywistej wartości.

Wartość zwracana	Type	opis
<wynik>	dowolny	Wynik uzyskania rzeczywistej wartości określonego ciągu.

Przykłady

Te przykłady pobierają rzeczywistą wartość z ciągu:

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

I zwróć odpowiednio następujące wyniki:

• Liczba 1.0.
• Ciąg 1.

sub

Zwróć wynik odejmowania drugiej liczby z pierwszej liczby.

sub(<minuend>, <subtrahend>)

Parametr	Wymagania	Type	Opis
<minuend>	Tak	Liczba	Liczba, z której należy odjąć odejmowanie odejmowania
<odjemnik>	Tak	Liczba	Liczba do odejmowania od minuend

Wartość zwracana	Type	opis
<wynik>	Liczba	Wynik odejmowania drugiej liczby z pierwszej liczby

Przykład

W tym przykładzie odejmuje drugą liczbę z pierwszej liczby:

sub(10.3, .3)

Zwraca wynik 10.

subArray

Zwraca podarraj z określonych pozycji początkowych i końcowych. Wartości indeksu zaczynają się od liczby 0.

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

Parametr	Wymagania	Type	Opis
<tablica>	Tak	tablica	Tablica do utworzenia podarray na podstawie
<startIndex>	Tak	integer	Liczba dodatnia równa lub większa niż 0 do użycia jako pozycja początkowa lub wartość indeksu
<endIndex>	Tak	integer	Liczba dodatnia równa lub większa niż 0 do użycia jako końcowa pozycja lub wartość indeksu

Wartość zwracana	Type	Opis
<subarray-result>	tablica	Podarraj z określoną liczbą elementów, zaczynając od określonej pozycji indeksu w ciągu źródłowym

Przykład

W tym przykładzie zostanie utworzona podarraj z określonej tablicy:

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

Zwraca wynik ["l", "l", "o"].

Podciąg

Zwraca znaki z ciągu, zaczynając od określonej pozycji lub indeksu. Wartości indeksu zaczynają się od liczby 0.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	string	Ciąg do utworzenia podciągu na podstawie
<startIndex>	Tak	integer	Liczba dodatnia równa lub większa niż 0 podarray do użycia jako wartość pozycji początkowej lub indeksu
<length>	Tak	integer	Dodatnia liczba znaków podrzędnych w podciągu

Wartość zwracana	Type	Opis
<wynik podciągów>	string	Podciąg o określonej liczbie znaków rozpoczynający się od określonej pozycji indeksu w ciągu źródłowym

Przykład

W tym przykładzie utworzono podciąg z pięciu znaków z określonego ciągu, zaczynając od wartości indeksu 6:

substring('hello world', 6, 5)

I zwraca świat wyników.

odejmowanieFromTime

Odejmij liczbę jednostek czasu ze znacznika czasu w opcjonalnym formacie ustawień regionalnych. Zobacz również getPastTime().

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu
<interval>	Tak	integer	Liczba określonych jednostek czasu do odejmowania
<timeUnit>	Tak	string	Jednostka czasu do użycia z interwałem. Możliwe jednostki to "Second", "Minute", "Hour", "Day", "Week", "Month" i "Year".
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<sygnatura czasowa aktualizacji>	string	Sygnatura czasowa minus określona liczba jednostek czasu

Przykład 1

W tym przykładzie odejmuje jeden dzień od następującego znacznika czasu:

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

Zwraca wynik 2018-01-01T00:00:00.000Z.

Przykład 2

W tym przykładzie odejmuje jeden dzień od znacznika czasu przy użyciu formatu D :

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

Zwraca wynik poniedziałek, styczeń, 1, 2018.

Przykład 3

W tym przykładzie odejmuje 1 godzinę od znacznika czasu w ustawieniach regionalnych de-DE :

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

Zwraca wynik 15.03.18 12:00:00.

Suma

Zwróć wynik z dodawania liczb na liście.

sum([<list of numbers>])

Parametr	Wymagania	Type	Opis
[<lista liczb>]	Tak	tablica liczb	Liczby do dodania

Wartość zwracana	Type	Opis
<wynik-suma>	Liczba	Wynik dodawania określonych liczb

Przykład

W tym przykładzie dodano określone liczby:

sum(createArray(1, 1.5))

Zwraca wynik 2,5.

take

Zwracanie elementów z przodu kolekcji.

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

Parametr	Wymagania	Type	Opis
<kolekcja>	Tak	ciąg lub tablica	Kolekcja, której elementy chcesz
<count>	Tak	integer	Dodatnia liczba całkowita dla liczby elementów, które mają być od przodu

Wartość zwracana	Type	Opis
<podzestaw lub [<podzestaw>>]	Ciąg lub tablica, odpowiednio	Ciąg lub tablica zawierająca określoną liczbę elementów pobranych z przodu oryginalnej kolekcji

Przykład

Te przykłady pobierają określoną liczbę elementów z przodu tych kolekcji:

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

I zwróć odpowiednio następujące wyniki:

• abecadło
• [0, 1, 2]

Kleszcze

Zwraca wartość właściwości znacznika czasu. Tyka to 100-nanosekundowy interwał.

ticks('<timestamp>')

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg znacznika czasu

Wartość zwracana	Type	Opis
<ticks-number>	liczba całkowita (bigint w języku JavaScript)	Liczba znaczników od określonego znacznika czasu

Przykład

W tym przykładzie znacznik czasu jest konwertowany na właściwość znaczników czasu:

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

Zwraca wynik 636503904000000000.

ticksToDays

Przekonwertuj wartość właściwości znacznika na liczbę dni.

ticksToDays('ticks')

Parametr	Wymagania	Type	Opis
<Kleszcze>	Tak	integer	Wartość właściwości ticks do konwersji

Wartość zwracana	Type	Opis
<liczba dni>	Liczba	Liczba dni przekonwertowanych z wartości właściwości ticks

Przykład

W tym przykładzie wartość właściwości ticks jest konwertowana na liczbę dni:

ticksToDays(2193385800000000)

Zwraca liczbę 2538.64097222.

ticksToHours

Przekonwertuj wartość właściwości znacznika na liczbę godzin.

ticksToHours('ticks')

Parametr	Wymagania	Type	Opis
<Kleszcze>	Tak	Integer	Wartość właściwości ticks do konwersji

Wartość zwracana	Type	Opis
<liczba godzin>	Liczba	Liczba godzin przekonwertowanych z wartości właściwości ticks

Przykład

W tym przykładzie wartość właściwości ticks jest konwertowana na liczbę godzin:

ticksToHours(2193385800000000)

Zwraca liczbę 60927.3833333333333331.

ticksToMinutes

Przekonwertuj wartość właściwości znacznika na liczbę minut.

ticksToMinutes('ticks')

Parametr	Wymagania	Type	Opis
<Kleszcze>	Tak	integer	Wartość właściwości ticks do konwersji

Wartość zwracana	Type	Opis
<liczba minut>	Liczba	Liczba minut przekonwertowanych z wartości właściwości ticks

Przykład

W tym przykładzie wartość właściwości ticks jest konwertowana na liczbę minut:

ticksToMinutes(2193385800000000)

Zwraca liczbę 3655643.0185.

titleCase

Wielką literą każdego wyrazu w ciągu w opcjonalnym formacie lokalnym.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	string	Oryginalny ciąg
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
ciąg wyniku	string	Wynik przypadku tytułu

Przykład 1

W poniższych przykładach wielką literą każdego wyrazu w ciągu jest wielką literą:

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

I zwróć odpowiednio następujące wyniki:

• A
• Abc Def
• Abc Def

Przykład 2

Te przykłady wielką literą w ciągu w formacie en-US :

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

I zwróć odpowiednio następujące wyniki:

• A
• Abc Def

toLower

Zwraca ciąg w małych literach w opcjonalnym formacie ustawień regionalnych. Jeśli znak w ciągu nie ma małej litery, ten znak pozostaje niezmieniony w zwracanym ciągu.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	string	Ciąg, który ma być zwracany w formacie małych liter
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<małe litery i tekst>	string	Oryginalny ciąg w formacie małych liter

Przykład 1

W tym przykładzie ciąg jest konwertowany na małe litery:

toLower('Hello World')

I zwraca wynik hello world.

Przykład 2

W tym przykładzie ciąg jest konwertowany na małe litery w formacie fr-FR :

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

I zwraca wynik hello world.

toUpper

Zwraca ciąg w wielkich literach w opcjonalnym formacie ustawień regionalnych. Jeśli znak w ciągu nie ma wielkiej litery, ten znak pozostaje niezmieniony w zwracanym ciągu.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	string	Ciąg, który ma być zwracany w formacie wielkiej litery
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<wielkie litery — tekst>	string	Oryginalny ciąg w formacie wielkiej litery

Przykład 1

W tym przykładzie ciąg jest konwertowany na wielkie litery:

toUpper('Hello World')

Zwraca wynik HELLO WORLD.

Przykład 2

W tym przykładzie ciąg jest konwertowany na wielkie litery w formacie fr-FR :

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

Zwraca wynik HELLO WORLD.

przycinać

Usuń białe znaki wiodące i końcowe z ciągu i zwróć zaktualizowany ciąg.

trim('<text>')

Parametr	Wymagania	Type	Opis
<text>	Tak	string	Ciąg zawierający biały znak wiodący i końcowy do usunięcia

Wartość zwracana	Type	Opis
<updatedText>	string	Zaktualizowana wersja oryginalnego ciągu bez wiodącego lub końcowego odstępu

Przykład

W tym przykładzie usunięto wiodące i końcowe białe znaki z ciągu "Hello World":

trim(' Hello World  ')

Zwraca przycięty wynik Hello World.

unia

Zwróć kolekcję zawierającą wszystkie elementy z określonych kolekcji. Aby wyświetlić wynik, element może pojawić się w dowolnej kolekcji przekazanej do tej funkcji. Jeśli co najmniej jeden element ma taką samą nazwę, w wyniku pojawi się ostatni element o tej nazwie.

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

Parametr	Wymagania	Type	Opis
<kolekcja1>, <kolekcja2>, ...	Tak	tablica lub obiekt, ale nie oba	Kolekcje, z których mają być potrzebne wszystkie elementy

Wartość zwracana	Type	Opis
<updatedCollection>	tablica lub obiekt, odpowiednio	Kolekcja ze wszystkimi elementami z określonych kolekcji. Nie dodano duplikatów.

Przykład

Ten przykład pobiera wszystkie elementy z następujących kolekcji:

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

Zwraca wynik [1, 2, 3, 10, 101].

unique

Usuń wszystkie duplikaty z tablicy.

unique([<collection>])

Parametr	Wymagania	Type	Opis
<kolekcja>	Tak	tablica	Kolekcja do zmodyfikowania

Wartość zwracana	Type	Opis
<nowa kolekcja>	tablica	Nowa kolekcja z usuniętymi zduplikowanymi elementami

Przykład 1

W tym przykładzie usunięto zduplikowane elementy z następującej tablicy:

unique(createArray(1, 2, 1))

Zwraca wynik [1, 2].

uriComponent

Zwróć wersję binarną składnika identyfikatora zasobów (URI).

uriComponent('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	string	Ciąg do konwersji na format zakodowany w formacie URI

Wartość zwracana	Type	Opis
<identyfikator URI zakodowany>	string	Ciąg zakodowany w formacie URI z znakami ucieczki

Przykład

W tym przykładzie zostanie utworzona zakodowana identyfikator URI wersja ciągu:

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

I zwraca wynik http%3A%2F%2Fcontoso.com.

uriComponentToString

Zwróć wersję ciągu zakodowanego w ciągu identyfikatora URI (URI), co skutecznie dekoduje ciąg zakodowany w identyfikatorze URI.

uriComponentToString('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	string	Ciąg zakodowany za pomocą identyfikatora URI do dekodowania

Wartość zwracana	Type	Opis
<binary-for-encoded-uri>	string	Zdekodowana wersja ciągu zakodowanego za pomocą identyfikatora URI

Przykład

W tym przykładzie tworzona jest zdekodowana wersja ciągu zakodowanego za pomocą identyfikatora URI:

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

Zwraca wynik https://contoso.com.

uriHost

Zwraca wartość hosta ujednoliconego identyfikatora zasobu (URI).

uriHost('<uri>')

Parametr	Wymagania	Type	Opis
<Uri>	Tak	string	Identyfikator URI, którego wartość hosta chcesz

Wartość zwracana	Type	Opis
<wartość hosta>	string	Wartość hosta określonego identyfikatora URI

Przykład

W tym przykładzie znajduje się wartość hosta następującego identyfikatora URI:

uriHost('https://www.localhost.com:8080')

Zwraca wynik www.localhost.com.

uriPath

Zwraca wartość ścieżki ujednoliconego identyfikatora zasobu (URI).

uriPath('<uri>')

Parametr	Wymagania	Type	Opis
<Uri>	Tak	string	Identyfikator URI, którego wartość ścieżki chcesz

Wartość zwracana	Type	Opis
<path-value>	string	Wartość ścieżki określonego identyfikatora URI

Przykład

W tym przykładzie znajduje wartość ścieżki następującego identyfikatora URI:

uriPath('http://www.contoso.com/catalog/shownew.htm?date=today')

I zwraca wynik /catalog/shownew.htm.

uriPathAndQuery

Zwróć ścieżkę i wartość zapytania ujednoliconego identyfikatora zasobu (URI).

uriPathAndQuery('<uri>')

Parametr	Wymagania	Type	Opis
<Uri>	Tak	string	Identyfikator URI, którego ścieżka i wartość zapytania chcesz

Wartość zwracana	Type	Opis
<path-query-value>	string	Ścieżka i wartość zapytania określonego identyfikatora URI

Przykład

W tym przykładzie znajduje wartość ścieżki i zapytania następującego identyfikatora URI:

uriPathAndQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Zwraca wynik /catalog/shownew.htm?date=today.

uriPort

Zwraca wartość portu ujednoliconego identyfikatora zasobu (URI).

uriPort('<uri>')

Parametr	Wymagania	Type	Opis
<Uri>	Tak	string	Identyfikator URI, którego wartość ścieżki chcesz

Wartość zwracana	Type	Opis
<port-wartość>	string	Wartość portu określonego identyfikatora URI

Przykład

W tym przykładzie znajduje się wartość portu następującego identyfikatora URI:

uriPort('http://www.localhost:8080')

Zwraca wynik 8080.

uriQuery

Zwraca wartość zapytania ujednoliconego identyfikatora zasobu (URI).

uriQuery('<uri>')

Parametr	Wymagania	Type	Opis
<Uri>	Tak	string	Identyfikator URI, którego wartość kwerendy chcesz

Wartość zwracana	Type	Opis
<query-value>	string	Wartość zapytania określonego identyfikatora URI

Przykład

W tym przykładzie znajduje wartość zapytania następującego identyfikatora URI:

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

I zwraca wynik ?date=today.

uriScheme

Zwraca wartość schematu ujednoliconego identyfikatora zasobu (URI).

uriScheme('<uri>')

Parametr	Wymagania	Type	Opis
<Uri>	Tak	string	Identyfikator URI, którego wartość kwerendy chcesz

Wartość zwracana	Type	Opis
<scheme-value>	string	Wartość schematu określonego identyfikatora URI

Przykład

W tym przykładzie znajduje wartość schematu następującego identyfikatora URI:

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Zwraca wynik http.

utcNow

Zwraca bieżący znacznik czasu w opcjonalnym formacie ustawień regionalnych jako ciąg.

utcNow('<format>', '<locale>'?)

Opcjonalnie możesz określić inny format za pomocą parametru <formatu> .

Parametr	Wymagania	Type	Opis
<format>	Nie.	string	Wzorzec formatu niestandardowego. Domyślny format znacznika czasu to format ISO UTC RRRR-MM-DDTHH:mm:ss.fffZ, który jest zgodny z normą ISO 8601.
<ustawienia regionalne>	Nie.	string	Opcjonalne ustawienia regionalne informacji o kulturze

Wartość zwracana	Type	Opis
<znacznik czasu bieżącego>	string	Bieżąca data i godzina

Przykład 1

Załóżmy, że data to 15 kwietnia 2018 r. o 13:00:00. W tym przykładzie jest pobierana sygnatura czasowa:

utcNow()

Zwraca wynik 2018-04-15T13:00:00.000Z.

Przykład 2

Załóżmy, że data to 15 kwietnia 2018 r. o 13:00:00. W tym przykładzie jest pobierany bieżący znacznik czasu przy użyciu opcjonalnego formatu D :

utcNow('D')

Zwraca wynik niedziela, 15 kwietnia 2018 r.

Przykład 3

Załóżmy, że data to 15 kwietnia 2018 r. o 13:00:00. W tym przykładzie jest pobierany bieżący znacznik czasu przy użyciu ustawień regionalnych de-DE :

utcNow('', 'de-DE')

Zwraca wynik 15.04.18 13:00:00.

where

Odfiltruj każdy element i zwróć nową kolekcję filtrowanych elementów, które pasują do określonego warunku.

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

Parametr	Wymagania	Type	Opis
<kolekcja/wystąpienie>	Tak	tablica	Kolekcja z elementami
<iteratorName>	Tak	nazwa iteratora	Element klucza
<funkcja>	Tak	wyrażenie	Funkcja condition używana do filtrowania elementów

Wartość zwracana	Type	Opis
<new-collection/new-object>	tablica/obiekt	Nowa kolekcja, którą każdy element został przefiltrowany za pomocą funkcji

Przykład 1

W tym przykładzie jest generowana nowa kolekcja:

where(createArray(0, 1, 2, 3), x, x > 1)

Zwraca wynik [2, 3].

Przykład 2

Te przykłady generują nową kolekcję:

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

I zwróć wynik ['name:jack', 'age:15']. Zwróć uwagę, że drugie wyrażenie jest wyrażeniem lambda, które jest bardziej czytelne.

xml

Zwróć wersję XML ciągu zawierającego obiekt JSON.

xml('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	string	Ciąg z obiektem JSON do konwersji. Obiekt JSON musi mieć tylko jedną właściwość główną, która nie może być tablicą. Użyj \ jako znaku ucieczki dla podwójnego cudzysłowu (").

Wartość zwracana	Type	Opis
<wersja xml>	obiekt	Zakodowany kod XML dla określonego ciągu lub obiektu JSON

Przykład 1

W tym przykładzie tworzona jest wersja XML dla ciągu zawierającego obiekt JSON:

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

I zwraca wynik XML:

<name>Sophia Owen</name>

Przykład 2

Załóżmy, że masz person obiekt JSON widoczny poniżej:

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

W tym przykładzie tworzony jest kod XML ciągu zawierającego ten obiekt JSON:

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

I zwraca wynik XML:

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

xPath

Sprawdź kod XML dla węzłów lub wartości, które są zgodne z wyrażeniem XPath (XML Path Language) i zwraca pasujące węzły lub wartości. Wyrażenie XPath (nazywane XPath) ułatwia nawigowanie po strukturze dokumentu XML, dzięki czemu można wybrać węzły lub wartości obliczeniowe w zawartości XML.

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

Parametr	Wymagania	Type	Opis
<xml>	Tak	dowolny	Ciąg XML do wyszukiwania węzłów lub wartości pasujących do wartości wyrażenia XPath
<xPath>	Tak	dowolny	Wyrażenie XPath używane do znajdowania pasujących węzłów XML lub wartości

Wartość zwracana	Type	Opis
<xml-node>	XML	Węzeł XML, gdy tylko jeden węzeł jest zgodny z określonym wyrażeniem XPath
<wartość>	dowolny	Wartość z węzła XML, gdy tylko jedna wartość jest zgodna z określonym wyrażeniem XPath
<[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]>	tablica	Tablica z węzłami XML lub wartościami zgodnymi z określonym wyrażeniem XPath

Przykład 1

W tym przykładzie znajdują węzły pasujące do węzła <name></name> w określonych argumentach i zwracają tablicę z tymi wartościami węzłów:

xPath(items, '/produce/item/name')

Argumenty obejmują ciąg elementów , który zawiera następujący kod XML:

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

Oto wynikowa tablica z węzłami, które pasują do <name></name>elementu :

[ <name>Gala</name>, <name>Honeycrisp</name> ]

Przykład 2

Poniższy przykład 1 zawiera węzły zgodne z węzłem <count></count> i dodaje te wartości węzłów za pomocą funkcji sum():

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

Zwraca wynik 30.

rocznie

Zwraca rok określonego znacznika czasu.

year('<timestamp>')

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	string	Ciąg zawierający znacznik czasu

Wartość zwracana	Type	Opis
<rok>	integer	Rok w określonym znaczniku czasu

Przykład

W tym przykładzie jest obliczany znacznik czasu dla roku:

year('2018-03-15T00:00:00.000Z')

I zwraca wynik 2018.