Udostępnij za pośrednictwem


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

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.

  1. Dołącz datę do nazwy pliku: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))

  2. Dołącz wartość DateTime w strefie czasowej klienta: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))

  3. Czas wyzwalacza dołączania: @concat('Test_', pipeline().TriggerTime)

  4. 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ń:

  1. Kodowanie adresu URL względem oryginalnej wartości ciągu
  2. Zastąp ciąg zakodowany w adresie URL, na przykład źródło danych wiersza (%0A), powrót karetki (%0D), kartę poziomą (%09).
  3. 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:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

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 $contentelement .

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.