Zum Hauptinhalt
Hinweis: Dieser Artikel wird aus Kulanz zur Verfügung gestellt. Er wurde automatisch mit einer Software übersetzt und unter Umständen nicht korrekturgelesen. Die englischsprachige Fassung gilt als offizielle Version und Sie können dort die aktuellsten Informationen finden. Hier können Sie darauf zugreifen.

Benutzerdefinierte Formelfunktionen

Zuletzt aktualisiert am: Februar 12, 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/Zeit-Objekt, dem die Zeit hinzugefügt werden soll.
  • diff: die Zeit, die hinzugefügt werden soll. 
  • timeunit: die Einheit der zu addierenden Zeit. 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: number*multipler
    • beispiel: 5*3 
    • 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
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?
Dieses Formular wird nur verwendet, um Feedback zur Dokumentation zu sammeln. Erfahren Sie, wie Sie Hilfe bei Fragen zu HubSpot erhalten können.