Hinweis: Dieser Artikel wird aus Kulanz zur Verfügung gestellt.

Benutzerdefinierte Formelfunktionen

Zuletzt aktualisiert am: November 5, 2024

Mit einem der folgenden Abonnements verfügbar (außer in den angegebenen Fällen):

Operations Hub Professional , Enterprise

Wenn Sie eine benutzerdefinierte Formel verwenden, um Ihre Daten in einem Workflow zu formatieren, können Sie Funktionen mit Eigenschaftswerten aus dem erfassten Datensatz oder Ausgaben aus früheren Aktionen verwenden, um komplexe Formeln zu erstellen.

Sehen Sie sich die verschiedenen Funktionen unten an, um zu entscheiden, welche Sie verwenden möchten:

Funktion	Beschreibung	Beispiel
abs	Abrufen des Absolutwerts einer Zahl. Sie können diese Funktion verwenden, um sicherzustellen, dass eine Zahl positiv ist.	beispielformel: abs([Zahl oder Zahleneigenschaft]) beispiel: `abs(-10)` beispiel-Ausgabe: 10
add	Addiert einen numerischen Wert zu einem anderen numerischen Wert. Diese Funktion ist die gleiche wie der Operator +. Zur Verwendung mit den folgenden Produkten: zahl: der numerische Ausgangswert für die Operation. zu addierende Zahl: die Zahl, die zum ursprünglichen numerischen Wert addiert werden soll.	beispielformel: `add(number, number to add)` beispiel: `add(5, 10)` beispielausgabe: 15 Alternativ können Sie auch verwenden: beispielformel: `number + number to add` beispiel: `5+10` beispielausgabe: 15
konkaten	Kombinieren Sie mehrere String-Werte. Diese Funktion ist nur verfügbar, wenn die Aktion Daten formatieren im benutzerdefinierten Modusverwendet wird.	beispielformel:`concat([string 1], " ", [string 2])` beispiel: `concat([company name], " ", [MonthYear])` beispiel-Ausgabe: HubSpot Juni 2006
capitalize	Großschreibung des ersten Buchstabens einer Zeichenkette. Das erste Zeichen wird in Großbuchstaben geschrieben, alle anderen Buchstaben werden kleingeschrieben. Bei anderen Wörtern in der Eingabe wird der erste Buchstabe nicht in Großbuchstaben geschrieben	beispielformel: `capitalize([string])` beispiel: `capitalize([firstname])` beispiel-Ausgabe: Henry
cut	Schneidet ein Zeichen oder mehrere Zeichen aus, um eine Zeichenfolge aus einem Wert zu entfernen. Diese Funktion kann verwendet werden, um einen bestimmten Teil einer Zeichenkette abzugleichen und auszuschneiden. Der Parameter gibt den Teil des Strings an, der entfernt werden soll. Zur Verwendung mit den folgenden Produkten: source: die Quellzeichenkette, aus der Zeichen entfernt werden sollen. characters_to_cut: die spezifischen Zeichen, die entfernt werden sollen. Bei diesem Format wird zwischen Groß- und Kleinschreibung unterschieden.	formel: `cut(source, characters to cut)` beispiel: `cut([phone], "-")` beispiel-Ausgabe: 80081234567
datetimeformat	Bitte beachten Sie: diese Formel ist veraltet und wurde durch die folgende Funktion `format_datetime` ersetzt. Aktionen, die diese Funktion verwenden, werden weiterhin funktionieren, aber die neue Funktion sollte in Zukunft verwendet werden.
format_datetime	Konvertiert einen Zeitstempel in ein menschenfreundliches Format. Fügen Sie den Zeitstempel oder die Eigenschaft zusammen mit den folgenden Parametern ein, um ihr Format zu konfigurieren: format: das zu verwendende Format. Die Werte umfassen: `'short'`, `'medium'` , `'long'` , `'full'`. Sie können auch ein benutzerdefiniertes Format angeben, indem Sie Unicode LDML patternsverwenden. timeZone: die Zeitzone der Ausgabedaten im Format IANA TZDB. Standardmäßig wird die UTC-Zeit zurückgegeben. locale: das Gebietsschema, das für sprachabhängige Formate verwendet wird.	formel: `format_datetime(date, format, timeZone, locale)` beispiel: `format_datetime([closedate], 'medium', 'America/New_York, 'de-DE')` beispiel-Ausgabe: `08.02.2024, 17:09:49`
divide	Teilen Sie eine Zahl. Diese Funktion ist eine Alternative zum Operator /. Zur Verwendung mit den folgenden Produkten: zahl: die zu teilende Zahl. divisor: die Zahl, durch die geteilt werden soll, um die Operation zu teilen.	formel: `divide(number, divisor)` beispiel: `divide (8, 4)` beispiel-Ausgabe: 2 Alternativ können Sie auch verwenden: formel: `number/divisor` beispiel: `8/4` beispiel-Ausgabe: 2
divisible	Prüfen, ob eine Zahl gleichmäßig teilbar ist. Wenn es keinen Rest gibt, wird diese Funktion als wahr ausgewertet. Wenn es einen Rest gibt, wird diese Funktion als false ausgewertet. Zur Verwendung mit den folgenden Produkten: zahl: die zu teilende Zahl. divisor: die Zahl, durch die geteilt werden soll, um die Operation zu teilen.	formel: `divisible(number, divisor)` beispiel: `divisible (5,2)` beispielausgabe: false
join	Kombinieren Sie zwei oder mehr Zeichenfolgen, indem Sie ein Trennzeichen zwischen den einzelnen Werten verwenden. Diese Funktion ist nur verfügbar, wenn die Aktion Daten formatieren im benutzerdefinierten Modusverwendet wird. Zur Verwendung mit den folgenden Produkten: delimiter: eine Trennzeichenfolge, die zwischen den einzelnen Einträgen eingefügt wird. items: eine beliebige Anzahl von zu kombinierenden Zeichenketten.	formel: `join(delimiter, items)` beispiel: `join("-", "A", "B", "C")` beispiel-Ausgabe: A-B-C
links	Gibt eine Teilzeichenkette von Zeichen aus einem Zeichenkettenwert von einem Anfang eines Zeichenkettenwerts zurück. Diese Funktion ist nur verfügbar, wenn die Aktion Daten formatieren im benutzerdefinierten Modusverwendet wird.	formel: `left(string, length)` beispiel: `left("Maria", "1")` beispiel-Ausgabe: M
length	Gibt die Anzahl der Zeichen in einer Zeichenfolge zurück.	formel: `length(string)` beispiel: `left("Hello World!")` beispielausgabe: 12
lower	Konvertiert alle Zeichen in einer Zeichenkette in Kleinbuchstaben.	formel: `lower([string])` beispiel: `lower(["HELLO WORLD"])` beispielausgabe: Hallo Welt
mitte	Gibt eine Teilzeichenkette aus einem Zeichenfolgenwert zurück. Diese Funktion ist nur verfügbar, wenn die Aktion Daten formatieren im benutzerdefinierten Modusverwendet wird.	formel: `mid(string, start-index, length)` beispiel: `join("abc123", 2, 2)` beispielausgabe: c1
minus_time	Subtrahiert eine Zeitspanne von einem Datum/Zeit-Objekt. Zur Verwendung mit den folgenden Produkten: datetime: das Datum/Uhrzeit-Objekt, von dem die Zeit abgezogen wird. diff: die zu subtrahierende Zeitspanne. timeunit: die Zeiteinheit, die subtrahiert werden soll. Folgendes kann verwendet werden: Sekunden Minuten Stunden halbe_Tage Tagen Wochen Monaten Jahre	formel: `minus_time(datetime, diff, timeunit)` beispiel: `minus_time([closedate], 2, "days")` beispiel Ausgabe: 04/11/2020
multiplikator	Multipliziert einen Wert mit einer Zahl. Diese Funktion ist eine Alternative zum Operator . Zur Verwendung mit den folgenden Produkten: zahl:* die zu multiplizierende Zahl. multiplikator: die Zahl, mit der multipliziert wird.	formel: `multipler(number, multipler)` beispiel: `multiplier(5, 3)` beispielausgabe: 15 Alternativ können Sie auch verwenden: *formel: `numbermultipler` beispiel: `53`* beispielausgabe: 15
number	Wandelt eine Zeichenkette in eine Zahl um.	formel: `number(string, default?)` beispiel: `left("36")` beispielausgabe: 36
_time	Hinzufügen einer Zeitspanne zu einem Datum/Zeit-Objekt. Zur Verwendung mit den folgenden Produkten: datetime: das Datum/Zeit-Objekt, dem die Zeit hinzugefügt werden soll. diff: die Zeit, die hinzugefügt werden soll. timeunit: die Einheit der zu addierenden Zeit.	formel: `plus_time(datetime, diff, timeunit)` beispiel: `plus_time([closedate], 2, "days")` beispiel Ausgabe: 06/11/2020
randomNumber	Erzeugen einer Zufallszahl innerhalb eines Bereichs. Bei dieser Funktion werden die Zahlen nach dem Zufallsprinzip erzeugt und können sich wiederholen. Wenn Sie z. B. einen Bereich von eins bis drei verwenden und drei Kontakte einschreiben, erhalten Sie möglicherweise nicht drei eindeutige Nummern. Sowohl die Mindest- als auch die Höchstwerte sind in der Spanne enthalten. Sie können auch 0 und negative Zahlen verwenden, wenn Sie Ihren Bereich festlegen.	formel: `randomNumber(minimum, maximum)` beispiel: `randomNumber(1, 3)` beispiel Ausgang: 1 oder 2
replace	Ersetzt alle Instanzen einer Teilzeichenfolge durch eine andere Zeichenfolge. Zur Verwendung mit den folgenden Produkten: string: die zu suchende und zu ersetzende Zeichenfolge. old: die Teilzeichenkette, die ersetzt werden soll. neu: die Ersatzzeichenfolge. count: die Anzahl der Instanzen der zu ersetzenden Teilzeichenkette. Wenn nicht angegeben, werden alle Teilstrings ersetzt	formel: `replace(string, old, new, count)` beispiel: `replace( "Hello world!", "Hello", "Hi", 1)` beispiel-Ausgabe: Hallo Welt!
rechts	Gibt eine Teilzeichenkette von Zeichen aus einem Zeichenkettenwert ab dem Ende eines Zeichenkettenwerts zurück. Diese Funktion ist nur verfügbar, wenn die Aktion Daten formatieren im benutzerdefinierten Modusverwendet wird.	formel: `right(string, length)` beispiel: `right("abc123", 3)` beispiel-Ausgabe: 123
regex_replace	Sucht nach einem Regex-Muster und ersetzt es durch die angegebene Zeichenkette. Verwendet mit den folgenden Parametern: original_string: die ursprüngliche Zeichenkette, in der gesucht werden soll. pattern: das Regex-Muster für die Übereinstimmung. Informationen zur RE2-Syntax finden Sie unter hier. ersatz_zeichenkette: die Zeichenkette, durch die die vom Muster übereinstimmenden Zeichen ersetzt werden sollen.	formel: `regex_replace(original_string, pattern, replacement_string)` beispiel: `regex_replace("contact-us-2", "[^a-zA-Z]", "")` beispiel Ausgang: contactus
root	Berechnen Sie die Quadratwurzel einer Zahl. Optional können Sie die N-te Wurzel angeben, die berechnet werden soll. Zur Verwendung mit den folgenden Produkten: zahl: die Zahl, aus der die Wurzel gezogen werden soll, um die Quadratwurzel aus einer Zahl zu berechnen. Optional können Sie die N-te Wurzel zur Berechnung angeben nthRoot: die n-te zu berechnende Wurzel. Wenn nicht angegeben, wird die Quadratwurzel genommen.	formel: `root(number, nthRoot)` beispiel: `root(625, 4)` beispiel-Ausgabe: 5
round	Rundet eine Zahl auf eine bestimmte Dezimalzahl. Zur Verwendung mit den folgenden Produkten: genauigkeit: die Dezimalstelle, auf die gerundet werden soll. rundungsmethode: Auf- oder Abrunden auf die nächste ganze Zahl. Die folgenden Rundungsmethoden können verwendet werden: gemeinsame decke boden	formel: `round(number, precision, rounding method)` beispiel: `round(52.5, 0, 'floor')` beispielausgabe: 52
striptags	Entfernt SGML/XML-Tags und ersetzt angrenzende Leerzeichen durch ein einziges Leerzeichen. Dieser Filter kann verwendet werden, um alle HTML-Tags aus einer Variablen zu entfernen.	formel: `striptags([string])` beispiel: `striptags(<div><p>Potato</p></div>)` beispiel-Ausgabe: Kartoffel
title	Text in Titelgehäuse ändern. Jedes Wort in der resultierenden Zeichenfolge beginnt mit einem Großbuchstaben, während alle übrigen Zeichen klein geschrieben werden.	formel: `title([string])` beispiel: `title("cheddar CHEESE")` beispiel-Ausgabe: Cheddar-Käse
trim	Entfernt vor- und nachgestellte Leerzeichen von einer Zeichenfolge.	formel: `trim([string])` beispiel: trim(" pfirsich ") beispielausgabe: Pfirsich
unixtimestamp	Konvertiert ein Datum/Zeit-Objekt in einen Unix-Zeitstempel.	formel: `unixtimestamp([dateteime])` beispiel: `unixtimesstamp([closedate])` beispielausgabe: 1652863824
upper	Alle Zeichen in Großbuchstaben ändern.	formel: `upper([string])` beispiel: `upper("teatime")` beispiel-Ausgabe: TEATIME
urlencode	Escape und URL-Kodierung für eine Zeichenfolge mit UTF-8-Formatierung.	formel: `urlencode([string])` beispiel: `urlencode("hi there")` beispielausgabe: hi%20there

War dieser Artikel hilfreich? Ja Nein

Dieses Formular wird nur verwendet, um Feedback zur Dokumentation zu sammeln. Erfahren Sie, wie Sie Hilfe bei Fragen zu HubSpot erhalten können.

Benutzerdefinierte Formelfunktionen

Mit einem der folgenden Abonnements verfügbar (außer in den angegebenen Fällen):

Verwandte Artikel