Wyrażenia i funkcje w usługach Azure Data Factory i Azure Synapse Analytics

Artykuł
05/17/2024

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

Ten artykuł zawiera szczegółowe informacje o wyrażeniach i funkcjach obsługiwanych przez usługę Azure Data Factory i usługę Azure Synapse Analytics.

Wyrażenia

Wartości JSON w definicji mogą być literałami lub wyrażeniami, które są oceniane w czasie wykonywania. Na przykład:

"name": "value"

lub

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

Wyrażenia mogą być wyświetlane w dowolnym miejscu w wartości ciągu JSON i zawsze powodować inną wartość JSON. Jeśli wartość JSON jest wyrażeniem, treść wyrażenia jest wyodrębniona przez usunięcie znaku at-sign (@). Jeśli potrzebny jest ciąg literału rozpoczynający się od @, należy go użyć przy użyciu @@. W poniższych przykładach pokazano, jak są oceniane wyrażenia.

Wartość JSON	Result
"parameters" (parametry)	Zwracane są znaki "parameters".
"parameters[1]"	Zwracane są znaki "parameters[1]".
"@@"	Zwracany jest 1 ciąg znaków zawierający znak "@".
" @"	Zwracany jest 2-znakowy ciąg zawierający znak @.

Wyrażenia mogą również pojawiać się wewnątrz ciągów przy użyciu funkcji nazywanej interpolacją ciągów, w której wyrażenia są opakowane w @{ ... }. Na przykład: "name" : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}".

Przy użyciu interpolacji ciągów wynik jest zawsze ciągiem. Załóżmy, że zdefiniowałem myNumber jako i myString jako 42 foo:

Wartość JSON	Result
"@pipeline().parameters.myString"	Zwraca `foo` jako ciąg.
"@{pipeline().parameters.myString}"	Zwraca `foo` jako ciąg.
"@pipeline().parameters.myNumber"	Zwraca `42` jako liczbę.
"@{pipeline().parameters.myNumber}"	Zwraca `42` jako ciąg.
"Odpowiedź brzmi: @{pipeline().parameters.myNumber}"	Zwraca ciąg `Answer is: 42`.
"@concat('Odpowiedź brzmi: ', string(pipeline().parameters.myNumber))"	Zwraca ciąg `Answer is: 42`
"Odpowiedź brzmi: @@{pipeline().parameters.myNumber}"	Zwraca ciąg `Answer is: @{pipeline().parameters.myNumber}`.

W działaniach przepływu sterowania, takich jak działanie ForEach, można podać tablicę do iteracji dla elementów właściwości i użyć @item() do iteracji w ramach pojedynczego wyliczenia w działaniu ForEach. Jeśli na przykład elementy są tablicą: [1, 2, 3], @item() zwraca wartość 1 w pierwszej iteracji, 2 w drugiej iteracji i 3 w trzeciej iteracji. Możesz również użyć @range(0,10) wyrażenia like do iterowania dziesięć razy, zaczynając od 0 kończącego się na 9.

Możesz użyć @activity("nazwy działania"), aby przechwycić dane wyjściowe działania i podejmować decyzje. Rozważ działanie internetowe o nazwie Web1. W przypadku umieszczenia danych wyjściowych pierwszego działania w treści drugiego wyrażenie zwykle wygląda następująco: @activity("Web1"). output lub @activity("Web1"). output.data lub coś podobnego w zależności od tego, jak wygląda dane wyjściowe pierwszego działania.

Przykłady

Przykład wyrażenia złożonego

Poniższy przykład przedstawia złożony przykład, który odwołuje się do głębokiego pola podrzędnego danych wyjściowych działań. Aby odwołać się do parametru potoku, który oblicza pole podrzędne, użyj składni [] zamiast operatora dot(.) (tak jak w przypadku pola subfield1 i subfield2), w ramach danych wyjściowych działania.

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

Dynamiczne tworzenie plików i nazewnictwo ich jest typowym wzorcem. Przyjrzyjmy się kilku dynamicznym przykładom nazewnictwa plików.

Dołącz datę do nazwy pliku: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
Dołącz wartość DateTime w strefie czasowej klienta: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
Czas wyzwalacza dołączania: @concat('Test_', pipeline().TriggerTime)
Wyprowadź niestandardową nazwę pliku w Przepływ danych mapowania podczas wyprowadzania do pojedynczego pliku z datą :'Test_' + toString(currentDate()) + '.csv'

W powyższych przypadkach tworzone są 4 dynamiczne nazwy plików, począwszy od Test_.

Edytor zawartości dynamicznej

Edytor zawartości dynamicznej automatycznie usuwa znaki w zawartości po zakończeniu edycji. Na przykład następująca zawartość w edytorze zawartości to interpolacja ciągów z dwiema funkcjami wyrażeń.

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

Dynamiczny edytor zawartości konwertuje powyższą zawartość na wyrażenie "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}". Wynikiem tego wyrażenia jest ciąg formatu JSON pokazany poniżej.

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

Zestaw danych z parametrem

W poniższym przykładzie zestaw blobDataset przyjmuje parametr o nazwie path. Jego wartość służy do ustawiania wartości dla właściwości folderPath przy użyciu wyrażenia: dataset().path.

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

Potok z parametrem

W poniższym przykładzie potok przyjmuje parametry inputPath i outputPath . Ścieżka sparametryzowanego zestawu danych obiektów blob jest ustawiana przy użyciu wartości tych parametrów. Składnia używana tutaj to: pipeline().parameters.parametername.

{
    "name": "Adfv2QuickStartPipeline",
    "properties": {
        "activities": [
            {
                "name": "CopyFromBlobToBlob",
                "type": "Copy",
                "inputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.inputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "outputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.outputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "typeProperties": {
                    "source": {
                        "type": "BlobSource"
                    },
                    "sink": {
                        "type": "BlobSink"
                    }
                }
            }
        ],
        "parameters": {
            "inputPath": {
                "type": "String"
            },
            "outputPath": {
                "type": "String"
            }
        }
    }
}

Zastępowanie znaków specjalnych

Edytor zawartości dynamicznej automatycznie usuwa znaki, takie jak podwójny cudzysłów, ukośnik odwrotny w zawartości po zakończeniu edycji. Powoduje to problem, jeśli chcesz zamienić źródło danych wiersza lub kartę przy użyciu \n, \t w funkcji replace(). Możesz edytować zawartość dynamiczną w widoku kodu, aby usunąć dodatkowy \ w wyrażeniu, lub wykonać poniższe kroki, aby zastąpić znaki specjalne przy użyciu języka wyrażeń:

Kodowanie adresu URL względem oryginalnej wartości ciągu
Zastąp ciąg zakodowany w adresie URL, na przykład źródło danych wiersza (%0A), powrót karetki (%0D), kartę poziomą (%09).
Dekodowanie adresów URL

Na przykład zmienna companyName z nowym znakiem wiersza w jego wartości, wyrażenie @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) może usunąć znak nowego wiersza.

Contoso-
Corporation

Ucieczka znaku pojedynczego cudzysłowu

Funkcje wyrażeń w potokach używają pojedynczego cudzysłowu ('), aby otaczać parametry wartości ciągu. Użyj dwóch kolejnych znaków pojedynczego cudzysłowu w wyrażeniu ciągu potoku, aby uwzględnić pojedynczy cudzysłów. Oto przykład: wyrażenie @concat('Here is a double quote character: ". ', 'And here is a single quote character all within the same string: ''.') zwróci następujący wynik:

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

Jednak w wyrażeniach przepływu danych ta składnia nie jest obsługiwana. Zamiast tego wyrażenia przepływu danych mogą być otoczone pojedynczymi lub podwójnymi cudzysłowymi. Otaczaj tekst wymagający pojedynczych cudzysłowów w cudzysłowach i tekst wymagający podwójnego cudzysłowu w ramach pojedynczych cudzysłowów w funkcjach ciągu. Jeśli potrzebujesz ciągu zawierającego zarówno cudzysłów pojedynczy, jak i podwójny, możesz użyć concat() do scalenia dwóch podciągów, które zawierają pojedyncze cudzysłowy lub cudzysłowy podwójne. Przepływ danych odpowiadający poprzedniemu przykładowi wyrażenia potoku to concat('Here is a double quote character: ". ', "And here is a single quote character all within the same string: '."). W przepływie danych wyrażenie zwróci ten sam wynik co w poprzednim przykładzie dla wyrażeń potoku.

Samouczek

W tym samouczku przedstawiono sposób przekazywania parametrów między potokiem i działaniem, a także między działaniami. W tym samouczku przedstawiono kroki dla usługi Azure Data Factory, chociaż kroki dla obszaru roboczego usługi Synapse są prawie równoważne, ale z nieco innym interfejsem użytkownika.

Funkcje

Funkcje można wywoływać w wyrażeniach. Poniższe sekcje zawierają informacje o funkcjach, które mogą być używane w wyrażeniu.

Funkcje daty

Funkcja daty lub godziny	Zadanie
addDays	Dodaj liczbę dni do znacznika czasu.
addHours	Dodaj liczbę godzin do znacznika czasu.
addMinutes	Dodaj liczbę minut do znacznika czasu.
addSeconds	Dodaj liczbę sekund do znacznika czasu.
addToTime	Dodaj liczbę jednostek czasu do znacznika czasu. Zobacz również getFutureTime.
convertFromUtc	Przekonwertuj znacznik czasu z uniwersalnego czasu koordynowanego (UTC) na docelową strefę czasową.
convertTimeZone	Przekonwertuj znacznik czasu ze źródłowej strefy czasowej na docelową strefę czasową.
convertToUtc	Przekonwertuj znacznik czasu ze źródłowej strefy czasowej na uniwersalny czas koordynowany (UTC).
dayOfMonth	Zwróć dzień składnika miesiąca ze znacznika czasu.
dayOfWeek	Zwróć dzień składnika tygodnia ze znacznika czasu.
dayOfYear	Zwraca dzień składnika roku ze znacznika czasu.
formatDateTime	Zwróć znacznik czasu jako ciąg w formacie opcjonalnym.
getFutureTime	Zwróć bieżący znacznik czasu oraz określoną liczbę jednostek czasu. Zobacz również addToTime.
getPastTime	Zwróć bieżący znacznik czasu minus określoną liczbę jednostek czasu. Zobacz również odejmowanieFromTime.
startOfDay	Zwróć początek dnia dla znacznika czasu.
startOfHour	Zwróć początek godziny dla znacznika czasu.
startOfMonth	Zwróć początek miesiąca dla znacznika czasu.
odejmowanieFromTime	Odejmij liczbę jednostek czasu z znacznika czasu. Zobacz również getPastTime.
Kleszcze	`ticks` Zwraca wartość właściwości dla określonego znacznika czasu.
utcNow	Zwraca bieżący znacznik czasu jako ciąg.

Funkcje ciągów

Aby pracować z ciągami, możesz użyć tych funkcji ciągów, a także niektórych funkcji kolekcji. Funkcje ciągów działają tylko na ciągach.

Funkcja ciągu	Zadanie
concat	Połącz co najmniej dwa ciągi i zwróć połączony ciąg.
endsWith	Sprawdź, czy ciąg kończy się określonym podciągem.
guid	Wygeneruj unikatowy identyfikator globalny (GUID) jako ciąg.
indexOf	Zwróć pozycję początkową dla podciągów.
lastIndexOf	Zwróć pozycję początkową ostatniego wystąpienia podciągów.
replace	Zastąp podciąg określonym ciągiem i zwróć zaktualizowany ciąg.
split	Podziel ciąg na każde wystąpienie określonego ogranicznika, zwracając wynikowe podciągi jako elementy tablicy.
startsWith	Sprawdź, czy ciąg rozpoczyna się od określonego podciągu.
Podciąg	Zwraca znaki z ciągu, zaczynając od określonej pozycji.
toLower	Zwraca ciąg w formacie małych liter.
toUpper	Zwraca ciąg w formacie wielkiej litery.
przycinać	Usuń białe znaki wiodące i końcowe z ciągu i zwróć zaktualizowany ciąg.

Funkcje odbioru

Aby pracować z kolekcjami, zazwyczaj tablicami, ciągami, a czasami słownikami, można użyć tych funkcji kolekcji.

Funkcja Collection	Zadanie
Contains	Sprawdź, czy kolekcja ma określony element.
empty	Sprawdź, czy kolekcja jest pusta.
pierwszy	Zwróć pierwszy element z kolekcji.
skrzyżowanie	Zwróć kolekcję zawierającą tylko wspólne elementy w określonych kolekcjach.
join	Zwróć ciąg zawierający wszystkie elementy z tablicy oddzielone określonym znakiem.
ostatni	Zwróć ostatni element z kolekcji.
length	Zwraca liczbę elementów w ciągu lub tablicy.
pominąć	Usuń elementy z przodu kolekcji i zwróć wszystkie inne elementy.
brać	Zwracanie elementów z przodu kolekcji.
unia	Zwróć kolekcję zawierającą wszystkie elementy z określonych kolekcji.

Funkcje logiczne

Te funkcje są przydatne wewnątrz warunków, mogą służyć do oceny dowolnego typu logiki.

Funkcja porównania logicznego	Zadanie
and	Sprawdź, czy wszystkie wyrażenia są prawdziwe.
equals	Sprawdź, czy obie wartości są równoważne.
greater	Sprawdź, czy pierwsza wartość jest większa niż druga wartość.
greaterOrEquals	Sprawdź, czy pierwsza wartość jest większa, czy równa drugiej wartości.
jeśli	Sprawdź, czy wyrażenie ma wartość true, czy false. Na podstawie wyniku zwróć określoną wartość.
less	Sprawdź, czy pierwsza wartość jest mniejsza niż druga wartość.
lessOrEquals	Sprawdź, czy pierwsza wartość jest mniejsza, czy równa drugiej wartości.
nie	Sprawdź, czy wyrażenie jest fałszywe.
or	Sprawdź, czy co najmniej jedno wyrażenie ma wartość true.

Funkcje konwersji

Te funkcje są używane do konwertowania między poszczególnymi typami natywnymi w języku:

string
integer
liczba zmiennoprzecinkowa
boolean
Tablice
Słowniki

Funkcja konwersji	Zadanie
tablica	Zwraca tablicę z jednego określonego danych wejściowych. Aby uzyskać wiele danych wejściowych, zobacz createArray.
base64	Zwróć wersję zakodowaną w formacie base64 dla ciągu.
base64ToBinary	Zwróć wersję binarną dla ciągu zakodowanego w formacie base64.
base64ToString	Zwraca wersję ciągu dla ciągu zakodowanego w formacie base64.
dwójkowy	Zwraca wersję binarną dla wartości wejściowej.
bool	Zwróć wersję logiczną dla wartości wejściowej.
Łączonej	Zwraca pierwszą wartość inną niż null z co najmniej jednego parametru.
createArray	Zwraca tablicę z wielu danych wejściowych.
dataUri	Zwraca identyfikator URI danych dla wartości wejściowej.
dataUriToBinary	Zwróć wersję binarną identyfikatora URI danych.
dataUriToString	Zwróć wersję ciągu dla identyfikatora URI danych.
dekodujBase64	Zwraca wersję ciągu dla ciągu zakodowanego w formacie base64.
decodeDataUri	Zwróć wersję binarną identyfikatora URI danych.
decodeUriComponent	Zwraca ciąg, który zastępuje znaki ucieczki dekodowanym wersjami.
encodeUriComponent	Zwróć ciąg, który zastępuje znaki niebezpieczne adresu URL znakami ucieczki.
float	Zwraca liczbę zmiennoprzecinkową dla wartości wejściowej.
int	Zwróć wersję całkowitą dla ciągu.
JSON	Zwróć wartość typu JavaScript Object Notation (JSON) lub obiekt dla ciągu lub XML.
string	Zwraca wersję ciągu dla wartości wejściowej.
uriComponent	Zwróć wersję zakodowaną w formacie URI dla wartości wejściowej, zastępując znaki niebezpieczne adresu URL znakami ucieczki.
uriComponentToBinary	Zwróć wersję binarną dla ciągu zakodowanego identyfikatorem URI.
uriComponentToString	Zwróć wersję ciągu dla ciągu zakodowanego identyfikatorem URI.
xml	Zwróć wersję XML dla ciągu.
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.

Funkcje matematyczne

Te funkcje mogą być używane w przypadku obu typów liczb: liczb całkowitych i zmiennoprzecinkowych.

Math, funkcja	Zadanie
add	Zwróć wynik z dodania dwóch liczb.
div	Zwróć wynik z dzielenia jednej liczby przez inną liczbę.
Max	Zwraca najwyższą wartość z zestawu liczb lub tablicy.
Min	Zwraca najniższą wartość z zestawu liczb lub tablicy.
mod	Zwróć resztę z dzielenia jednej liczby przez inną liczbę.
mul	Zwróć produkt z mnożenia dwóch liczb.
rand	Zwraca losową liczbę całkowitą z określonego zakresu.
range	Zwraca tablicę całkowitą rozpoczynającą się od określonej liczby całkowitej.
Sub	Zwróć wynik odejmowania jednej liczby z innej liczby.

Dokumentacja funkcji

W tej sekcji wymieniono wszystkie dostępne funkcje w kolejności alfabetycznej.

add

Zwróć wynik z dodania dwóch liczb.

add(<summand_1>, <summand_2>)

Parametr	Wymagania	Type	Opis
<>summand_1, <summand_2>	Tak	Liczba całkowita, zmiennoprzecinkowa lub mieszana	Liczby do dodania

Wartość zwracana	Type	Opis
<wynik-suma>	Liczba całkowita lub zmiennoprzecinkowa	Wynik dodawania określonych liczb

Przykład

W tym przykładzie dodano określone liczby:

add(1, 1.5)

I zwraca ten wynik: 2.5

addDays

Dodaj liczbę dni do znacznika czasu.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	String	Ciąg zawierający znacznik czasu
<Dni>	Tak	Integer	Dodatnia lub ujemna liczba dni do dodania
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

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:00Z', 10)

I zwraca ten wynik: "2018-03-25T00:00:0000000Z"

Przykład 2

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

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

I zwraca ten wynik: "2018-03-10T00:00:0000000Z"

addHours

Dodaj liczbę godzin do znacznika czasu.

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

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	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

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:00Z', 10)

I zwraca ten wynik: "2018-03-15T10:00:0000000Z"

Przykład 2

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

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

I zwraca ten wynik: "2018-03-15T10:00:0000000Z"

addMinutes

Dodaj liczbę minut do znacznika czasu.

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

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	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

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:00Z', 10)

I zwraca ten wynik: "2018-03-15T00:20:00.0000000Z"

Przykład 2

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

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

I zwraca ten wynik: "2018-03-15T00:15:00.0000000Z"

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	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

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:00Z', 10)

I zwraca ten wynik: "2018-03-15T00:00:10.0000000Z"

Przykład 2

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

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

I zwraca ten wynik: "2018-03-15T00:00:25.0000000Z"

addToTime

Dodaj liczbę jednostek czasu do znacznika czasu. Zobacz również getFutureTime().

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

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: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Wartość zwracana	Type	Opis
<sygnatura czasowa aktualizacji>	String	Sygnatura czasowa plus określona liczba jednostek czasu

Przykład 1

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

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

I zwraca ten wynik: "2018-01-02T00:00:00.0000000Z"

Przykład 2

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

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

Zwraca wynik przy użyciu opcjonalnego formatu "D": "Tuesday, January 2, 2018"

oraz

Sprawdź, czy oba wyrażenia są prawdziwe. Zwraca wartość true, gdy oba wyrażenia mają wartość true lub zwracają wartość false, gdy 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	Zwraca wartość true, gdy oba wyrażenia są prawdziwe. Zwraca wartość false, gdy 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 następujące wyniki:

Pierwszy przykład: Oba wyrażenia są prawdziwe, więc zwraca wartość true.
Drugi przykład: jedno wyrażenie jest fałszywe, więc zwraca wartość false.
Trzeci przykład: Oba wyrażenia są fałszywe, więc zwraca wartość false.

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 następujące wyniki:

Pierwszy przykład: Oba wyrażenia są prawdziwe, więc zwraca wartość true.
Drugi przykład: jedno wyrażenie jest fałszywe, więc zwraca wartość false.
Trzeci przykład: Oba wyrażenia są fałszywe, więc zwraca wartość false.

tablica

Zwraca tablicę z jednego określonego danych wejściowych. W przypadku wielu danych wejściowych zobacz createArray().

array('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	String	Ciąg do tworzenia tablicy

Wartość zwracana	Type	Opis
[<wartość>]	Tablica	Tablica zawierająca pojedyncze określone dane wejściowe

Przykład

W tym przykładzie zostanie utworzona tablica z ciągu "hello":

array('hello')

I zwraca ten wynik: ["hello"]

base64

Zwróć wersję zakodowaną w formacie base64 dla ciągu.

base64('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	String	Ciąg wejściowy

Wartość zwracana	Type	Opis
<ciąg base64>	String	Wersja zakodowana w formacie base64 dla ciągu wejściowego

Przykład

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

base64('hello')

I zwraca ten wynik: "aGVsbG8="

base64ToBinary

Zwróć wersję binarną dla 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>	String	Wersja binarna dla ciągu zakodowanego w formacie base64

Przykład

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

base64ToBinary('aGVsbG8=')

I zwraca ten wynik:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Zwróć wersję ciągu dla ciągu zakodowanego w formacie base64, co skutecznie dekoduje ciąg base64. Użyj tej funkcji zamiast dekodowaćBase64(). Chociaż obie funkcje działają w taki sam sposób, base64ToString() jest preferowana.

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 dla ciągu zakodowanego w formacie base64

Przykład

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

base64ToString('aGVsbG8=')

I zwraca ten wynik: "hello"

dane binarne

Zwróć 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>	String	Wersja binarna dla określonego ciągu

Przykład

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

binary('hello')

I zwraca ten wynik:

"0110100001100101011011000110110001101111"

bool

Zwróć wersję logiczną dla wartości.

bool(<value>)

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

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

Przykład

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

bool(1)
bool(0)

I zwraca następujące wyniki:

Pierwszy przykład: true
Drugi przykład: false

Łą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	Dowolny, może mieszać typy	Co najmniej jeden element do sprawdzenia pod kątem wartości null

Wartość zwracana	Type	Opis
<pierwszy element o wartości innej niż null>	Dowolne	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 zwraca następujące wyniki:

Pierwszy przykład: true
Drugi przykład: "hello"
Trzeci przykład: null

concat

Połącz co najmniej dwa ciągi i zwróć połączony ciąg.

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

Parametr	Wymagania	Type	Opis
<text1>, <text2>, ...	Tak	String	Co najmniej dwa ciągi do połączenia

Wartość zwracana	Type	Opis
<text1text2...>	String	Ciąg utworzony na podstawie połączonych ciągów wejściowych

Przykład

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

concat('Hello', 'World')

I zwraca ten wynik: "HelloWorld"

zawiera

Sprawdź, czy kolekcja ma określony element. Zwraca wartość true, gdy element zostanie znaleziony lub zwraca wartość false, gdy nie zostanie znaleziony. Ta funkcja uwzględnia wielkość liter.

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

W szczególności 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	Zwraca wartość true po znalezieniu elementu. Zwraca wartość false, gdy nie zostanie znaleziona.

Przykład 1

W tym przykładzie jest sprawdzany ciąg "hello world" dla podciągów "world" i zwraca wartość true:

contains('hello world', 'world')

Przykład 2

W tym przykładzie ciąg "hello world" dla podciągu "universe" i zwraca wartość false:

contains('hello world', 'universe')

convertFromUtc

Przekonwertuj znacznik czasu z uniwersalnego czasu koordynowanego (UTC) na docelową strefę czasową.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	String	Ciąg zawierający znacznik czasu
<destinationTimeZone>	Tak	String	Nazwa docelowej strefy czasowej. Aby uzyskać nazwy stref czasowych, zobacz Wartości strefy czasowej firmy Microsoft, ale może być konieczne usunięcie wszelkich znaków interpunkcyjnych z nazwy strefy czasowej.
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

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

Przykład 1

W tym przykładzie znacznik czasu jest konwertowany na określoną strefę czasową:

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

I zwraca ten wynik: "2018-01-01T00:00:00Z"

Przykład 2

W tym przykładzie znacznik czasu jest konwertowany na określoną strefę czasową i format:

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

I zwraca ten wynik: "Monday, January 1, 2018"

convertTimeZone

Przekonwertuj znacznik czasu ze źródłowej strefy czasowej na docelową strefę czasową.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	String	Ciąg zawierający znacznik czasu
<sourceTimeZone>	Tak	String	Nazwa źródłowej strefy czasowej. Aby uzyskać nazwy stref czasowych, zobacz Wartości strefy czasowej firmy Microsoft, ale może być konieczne usunięcie wszelkich znaków interpunkcyjnych z nazwy strefy czasowej.
<destinationTimeZone>	Tak	String	Nazwa docelowej strefy czasowej. Aby uzyskać nazwy stref czasowych, zobacz Wartości strefy czasowej firmy Microsoft, ale może być konieczne usunięcie wszelkich znaków interpunkcyjnych z nazwy strefy czasowej.
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

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

Przykład 1

W tym przykładzie źródłowa strefa czasowa jest konwertowana na docelową strefę czasową:

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

I zwraca ten wynik: "2018-01-01T00:00:00.0000000"

Przykład 2

W tym przykładzie strefa czasowa jest konwertowana na określoną strefę czasową i format:

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

I zwraca ten wynik: "Monday, January 1, 2018"

convertToUtc

Przekonwertuj znacznik czasu ze źródłowej strefy czasowej na uniwersalny czas koordynowany (UTC).

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	String	Ciąg zawierający znacznik czasu
<sourceTimeZone>	Tak	String	Nazwa źródłowej strefy czasowej. Aby uzyskać nazwy stref czasowych, zobacz Wartości strefy czasowej firmy Microsoft, ale może być konieczne usunięcie wszelkich znaków interpunkcyjnych z nazwy strefy czasowej.
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Wartość zwracana	Type	Opis
<przekonwertowana sygnatura czasowa>	String	Sygnatura czasowa przekonwertowana na utc

Przykład 1

W tym przykładzie sygnatura czasowa jest konwertowana na czas UTC:

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

I zwraca ten wynik: "2018-01-01T08:00:00.0000000Z"

Przykład 2

W tym przykładzie sygnatura czasowa jest konwertowana na czas UTC:

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

I zwraca ten wynik: "Monday, January 1, 2018"

createArray

Zwraca tablicę z wielu danych wejściowych. Aby uzyskać informacje o pojedynczych tablicach wejściowych, zobacz array().

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 na podstawie tych danych wejściowych:

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

I zwraca ten wynik: ["h", "e", "l", "l", "o"]

dataUri

Zwracanie identyfikatora URI (URI) danych dla ciągu.

dataUri('<value>')

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

Wartość zwracana	Type	Opis
<data-uri>	String	Identyfikator URI danych dla ciągu wejściowego

Przykład

W tym przykładzie zostanie utworzony identyfikator URI danych dla ciągu "hello":

dataUri('hello')

I zwraca ten wynik: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Zwraca wersję binarną dla identyfikatora URI (URI). Użyj tej funkcji zamiast dekodowaćDataUri(). Chociaż obie funkcje działają w taki sam sposób, dataUriBinary() jest preferowana.

dataUriToBinary('<value>')

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

Wartość zwracana	Type	Opis
<binary-for-data-uri>	String	Wersja binarna identyfikatora URI danych

Przykład

W tym przykładzie zostanie utworzona wersja binarna dla tego identyfikatora URI danych:

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

I zwraca ten wynik:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Zwraca wersję ciągu dla 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 dla tego identyfikatora URI danych:

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

I zwraca ten wynik: "hello"

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

W tym przykładzie jest zwracana liczba dni miesiąca z tego znacznika czasu:

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

I zwraca ten 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, w którym niedziela wynosi 0, poniedziałek to 1 itd.

Przykład

W tym przykładzie zwracana jest liczba dni tygodnia z tego znacznika czasu:

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

I zwraca ten 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 tego znacznika czasu:

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

I zwraca ten wynik: 74

dekodujBase64

Zwróć wersję ciągu dla ciągu zakodowanego w formacie base64, co skutecznie dekoduje ciąg base64. Rozważ użycie metody base64ToString() zamiast decodeBase64(). Chociaż obie funkcje działają w taki sam sposób, base64ToString() jest preferowana.

decodeBase64('<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 dla ciągu zakodowanego w formacie base64

Przykład

W tym przykładzie tworzony jest ciąg dla ciągu zakodowanego w formacie base64:

decodeBase64('aGVsbG8=')

I zwraca ten wynik: "hello"

decodeDataUri

Zwraca wersję binarną dla identyfikatora URI (URI). Rozważ użycie metody dataUriToBinary(), a nie decodeDataUri(). Chociaż obie funkcje działają w taki sam sposób, dataUriToBinary() jest preferowana.

decodeDataUri('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	String	Ciąg identyfikatora URI danych do dekodowania

Wartość zwracana	Type	Opis
<binary-for-data-uri>	String	Wersja binarna ciągu identyfikatora URI danych

Przykład

Ten przykład zwraca wersję binarną dla tego identyfikatora URI danych:

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

I zwraca ten wynik:

decodeUriComponent

Zwraca ciąg, który zastępuje znaki ucieczki dekodowanym wersjami.

decodeUriComponent('<value>')

Parametr	Wymagania	Type	Opis
<wartość>	Tak	String	Ciąg ze znakami ucieczki do dekodowania

Wartość zwracana	Type	Opis
<dekodowany identyfikator URI>	String	Zaktualizowany ciąg z dekodowanym znakiem ucieczki

Przykład

W tym przykładzie znaki ucieczki w tym ciągu zastępują dekodowane wersje:

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

I zwraca ten wynik: "https://contoso.com"

div

Zwraca wynik dzielenia jednej liczby przez inną liczbę.

div(<dividend>, <divisor>)

Dokładny typ zwracany funkcji zależy od typów jego parametrów — zobacz przykłady, aby uzyskać szczegółowe informacje.

Parametr	Wymagania	Type	Opis
<dywidenda>	Tak	Liczba całkowita lub zmiennoprzecinkowa	Liczba do podzielenia przez dzielnik
<dzielnik>	Tak	Liczba całkowita lub zmiennoprzecinkowa	Liczba dzieląca dywidendę. Wartość dzielnika zero powoduje błąd w czasie wykonywania.

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

Przykład 1

Te przykłady dzielą liczbę 9 na 2:

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

A wszystkie zwracają ten wynik: 4.5

Przykład 2

Ten przykład dzieli również liczbę 9 na 2, ale ponieważ oba parametry są liczbami całkowitymi reszty, jest odrzucana (dzielenie całkowite):

div(9, 2)

Wyrażenie zwraca wynik 4. Aby uzyskać wartość pozostałej części, użyj funkcji mod().

encodeUriComponent

Zwróć wersję zakodowaną w postaci identyfikatora zasobu (URI) dla ciągu, zastępując znaki ucieczki niebezpiecznymi adresami URL. Rozważ użycie identyfikatora uriComponent(), a nie encodeUriComponent(). Chociaż obie funkcje działają w taki sam sposób, uriComponent() jest preferowana.

encodeUriComponent('<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 wersja zakodowana w identyfikatorze URI dla tego ciągu:

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

I zwraca ten wynik: "http%3A%2F%2Fcontoso.com"

empty

Sprawdź, czy kolekcja jest pusta. Zwraca wartość true, gdy kolekcja jest pusta lub zwraca wartość false, gdy nie jest pusta.

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

Parametr	Wymagania	Type	Opis
<kolekcja>	Tak	Ciąg, tablica lub obiekt	Kolekcja do sprawdzenia

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwraca wartość true, gdy kolekcja jest pusta. Zwraca wartość false, jeśli nie jest pusta.

Przykład

Te przykłady sprawdzają, czy określone kolekcje są puste:

empty('')
empty('abc')

I zwraca następujące wyniki:

Pierwszy przykład: Przekazuje pusty ciąg, więc funkcja zwraca truewartość .
Drugi przykład: Przekazuje ciąg "abc", więc funkcja zwraca falsewartość .

endsWith

Sprawdź, czy ciąg kończy się określonym podciągem. Zwraca wartość true, gdy podciąg zostanie znaleziony lub zwróci wartość false, gdy 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	Zwraca wartość true po znalezieniu końcowego podciągu. Zwraca wartość false, gdy nie zostanie znaleziona.

Przykład 1

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

endsWith('hello world', 'world')

I zwraca ten wynik: true

Przykład 2

W tym przykładzie sprawdza się, czy ciąg "hello world" kończy się ciągiem "universe":

endsWith('hello world', 'universe')

I zwraca ten wynik: false

equals

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

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

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

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwraca wartość true, gdy obie są równoważne. Zwraca 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 następujące wyniki:

Pierwszy przykład: Obie wartości są równoważne, więc funkcja zwraca truewartość .
Drugi przykład: Obie wartości nie są równoważne, więc funkcja zwraca falsewartość .

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>	Dowolne	Pierwszy element w kolekcji

Przykład

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

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

I zwróć następujące wyniki:

Pierwszy przykład: "h"
Drugi przykład: 0

liczba zmiennoprzecinkowa

Przekonwertuj wersję ciągu dla liczby zmiennoprzecinkowych na rzeczywistą liczbę zmiennoprzecinkową.

float('<value>')

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

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

Przykład

W tym przykładzie zostanie utworzona wersja ciągu dla tego numeru zmiennoprzecinkowego:

float('10.333')

I zwraca ten wynik: 10.333

formatDateTime

Zwraca znacznik czasu w określonym formacie.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	String	Ciąg zawierający znacznik czasu
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

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

Przykład

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

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

I zwraca ten wynik: "2018-03-15T12:00:00"

getFutureTime

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

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

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: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

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żący znacznik czasu to "2018-03-01T00:00:00.0000000Z". W tym przykładzie dodano pięć dni do tego znacznika czasu:

getFutureTime(5, 'Day')

I zwraca ten wynik: "2018-03-06T00:00:00.0000000Z"

Przykład 2

Załóżmy, że bieżący znacznik czasu to "2018-03-01T00:00:00.0000000Z". W tym przykładzie dodano pięć dni i przekonwertowaliśmy wynik na format "D":

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

I zwraca ten wynik: "Tuesday, March 6, 2018"

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: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

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.0000000Z". W tym przykładzie odejmuje pięć dni od tego znacznika czasu:

getPastTime(5, 'Day')

I zwraca ten wynik: "2018-01-27T00:00:00.0000000Z"

Przykład 2

Załóżmy, że bieżący znacznik czasu to "2018-02-01T00:00:00.0000000Z". W tym przykładzie odejmuje pięć dni i konwertuje wynik na format "D":

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

I zwraca ten wynik: "Saturday, January 27, 2018"

greater

Sprawdź, czy pierwsza wartość jest większa niż druga wartość. Zwraca wartość true, gdy pierwsza wartość jest większa lub zwraca wartość false, gdy 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	Zwraca wartość true, gdy pierwsza wartość jest większa niż druga wartość. Zwraca wartość false, gdy 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óć następujące wyniki:

Pierwszy przykład: true
Drugi przykład: false

greaterOrEquals

Sprawdź, czy pierwsza wartość jest większa, czy równa drugiej wartości. Zwraca wartość true, gdy pierwsza wartość jest większa lub równa, lub zwraca wartość false, gdy 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	Zwraca wartość true, gdy pierwsza wartość jest większa lub równa drugiej wartości. Zwraca wartość false, gdy 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óć następujące wyniki:

Pierwszy przykład: true
Drugi przykład: false

Identyfikator GUID

Wygeneruj unikatowy identyfikator globalny (GUID) jako ciąg, na przykład "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Ponadto można określić inny format identyfikatora GUID innego niż domyślny format "D", który jest 32 cyframi oddzielonymi łącznikami.

guid('<format>')

Parametr	Wymagania	Type	Opis
<format>	Nie.	String	Specyfikator pojedynczego formatu dla zwróconego identyfikatora GUID. Domyślnie format to "D", ale można użyć "N", "D", "B", "P" lub "X".

Wartość zwracana	Type	Opis
<Wartość identyfikatora GUID>	String	Losowo wygenerowany identyfikator GUID

Przykład

Ten przykład generuje ten sam identyfikator GUID, ale jako 32 cyfry oddzielone łącznikami i ujęte w nawiasy:

guid('P')

I zwraca ten wynik: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

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	Dowolne	Wartość, która ma być zwracana, gdy wyrażenie ma wartość true
<valueIfFalse>	Tak	Dowolne	Wartość, która ma być zwracana, gdy wyrażenie ma wartość false

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

Przykład

Ten przykład zwraca wartość "yes" , ponieważ określone wyrażenie zwraca wartość true. W przeciwnym razie przykład zwraca wartość "no":

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

indexOf

Zwraca wartość pozycji początkowej lub indeksu dla podciągów. Ta funkcja nie uwzględnia wielkości liter, a indeksy zaczynają się od liczby 0.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	String	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 dla określonego podciągu. Jeśli ciąg nie zostanie znaleziony, zwróć liczbę -1.

Przykład

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

indexOf('hello world', 'world')

I zwraca ten wynik: 6

int

Zwróć wersję całkowitą dla ciągu.

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 dla określonego ciągu

Przykład

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

int('10')

I zwraca ten wynik: 10

json

Zwróć wartość typu JavaScript Object Notation (JSON) lub obiekt dla 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>	Natywny typ lub obiekt JSON	Wartość typu natywnego lub obiektu JSON dla określonego ciągu lub XML. Jeśli ciąg ma wartość null, funkcja zwraca pusty obiekt.

Przykład 1

W tym przykładzie ten ciąg jest konwertowany na wartość JSON:

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

I zwraca ten wynik: [1, 2, 3]

Przykład 2

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

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

I zwraca ten wynik:

{
  "fullName": "Sophia Owen"
}

Przykład 3

W tym przykładzie ten 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 ten wynik:

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

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 obie	Kolekcje, z których mają być używane tylko typowe 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 tych tablicach:

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

Zwraca tablicę z tylko tymi elementami:[1, 2]

join

Zwróć ciąg, który zawiera wszystkie elementy z tablicy i ma każdy znak oddzielony 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 ogranicznikiem:

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

I zwraca ten wynik: "a.b.c"

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 następujące wyniki:

Pierwszy przykład: "d"
Drugi przykład: 3

lastIndexOf

Zwraca wartość pozycji początkowej lub indeksu dla ostatniego wystąpienia podciągów. Ta funkcja nie uwzględnia wielkości liter, a indeksy zaczynają się od liczby 0.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	String	Ciąg zawierający podciąg do znalezienia
<tekst wyszukiwania>	Tak	String	Podciąg do znalezienia

Wartość zwracana	Type	Opis
<end-index-value>	Integer	Wartość pozycji początkowej lub indeksu dla ostatniego wystąpienia określonego podciągu. Jeśli ciąg nie zostanie znaleziony, zwróć liczbę -1.

Przykład

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

lastIndexOf('hello world', 'world')

I zwraca ten wynik: 6

length

Zwróć liczbę elementów w kolekcji.

length('<collection>')
length([<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ład

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

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

I zwróć ten wynik: 4

less

Sprawdź, czy pierwsza wartość jest mniejsza niż druga wartość. Zwraca wartość true, gdy pierwsza wartość jest mniejsza lub zwraca wartość false, gdy 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	Zwraca wartość true, gdy pierwsza wartość jest mniejsza niż druga wartość. Zwraca wartość false, gdy pierwsza wartość jest równa lub większa niż druga wartość.

Przykład

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

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

I zwróć następujące wyniki:

Pierwszy przykład: true
Drugi przykład: false

lessOrEquals

Sprawdź, czy pierwsza wartość jest mniejsza, czy równa drugiej wartości. Zwraca wartość true, gdy pierwsza wartość jest mniejsza lub równa, lub zwraca wartość false, gdy 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	Zwraca wartość true, gdy pierwsza wartość jest mniejsza lub równa drugiej wartości. Zwraca wartość false, gdy pierwsza wartość jest większa niż druga wartość.

Przykład

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

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

I zwróć następujące wyniki:

Pierwszy przykład: true
Drugi przykład: false

max

Zwróć najwyższą wartość z listy lub tablicy z liczbami, które są uwzględniane na obu końcach.

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

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

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

Przykład

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

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

I zwróć ten wynik: 3

min

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

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

Parametr	Wymagania	Type	Opis
<liczba1>, <liczba2>, ...	Tak	Liczba całkowita, zmiennoprzecinkowa lub obie	Zestaw liczb, z których ma być najniższa wartość
[<number1>, <number2>, ...]	Tak	Tablica — liczba całkowita, zmiennoprzecinkowa lub obie	Tablica liczb, z której ma być najniższa wartość

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

Przykład

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

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

I zwróć ten wynik: 1

mod

Zwróć resztę z dzielenia jednej liczby przez inną liczbę. Aby uzyskać informacje na temat dzielenia liczb całkowitych, zobacz div().

mod(<dividend>, <divisor>)

Parametr	Wymagania	Type	Opis
<dywidenda>	Tak	Liczba całkowita lub zmiennoprzecinkowa	Liczba do podzielenia przez dzielnik
<dzielnik>	Tak	Liczba całkowita lub zmiennoprzecinkowa	Liczba dzieląca dywidendę. Wartość dzielnika zero powoduje błąd w czasie wykonywania.

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

Przykład

Ten przykład oblicza resztę, gdy pierwsza liczba jest podzielona przez drugą liczbę:

mod(3, 2)

I zwraca ten wynik: 1

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, która mnoży mnożenie wielokropka1

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

Przykład

Te przykłady mnożą pierwszą liczbę przez drugą liczbę:

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

I zwróć następujące wyniki:

Pierwszy przykład: 2
Drugi przykład 3

not

Sprawdź, czy wyrażenie jest fałszywe. Zwraca wartość true, gdy wyrażenie ma wartość false lub zwraca wartość false, gdy 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	Zwraca wartość true, gdy wyrażenie ma wartość false. Zwraca wartość false, gdy 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óć następujące wyniki:

Pierwszy przykład: wyrażenie ma wartość false, więc funkcja zwraca truewartość .
Drugi przykład: 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óć następujące wyniki:

Pierwszy przykład: wyrażenie ma wartość false, więc funkcja zwraca truewartość .
Drugi przykład: Wyrażenie ma wartość true, więc funkcja zwraca falsewartość .

lub

Sprawdź, czy co najmniej jedno wyrażenie ma wartość true. Zwraca wartość true, gdy co najmniej jedno wyrażenie ma wartość true lub zwraca wartość false, gdy oba 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	Zwraca wartość true, gdy co najmniej jedno wyrażenie ma wartość true. Zwraca wartość false, gdy oba 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óć następujące wyniki:

Pierwszy przykład: Co najmniej jedno wyrażenie ma wartość true, więc funkcja zwraca truewartość .
Drugi przykład: 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óć następujące wyniki:

Pierwszy przykład: Co najmniej jedno wyrażenie ma wartość true, więc funkcja zwraca truewartość .
Drugi przykład: 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. Należy pamiętać, że każde wywołanie elementu spowoduje wygenerowanie unikatowego `rand()` wyniku, co oznacza, że wartość obserwowana w monitorowaniu danych wyjściowych może nie być taka sama w rzeczywistym czasie wykonywania.

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)

Funkcja zwraca jedną z tych liczb w wyniku: 1, , 2lub 34

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
[<range-result>]	Tablica	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 i ma określoną liczbę liczb całkowitych:

range(1, 4)

I zwraca ten wynik: [1, 2, 3, 4]

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, zwróć oryginalny ciąg.

Przykład

W tym przykładzie znajduje się podciąg "stary" w ciągu "stary" i zastępuje ciąg "old" ciągiem "new":

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

I zwraca ten wynik: "the new string"

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
[<zaktualizowana kolekcja>]	Tablica	Zaktualizowana kolekcja po usunięciu określonych elementów

Przykład

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

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

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

split

Podziel ciąg na każde wystąpienie określonego ogranicznika, zwracając wynikowe podciągi jako elementy tablicy. Ogranicznik jest zazwyczaj pojedynczym znakiem, ale obsługiwane są ograniczniki multicharacter.

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

Parametr	Wymagania	Type	Opis
<text>	Tak	String	Ciąg do oddzielenia od podciągów
<Ogranicznik>	Tak	String	Ciąg do użycia jako ogranicznik

Wartość zwracana	Type	Opis
[<podciąg1,podciąg2>><,...]	Tablica	Tablica zawierająca podciąg oryginalnego ciągu

Przykład

Ten przykład zwraca tablicę zawierającą podciągi ciągu "a_b_c" na podstawie ogranicznika "_":

split('a_b_c', '_')

Zwrócona tablica to: ["a","b","c"]

startOfDay

Zwróć początek dnia dla znacznika czasu.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	String	Ciąg zawierający znacznik czasu
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Wartość zwracana	Type	Opis
<sygnatura czasowa aktualizacji>	String	Określony znacznik czasu, ale rozpoczynający się od znaku zero-godzinnego dla dnia

Przykład

W tym przykładzie znajduje się początek dnia dla tego znacznika czasu:

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

I zwraca ten wynik: "2018-03-15T00:00:00.0000000Z"

startOfHour

Zwróć początek godziny dla znacznika czasu.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	String	Ciąg zawierający znacznik czasu
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Wartość zwracana	Type	Opis
<sygnatura czasowa aktualizacji>	String	Określony znacznik czasu, ale rozpoczynający się od znaku zero-minutowego dla godziny

Przykład

W tym przykładzie znajduje się początek godziny dla tego znacznika czasu:

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

I zwraca ten wynik: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Zwróć początek miesiąca dla znacznika czasu.

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

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	String	Ciąg zawierający znacznik czasu
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Wartość zwracana	Type	Opis
<sygnatura czasowa aktualizacji>	String	Określony znacznik czasu, ale rozpoczynający się pierwszego dnia miesiąca na znaczniku zero-godzinnym

Przykład

Ten przykład zwraca początek miesiąca dla tego znacznika czasu:

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

I zwraca ten wynik: "2018-03-01T00:00:00.0000000Z"

startsWith

Sprawdź, czy ciąg rozpoczyna się od określonego podciągu. Zwraca wartość true, gdy podciąg zostanie znaleziony lub zwróci wartość false, gdy 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	Ciąg początkowy do znalezienia

Wartość zwracana	Type	Opis
prawda lub fałsz	Wartość logiczna	Zwraca wartość true po znalezieniu początkowego podciągu. Zwraca wartość false, gdy nie zostanie znaleziona.

Przykład 1

W tym przykładzie sprawdza się, czy ciąg "hello world" rozpoczyna się od podciągu "hello":

startsWith('hello world', 'hello')

I zwraca ten wynik: true

Przykład 2

W tym przykładzie sprawdza się, czy ciąg "hello world" rozpoczyna się od podciągu "greetings":

startsWith('hello world', 'greetings')

I zwraca ten wynik: false

string

Zwróć wersję ciągu dla wartości.

string(<value>)

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

Wartość zwracana	Type	Opis
<ciąg-wartość>	String	Wersja ciągu dla określonej wartości

Przykład 1

W tym przykładzie zostanie utworzona wersja ciągu dla tego numeru:

string(10)

I zwraca ten wynik: "10"

Przykład 2

W tym przykładzie tworzony jest ciąg dla określonego obiektu JSON i używa znaku ukośnika odwrotnego (\) jako znaku ucieczki dla podwójnego cudzysłowu (").

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

I zwraca ten wynik: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

Zwróć wynik odejmowania jednej liczby z innej liczby.

sub(<minuend>, <subtrahend>)

Parametr	Wymagania	Type	Opis
<minuend>	Tak	Liczba całkowita lub zmiennoprzecinkowa	Liczba, z której należy odjąć odejmowanie odejmowania
<odjemnik>	Tak	Liczba całkowita lub zmiennoprzecinkowa	Liczba do odejmowania od minuend

Wartość zwracana	Type	opis
<wynik>	Liczba całkowita lub zmiennoprzecinkowa	Wynik odejmowania drugiej liczby z pierwszej liczby

Przykład

W tym przykładzie odejmuje drugą liczbę z pierwszej liczby:

sub(10.3, .3)

I zwraca ten wynik: 10

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, którego znaki chcesz
<startIndex>	Tak	Integer	Liczba dodatnia równa lub większa niż 0, której chcesz użyć jako pozycji początkowej lub wartości indeksu
<length>	Tak	Integer	Dodatnia liczba znaków, które mają być 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 ten wynik: "world"

odejmowanieFromTime

Odejmij liczbę jednostek czasu z znacznika czasu. Zobacz również getPastTime.

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

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: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

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 tego znacznika czasu:

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

I zwraca ten wynik: "2018-01-01T00:00:00:0000000Z"

Przykład 2

W tym przykładzie odejmuje jeden dzień od tego znacznika czasu:

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

Zwraca ten wynik przy użyciu opcjonalnego formatu "D": "Monday, January, 1, 2018"

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óć następujące wyniki:

Pierwszy przykład: "abc"
Drugi przykład: [0, 1, 2]

Kleszcze

ticks Zwraca wartość właściwości dla określonego znacznika czasu. Kleszcz jest interwałem 100-nanosekundowym.

ticks('<timestamp>')

Parametr	Wymagania	Type	Opis
<Sygnatury czasowej>	Tak	String	Ciąg znacznika czasu

Wartość zwracana	Type	Opis
<ticks-number>	Integer	Liczba kleszczy, które upłynęły od 12:00:00 północy, 1 stycznia 0001 w kalendarzu gregoriańskim od znacznika czasu wejściowego

toLower

Zwraca ciąg w formacie małych liter. Jeśli znak w ciągu nie ma małej litery, ten znak pozostaje niezmieniony w zwracanym ciągu.

toLower('<text>')

Parametr	Wymagania	Type	Opis
<text>	Tak	String	Ciąg, który ma być zwracany w formacie małych liter

Wartość zwracana	Type	Opis
<małe litery i tekst>	String	Oryginalny ciąg w formacie małych liter

Przykład

W tym przykładzie ten ciąg jest konwertowany na małe litery:

toLower('Hello World')

I zwraca ten wynik: "hello world"

toUpper

Zwraca ciąg w formacie wielkiej litery. Jeśli znak w ciągu nie ma wielkiej litery, ten znak pozostaje niezmieniony w zwracanym ciągu.

toUpper('<text>')

Parametr	Wymagania	Type	Opis
<text>	Tak	String	Ciąg, który ma być zwracany w formacie wielkiej litery

Wartość zwracana	Type	Opis
<wielkie litery — tekst>	String	Oryginalny ciąg w formacie wielkiej litery

Przykład

W tym przykładzie ten ciąg jest konwertowany na wielkie litery:

toUpper('Hello World')

I zwraca ten 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  ')

I zwraca ten 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 obie	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 — bez duplikatów

Przykład

Ten przykład pobiera wszystkie elementy z tych kolekcji:

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

I zwraca ten wynik: [1, 2, 3, 10, 101]

uriComponent

Zwróć wersję zakodowaną w postaci identyfikatora zasobu (URI) dla ciągu, zastępując znaki ucieczki niebezpiecznymi adresami URL. Użyj tej funkcji, a nie encodeUriComponent(). Chociaż obie funkcje działają w taki sam sposób, uriComponent() jest preferowana.

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 wersja zakodowana w identyfikatorze URI dla tego ciągu:

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

I zwraca ten wynik: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Zwróć wersję binarną dla składnika URI (Uniform Resource Identifier).

uriComponentToBinary('<value>')

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

Wartość zwracana	Type	Opis
<binary-for-encoded-uri>	String	Wersja binarna dla ciągu kodowanego identyfikatorem URI. Zawartość binarna jest zakodowana w formacie base64 i reprezentowana przez `$content`element .

Przykład

W tym przykładzie zostanie utworzona wersja binarna dla tego ciągu zakodowanego za pomocą identyfikatora URI:

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

I zwraca ten wynik:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Zwróć wersję ciągu dla zakodowanego 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
<dekodowany identyfikator URI>	String	Zdekodowana wersja ciągu zakodowanego za pomocą identyfikatora URI

Przykład

W tym przykładzie tworzona jest zdekodowana wersja ciągu dla tego ciągu zakodowanego za pomocą identyfikatora URI:

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

I zwraca ten wynik: "https://contoso.com"

utcNow

Zwróć bieżący znacznik czasu.

utcNow('<format>')

Opcjonalnie możesz określić inny format za pomocą parametru <formatu> .

Parametr	Wymagania	Type	Opis
<format>	Nie.	String	Specyfikator pojedynczego formatu lub wzorzec formatu niestandardowego. Domyślny format znacznika czasu to "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), który jest zgodny z normą ISO 8601 i zachowuje informacje o strefie czasowej.

Wartość zwracana	Type	Opis
<znacznik czasu bieżącego>	String	Bieżąca data i godzina

Przykład 1

Załóżmy, że dzisiaj jest 15 kwietnia 2018 r. o 13:00:00. W tym przykładzie jest pobierany bieżący znacznik czasu:

utcNow()

I zwraca ten wynik: "2018-04-15T13:00:00.0000000Z"

Przykład 2

Załóżmy, że dzisiaj jest 15 kwietnia 2018 r. o 13:00:00. W tym przykładzie jest pobierana bieżąca sygnatura czasowa przy użyciu opcjonalnego formatu "D":

utcNow('D')

I zwraca ten wynik: "Sunday, April 15, 2018"

xml

Zwróć wersję XML dla 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 znaku ukośnika odwrotnego (\) jako znaku ucieczki dla podwójnego cudzysłowu (").

Wartość zwracana	Type	Opis
<wersja xml>	Objekt	Zakodowany kod XML dla określonego ciągu lub obiektu JSON

Przykład 1

W tym przykładzie tworzona jest wersja XML dla tego ciągu, która zawiera obiekt JSON:

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

I zwraca ten wynik XML:

<name>Sophia Owen</name>

Przykład 2

Załóżmy, że masz ten obiekt JSON:

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

W tym przykładzie tworzony jest kod XML dla ciągu zawierającego ten obiekt JSON:

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

I zwraca ten 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 lub po prostu "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	Dowolne	Ciąg XML do wyszukiwania węzłów lub wartości pasujących do wartości wyrażenia XPath
<xpath>	Tak	Dowolne	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ść>	Dowolne	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

Poniższy przykład w przykładzie 1 znajduje węzły zgodne z węzłem <count></count> i dodaje te wartości węzła sum() do funkcji :

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

I zwraca ten wynik: 30

Przykład 2

W tym przykładzie oba wyrażenia znajdują węzły zgodne z węzłem <location></location> w określonych argumentach, które zawierają kod XML z przestrzenią nazw. Wyrażenia używają znaku ukośnika odwrotnego (\) jako znaku ucieczki podwójnego cudzysłowu (").

Wyrażenie 1

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

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

Oto argumenty:

Ten kod XML, który zawiera przestrzeń nazw dokumentów XML, xmlns="http://contoso.com":

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

W tym miejscu albo wyrażenie XPath:
- /*[name()=\"file\"]/*[name()=\"location\"]
- /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

Oto węzeł wyników zgodny z węzłem <location></location> :

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

Przykład 3

W przykładzie 3 ten przykład znajduje wartość w węźle <location></location> :

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

I zwraca ten wynik: "Paris"

Uwaga

Można dodawać komentarze do wyrażeń przepływu danych, ale nie w wyrażeniach potoku.

Aby uzyskać listę zmiennych systemowych, których można używać w wyrażeniach, zobacz Zmienne systemowe.

Udostępnij za pośrednictwem

Wyrażenia i funkcje w usługach Azure Data Factory i Azure Synapse Analytics

Wyrażenia

Przykłady

Przykład wyrażenia złożonego

Edytor zawartości dynamicznej

Zestaw danych z parametrem

Potok z parametrem

Zastępowanie znaków specjalnych

Ucieczka znaku pojedynczego cudzysłowu

Samouczek

Funkcje

Funkcje daty

Funkcje ciągów

Funkcje odbioru

Funkcje logiczne

Funkcje konwersji

Funkcje matematyczne

Dokumentacja funkcji

add

addDays

addHours

addMinutes

addSeconds

addToTime

oraz

tablica

base64

base64ToBinary

base64ToString

dane binarne

bool

Łączonej

concat

zawiera

convertFromUtc

convertTimeZone

convertToUtc

createArray

dataUri

dataUriToBinary

dataUriToString

dayOfMonth

dayOfWeek

dayOfYear

dekodujBase64

decodeDataUri

decodeUriComponent

div

encodeUriComponent

empty

endsWith

equals

pierwszy

liczba zmiennoprzecinkowa

formatDateTime

getFutureTime

getPastTime

greater

greaterOrEquals

Identyfikator GUID

jeżeli

indexOf

int

json

skrzyżowanie

join

ostatni

lastIndexOf

length

less

lessOrEquals

max

min

mod

mul

not

lub

rand

range