Pełna lista wyrażeń w edytorze automatyzacji

Ten artykuł zawiera pełną listę wyrażeń, które można wykorzystać w platformie „ Automations Editor ” w blokach logicznych.

Korzystanie z wyrażeń pozwala wykorzystywać dane na różne sposoby lub przekształcać je w różne formy.

Wyrażenia w edytorze automatyzacji

Wszystkie przykłady opierają się na danych wejściowych, wyjściowych i zmiennych w Automation.

**ADD_TIME()**Zwiększa wartość typu Datetime o określoną wartość i jednostkę interwału.

Przykład: ADD_TIME(datetime_variable, 2, 'years')

**SUBTRACT_TIME()**Zmniejsza wartość typu Datetime o określoną wartość i jednostkę przedziału.

Przykład: SUBTRACT_TIME(datetime_variable, 3, 'months')

Wyrażenia z rzutowaniem typów

DATETIMETOTEXT()
Konwertuje wartość typu Datetime na wartość tekstową, która jest łatwa do odczytania przez człowieka

Przykład: DATETIMETOTEXT(zmienna_datetime, "MMMM DD, YYYY", 'America/New_York')

Spowoduje to przekształcenie daty i czasu na czas wschodnioamerykański (EST) i wyświetlenie jej w tradycyjnym formacie daty, np. „1 stycznia 2019 r.”.

Uwaga: Ostatni parametr, czyli strefa czasowa, musi pochodzić z jednej z nazw baz danych tz wymienionych tutaj.

FILETOTEXT("url: File") => Text Konwertuje plik na ciąg tekstowy adresu URL

Przykład: FILETOTEXT("http://www.africau.edu/images/default/sample.pdf")

HEX_TO_INT()
Zwraca numeryczną reprezentację podanego ciągu szesnastkowego.
Przykład: HEX_TO_INT('0xAB18') = '43800'

INT_TO_HEX()
Zwraca reprezentację szesnastkową podanej liczby.
Przykład: INT_TO_HEX('43800') = '0xAB18'

INTERVAL_TO_SECONDS(interval: Interval) => Number Zwraca długość przedziału czasu w sekundach

Przykład: INTERVAL_TO_SECONDS(seconds_to_interval(30.0))

LOWERCASE()
Konwertuje ciąg znaków na małe litery

MAP_TO_BOOLEAN_LIST(a: {} tablica, b: tekst) => tablica Konwertuje tablicę obiektów na tablicę podstawową dla danego klucza

Przykład: MAP_TO_BOOLEAN_LIST([{key: value}], ‘key’) = [value]

MAP_TO_INTEGER_LIST(a: {} tablica, b: tekst) => tablica Konwertuje tablicę obiektów na tablicę podstawową dla podanego klucza

Przykład: MAP_TO_INTEGER_LIST([{key: value}], ‘key’) = [value]

MAP_TO_NUMBER_LIST(a: {} tablica, b: tekst) => tablica Konwertuje tablicę obiektów na tablicę podstawową dla podanego klucza

Przykład: MAP_TO_NUMBER_LIST([{key: value}], „key”) = [value]

MAP_TO_TEXT_LIST(a: {} tablica, b: tekst) => tablica Konwertuje tablicę obiektów na tablicę podstawową dla podanego klucza

Przykład: MAP_TO_TEXT_LIST([{key: value}], ‘key’) = [value]

**SECONDS_TO_INTERVAL()**Przekształca sekundy w interwał.

SECONDS_TO_INTERVAL(seconds: liczba całkowita lub liczba) => Interval

Przykład: SECONDS_TO_INTERVAL(20) => 0:00:20

TEXTTOBOOLEAN()– analizuje tekst i przekształca go w wartość logiczną.

„y”, „yes”, „t”, „true” i „on” oraz wszelkie ich warianty pisane wielkimi literami są rozpoznawane jako „true”, a „n”, „no”, „f”, „false” i „off” są rozpoznawane jako „false”.

Przykład: TEXTTOBOOLEAN(„yes”)

TEXTTODATETIME()
Konwertuje wartość tekstową na wartość typu Datetime przy użyciu określonych parametrów. Funkcja ta jest często używana, gdy funkcja łącznika udostępnia datę i czas w formacie tekstowym, a konieczne jest ich przekonwertowanie.

TEXTTOIMAGEURL(url:Text) => Adres URL obrazu — konwertuje ciąg znaków na adres URL obrazu.

Przykład: TEXTTOIMAGEURL("https://example.com/photo.jpg")

**TEXTTOINTEGER()**Przetwarza tekst lub przedział na liczbę całkowitą.

Przykład: TEXTTOINTEGER("123")

**TEXTTONUMBER()**Przetwarza tekst lub znacznik czasu na liczbę

Przykład: TEXTTONUMBER("2.4")

**TOTEXT()**Przekształca dowolną wartość na tekst.

Przykład: TOTEXT(2)

UPPERCASE()
Konwertuje ciąg znaków na wielkie litery

Wyrażenia z zaokrągleniem w górę

CEIL()
Zaokrągla w górę do najbliższej liczby całkowitej

FLOOR()
Zaokrągla w dół do najbliższej liczby całkowitej

ROUND()
Zaokrągla liczbę do określonej liczby miejsc po przecinku. Maksymalnie 3 miejsca po przecinku.
Przykład 1 — ROUND(123,123456; 1)
Wynikiem będzie 123,1
Przykład 2 — ROUND(123,12)
Wynik to 123

ROUNDDATETIME()
Obcina wartość typu Datetime do określonej jednostki, np. miesiąca lub dnia.

Przykład: ROUNDDATETIME(zmienna_datetime, „Month”, „America/New_York”)
Spowoduje to przekształcenie daty i czasu wyłącznie na miesiąc w strefie czasowej Eastern Standard Time.

Uwaga: Ostatni parametr, czyli strefa czasowa, musi pochodzić z jednej z nazw baz danych tz wymienionych tutaj.

Wyrażenia zwracające wartości

ABS()
Zwraca wartość bezwzględną liczby

CONTAINS()
Zwraca informację, czy ciąg znaków zawiera podany podciąg
Przykład: CONTAINS("123ABC", "123")
W tym przypadku zwracana jest wartość „true”

COS()
Zwraca cosinus podanej wartości

ENCODE_URI(component: Text) => Text
Zwraca wersję adresu URI w postaci ciągu znaków zakodowanego zgodnie ze standardem URL.
Np. ENCODE_URI("http://example.com/a=foo&b=a test") = "http://example.com/a=foo&b=a test"

ENCODE_URI_COMPONENT(component: Text) => Text
Zwraca wersję składowej URI w postaci ciągu znaków zakodowanego w formacie URL.

Przykład: ENCODE_URI_COMPONENT("a & b") = "a%20%26%20b"

**FIND()**Zwraca pozycję, w której pierwszy argument występuje w drugim argumencie.

IF()
Na podstawie pierwszego argumentu zwraca drugi argument, jeśli pierwszy argument jest prawdziwy, lub trzeci argument, jeśli pierwszy argument jest fałszywy.
Przykład: IF(true, 1, 2)

**ISNULL()**Zwraca wartość true, jeśli argument jest pusty, w przeciwnym razie zwraca wartość false.

**LEFT()**Zwraca podciąg wartości tekstowej, zaczynający się od pozycji określonej przez drugi argument.

**LEN()**Zwraca długość wartości tekstowej. Zwraca również liczbę elementów w tablicy.

LINK()
Zwraca pierwszy z argumentów, który nie jest null.

Przykład: LINK(weight, 70)
W tym przypadku zwrócona zostanie wartość weight, o ile weight ma przypisaną wartość

MAX()
Zwraca argument o najwyższej wartości
Przykład: MAX(var1, var2)
Zwróci wartość „var1”, jeśli jest ona większa niż wartość „var2”

**MID()**Zwraca podciąg wartości tekstowej, zaczynając od pozycji określonej przez drugi argument. Trzeci argument określa długość zwracanego podciągu.

**MIN()**Zwraca argument o najniższej wartości
Przykład: MIN(var1, var2)
W tym przypadku zwrócona zostanie wartość var1, jeśli jest mniejsza od wartości var2

POW()
Zwraca pierwszy argument podniesiony do potęgi drugiej
Przykład: POW(3,2)
Zwróci to 9

RAND()
Generuje losową liczbę dziesiętną z przedziału od 0 do 1

RANDBETWEEN()
Generuje losową liczbę całkowitą z przedziału między dwiema podanymi liczbami
Przykład: RANDBETWEEN(5,10)

RANDOMSTRING()
Zwraca losowy ciąg znaków o długości 17 znaków. Przeznaczona do tworzenia identyfikatora dla nowego rekordu w tabeli.

**RANDOM_COLOR()**Generuje losowy kolor

Przykład: RANDOM_COLOR() = ##c537a5

RGA(r: liczba całkowita, g: liczba całkowita, b: liczba całkowita, a: liczba całkowita) => Kolor Zwraca kolor o określonych wartościach składowych czerwieni, zieleni, niebieskiego i alfa

Przykład: RGA(255, 255, 0, 0,5) = ##ffff00 (50% krycia)

RGB(r: liczba całkowita, g: liczba całkowita, b: liczba całkowita) => Kolor Zwraca kolor o podanych składowych czerwieni, zieleni i niebieskiego

Przykład: RGB(255, 255, 0) = ##ffff00

**RIGHT()**Zwraca podciąg wartości tekstowej, kończący się w pozycji określonej przez drugi argument.

SIN()
Zwraca sinus podanej wartości wejściowej

**SPLIT()**Dzieli wartość tekstową na tablicę według określonego separatora.

SQRT()
Zwraca pierwiastek kwadratowy z liczby

SUBSTITUTE()
W ciągu znaków podanym w pierwszym argumencie zastępuje wszystkie wystąpienia drugiego argumentu trzecim argumentem
Przykład: SUBSTITUTE("A734", "7", "3")
Wynikiem będzie „A334”

TAN()
Zwraca tangens podanej wartości

**TRIM()**Usuwa podciąg (określony przez drugi argument) z początku i końca pierwszego argumentu.

Wyrażenia tablicowe

ARRAY_AVG()
Zwraca średnią wszystkich liczb w tablicy
Przykład: ARRAY_AVG([1,2,3])
Wynikiem będzie 2

ARRAY_CONCAT()
Zwraca jedną tablicę zawierającą wszystkie elementy z tablic podanych w argumentach. Działa tylko w przypadku tablic tego samego typu, tj. wszystkich tablic tekstowych.
Przykład: ARRAY_CONCAT([1,2],[3,4],[5,6])
Zwróciłoby to [1,2,3,4,5,6]

ARRAYCONTAINS()
Sprawdza, czy dana wartość znajduje się w tablicy
Przykład: ARRAYCONTAINS([1,2,3], 1)
Zwróci to „true”

**ARRAY_INDEX_OF()**Zwraca indeks pierwszego wystąpienia podanej wartości w podanej tablicy. Jeśli nie zostanie znaleziona, zwraca „-1”. Przykład: ARRAY_INDEX_OF([1,2,3], 2) Zwróci to 1

ARRAY_MAX()
Zwraca minimalną wartość z podanej tablicy
Przykład: ARRAY_MAX([1,2,3])
Wynik to 3

ARRAY_MIN()
Zwraca minimalną wartość z podanej tablicy
Przykład: ARRAY_MIN([1,2,3])
Wynik to 1

ARRAY_STDEV_POPULATION()
Zwraca odchylenie standardowe populacji danej tablicy liczbowej
Przykład: ARRAY_STDEV_POPULATION([1,2,3])
Zwróciłoby to 0,816496580927726

ARRAY_STDEV_SAMPLE()
Zwraca odchylenie standardowe próby danej tablicy liczbowej
Przykład: ARRAY_STDEV_SAMPLE([1,2,3])
Wynik to 1

**ARRAY_VALUE_AT_INDEX()**Zwraca wartość w danym indeksie na podanej liście. Jeśli indeks wykracza poza zakres, zwraca null. Przykład: ARRAY_VALUE_AT_INDEX([1,2,3], 0) Zwróciłoby to 1

**REGEX_MATCH()**Zwraca tablicę wyników dopasowań wyrażenia regularnego do wartości tekstowej. Dopasowania oparte są na podanym wyrażeniu regularnym i modyfikatorach. Metoda ta opiera się na metodzie match języka JavaScript i posiada 2 „tryby”.

Gdy metoda ta otrzymuje dwa argumenty, jest równoważna następującemu wyrażeniu w JavaScript: ``` text.match(new RegExp(regex))``Gdy podano opcjonalny parametr modifiers, metoda ta jest równoważna następującemu wyrażeniu w JavaScript:text.match(new RegExp(regex, modifiers))`Modyfikatory to flagi, których można używać do modyfikowania zachowania wyszukiwania wyrażenia regularnego.

**REGEX_REPLACE()**Zwraca tablicę dopasowań wyrażenia regularnego w wartości tekstowej. Dopasowania oparte są na podanym wyrażeniu regularnym i modyfikatorach. Metoda ta opiera się na metodzie replace języka JavaScript.

Gdy funkcja otrzymuje 3 argumenty, jest to równoważne następującemu wyrażeniu w JavaScript:text.replace(new RegExp(regex), replacement)

Gdy podano opcjonalny parametr modifiers, metoda ta jest równoważna następującemu wyrażeniu w JavaScript:text.replace(new RegExp(regex, modifiers), replacement).Modyfikatory to flagi, których można używać do modyfikowania zachowania wyszukiwania wyrażenia regularnego.

Podczas zapisywania wyrażenia regularnego wewnątrz ciągu znaków należy zastosować sekwencję escape dla znaków odwrotnego ukośnika (), ponieważ JavaScript traktuje każdy znak odwrotnego ukośnika jako znak escape w literałach łańcuchowych.

regex_replace('Hello There', '(\\w+)\\s(\\w+)', '$2 $1')To wyrażenie zwróciłoby wynik „There Hello”.

{{snippet.Czy znalazłeś to, czego szukałeś?}}