Niestandardowe funkcje formuły

Autor: HubSpot Support | Jun 27, 2022 7:06:46 AM

Jeśli używasz niestandardowej formuły do formatowania danych w przepływie pracy, możesz użyć funkcji z wartościami właściwości z zapisanego rekordu lub danych wyjściowych z poprzednich działań, aby utworzyć złożone formuły.

Zapoznaj się z różnymi funkcjami poniżej, aby określić, których użyć:

Funkcja	Opis	Przykład
abs	Pobiera wartość bezwzględną liczby. Można użyć tej funkcji, aby upewnić się, że liczba jest dodatnia.	przykładowy wzór: abs([liczba lub właściwość liczby]) Przykład: `abs(-10)` przykładowe wyjście: 10
dodać	Dodaje wartość liczbową do innej wartości liczbowej. Ta funkcja jest taka sama jak operator +. Używana z następującymi elementami: number: początkowa wartość liczbowa dla operacji. liczba do dodania: liczba, która ma zostać dodana do początkowej wartości liczbowej.	przykładowy wzór: `add(number, number to add)` przykład: `add(5, 10)` przykładowe wyjście: 15 Alternatywnie można również użyć: przykładowy wzór: `number + number to add` przykład: `5+10` przykładowe wyjście: 15
konkat	Łączenie wielu wartości ciągów znaków. Ta funkcja jest dostępna tylko wtedy, gdy akcja Formatuj dane jest używana w trybie niestandardowym.	Przykładowa formuła:`concat([string 1], " ", [string 2])` przykład: `concat([company name], " ", [MonthYear])` przykładowe dane wyjściowe: HubSpot Czerwiec 2006
kapitalizować	Zamienia pierwszą literę wartości ciągu znaków na wielką. Pierwszy znak będzie pisany wielką literą, podczas gdy wszystkie pozostałe litery będą pisane małą literą. Inne słowa w danych wejściowych nie będą miały wielkiej pierwszej litery	przykładowy wzór: `capitalize([string])` przykład: `capitalize([firstname])` przykładowe dane wyjściowe: Henry
cięcie	Wycina znak lub wiele znaków w celu usunięcia ciągu znaków z wartości. Funkcja ta może być używana do dopasowywania i wycinania określonej części ciągu znaków. Parametr określa część ciągu, która ma zostać usunięta. Użyj z następującymi funkcjami: source: ciąg źródłowy, z którego mają zostać usunięte znaki. characters_to_cut: konkretne znaki do usunięcia. W tym formacie rozróżniana jest wielkość liter.	formuła: `cut(source, characters to cut)` przykład: `cut([phone], "-")` przykładowe dane wyjściowe: 80081234567
format daty i czasu	Uwaga: ta formuła została wycofana i zastąpiona poniższą funkcją `format_datetime`. Akcje wykorzystujące tę funkcję będą nadal działać, ale w przyszłości należy korzystać z nowej funkcji.
format_datetime	Konwersja znacznika czasu do formatu przyjaznego dla człowieka. Dołącz znacznik czasu lub właściwość wraz z następującymi parametrami, aby skonfigurować jego format: format: format do użycia. Wartości obejmują: `'short'`, `'medium'`, `'long'`, `'full'`. Można również określić niestandardowy format przy użyciu wzorców Unicode LDML. timeZone: strefa czasowa danych wyjściowych w formacie IANA TZDB. Domyślnie zwracany jest czas UTC. locale: ustawienia regionalne używane dla formatów uwzględniających ustawienia regionalne.	formuła: `format_datetime(date, format, timeZone, locale)` przykład: `format_datetime([closedate], 'medium', 'America/New_York, 'de-DE')` przykładowe wyjście: `08.02.2024, 17:09:49`
podział	Dzielenie liczby. Ta funkcja jest alternatywą dla operatora /. Używaj z następującymi funkcjami: number: liczba do podzielenia. dzielnik: liczba do podzielenia przez operację dzielenia.	formuła: `divide(number, divisor)` przykład: `divide (8, 4)` przykładowe wyjście: 2 Alternatywnie można również użyć: formuła: `number/divisor` przykład: `8/4` przykładowe wyjście: 2
podzielny	Sprawdza, czy liczba jest podzielna przez resztę. Jeśli nie ma reszty, ta funkcja zwróci wartość true. Jeśli występuje reszta, wartość funkcji będzie równa false. Użyj z następującymi funkcjami: number: liczba do podzielenia. divisor: liczba do podzielenia przez operację dzielenia.	formuła: `divisible(number, divisor)` przykład: `divisible (5,2)` przykładowe wyjście: false
dołączyć	Łączy dwa lub więcej ciągów w jeden ciąg wynikowy, używając separatora między każdą wartością. Ta funkcja jest dostępna tylko wtedy, gdy akcja Formatuj dane jest używana w trybie niestandardowym. Użyj z następującymi elementami: delimiter: ciąg znaków separatora, który zostanie wstawiony między każdym elementem. items: dowolna liczba ciągów znaków do połączenia.	formuła: `join(delimiter, items)` przykład: `join("-", "A", "B", "C")` Przykładowe wyjście: A-B-C
lewy	Zwraca podciąg znaków z wartości ciągu znaków od początku wartości ciągu znaków. Ta funkcja jest dostępna tylko wtedy, gdy akcja Formatuj dane jest używana w trybie niestandardowym.	formuła: `left(string, length)` przykład: `left("Maria", "1")` przykładowe wyjście: M
długość	Zwraca liczbę znaków w ciągu znaków.	formuła: `length(string)` przykład: `left("Hello World!")` przykładowe wyjście: 12
niższy	Konwertuje wszystkie znaki w ciągu znaków na małe litery.	formuła: `lower([string])` przykład: `lower(["HELLO WORLD"])` przykładowe wyjście: hello world
środek	Zwraca podciąg znaków z wartości ciągu znaków. Ta funkcja jest dostępna tylko wtedy, gdy akcja Formatuj dane jest używana w trybie niestandardowym.	formuła: `mid(string, start-index, length)` przykład: `join("abc123", 2, 2)` Przykładowe wyjście: c1
minus_time	Odejmuje określoną ilość czasu od obiektu daty/godziny. Używane z następującymi elementami: datetime: obiekt daty/czasu, od którego ma zostać odjęty czas. diff: ilość czasu do odjęcia. timeunit: jednostka czasu do odjęcia. Można użyć następujących wartości: sekundy minuty godziny half_days dni tygodnie miesiące lata	formuła: `minus_time(datetime, diff, timeunit)` przykład: `minus_time([closedate], 2, "days")` przykładowe wyjście: 04/11/2020
mnożnik	Mnoży wartość przez liczbę. Ta funkcja jest alternatywą dla operatora . Używana z następującymi funkcjami: number:* liczba do pomnożenia. multiplier : liczba do pomnożenia przez.	formuła: `multipler(number, multipler)` Przykład: `multiplier(5, 3)` przykładowe wyjście: 15 Alternatywnie można również użyć: *formuła: `numbermultipler` Przykład: `53`* przykładowe wyjście: 15
liczba	Konwertuje ciąg znaków na liczbę.	formuła: `number(string, default?)` przykład: `left("36")` przykładowe wyjście: 36
plus_time	Dodaje czas do obiektu daty/godziny. Użyj z następującymi elementami: datetime: obiekt daty/czasu, do którego ma zostać dodany czas. diff: ilość czasu do dodania. timeunit: jednostka czasu do dodania.	formuła: `plus_time(datetime, diff, timeunit)` przykład: `plus_time([closedate], 2, "days")` przykładowy wynik: 06/11/2020
randomNumber	Generuje liczbę losową w określonym zakresie. W przypadku tej funkcji generowane liczby są całkowicie losowe i mogą się powtarzać. Na przykład, jeśli użyto zakresu od jednego do trzech i zapisano trzy kontakty, nie można uzyskać trzech unikalnych numerów. W zakresie uwzględniane są zarówno liczby minimalne, jak i maksymalne. Podczas ustawiania zakresu można również użyć 0 i liczb ujemnych.	formuła: `randomNumber(minimum, maximum)` przykład: `randomNumber(1, 3)` Przykładowe wyjście: 1 lub 2
zastąpić	Zastępuje wszystkie wystąpienia podciągu innym ciągiem. Użyj z następującymi elementami: string: ciąg do wyszukania i zastąpienia. old: podciąg, który ma zostać zastąpiony. new: zastępowany ciąg znaków. count: liczba wystąpień podciągu do zastąpienia. Jeśli nie podano, wszystkie podciągi zostaną zastąpione	formuła: `replace(string, old, new, count)` przykład: `replace( "Hello world!", "Hello", "Hi", 1)` przykładowe wyjście: Hi world!
prawo	Zwraca podciąg znaków z wartości ciągu znaków od końca wartości ciągu znaków. Ta funkcja jest dostępna tylko wtedy, gdy akcja Formatuj dane jest używana w trybie niestandardowym.	formuła: `right(string, length)` przykład: `right("abc123", 3)` Przykładowe dane wyjściowe: 123
regex_replace	Wyszukuje wzorzec regex i zastępuje go podanym ciągiem znaków. Użyj z następującymi parametrami: original_string : oryginalny ciąg znaków do wyszukania. pattern: wzorzec regex do dopasowania. Informacje na temat składni RE2 można znaleźć tutaj. replacement_string: ciąg znaków do zastąpienia znakami dopasowanymi przez wzorzec.	formuła: `regex_replace(original_string, pattern, replacement_string)` przykład: `regex_replace("contact-us-2", "[^a-zA-Z]", "")` przykładowe wyjście: contactus
korzeń	Oblicza pierwiastek kwadratowy z liczby. Opcjonalnie można określić N-ty pierwiastek do obliczenia. Użyj z następującymi funkcjami: number: liczba do obliczenia pierwiastka z.Calculate the square root of a number. Opcjonalnie można określić N-ty pierwiastek do obliczenia nthRoot : n-ty pierwiastek do obliczenia. Jeśli nie zostanie określony, zostanie obliczony pierwiastek kwadratowy.	formuła: `root(number, nthRoot)` przykład: `root(625, 4)` przykładowe wyjście: 5
runda	Zaokrągla liczbę do określonego miejsca po przecinku. Użyj z następującymi funkcjami: precyzja: liczba dziesiętna do zaokrąglenia. metoda zaokrąglania: zaokrągla w górę lub w dół do najbliższej liczby całkowitej. Można użyć następujących metod zaokrąglania: common ceil podłoga	formuła: `round(number, precision, rounding method)` przykład: `round(52.5, 0, 'floor')` Przykładowe wyjście: 52
paski	Usuwa znaczniki SGML/XML i zastępuje sąsiadujące białe znaki jedną spacją. Filtr ten może być używany do usuwania wszelkich znaczników HTML ze zmiennej.	formuła: `striptags([string])` przykład: `striptags(<div><p>Potato</p></div>)` Przykładowe dane wyjściowe: Ziemniak
tytuł	Zmień wielkość liter w tekście na tytuł. Każde słowo w wynikowym ciągu rozpocznie się od wielkich liter, podczas gdy wszystkie pozostałe znaki będą małe.	formuła: `title([string])` przykład: `title("cheddar CHEESE")` Przykładowe dane wyjściowe: Cheddar Cheese
wykończenie	Usuwa początkowe i końcowe białe znaki z ciągu znaków.	formuła: `trim([string])` przykład: trim(" peach ") Przykładowe wyjście: brzoskwinia
unixtimestamp	Konwertuje obiekt daty/czasu na uniksowy znacznik czasu.	formuła: `unixtimestamp([dateteime])` przykład: `unixtimesstamp([closedate])` przykładowe dane wyjściowe: 16528638 24
górny	Zmień wszystkie znaki na wielkie litery.	formuła: `upper([string])` przykład: `upper("teatime")` przykładowe dane wyjściowe: TEATIME
urlencode	Escape i URL kodują ciąg znaków przy użyciu formatowania UTF-8.	formuła: `urlencode([string])` przykład: `urlencode("hi there")` przykładowe wyjście: hi%20there

Wyświetl kompletny wpis