Ignorer et passer au contenu principal
Avertissement : cet article est le résultat de la traduction automatique, l'exactitude et la fidélité de la traduction ne sont donc pas garanties. Pour consulter la version originale de cet article, en anglais, cliquez ici.

Fonctions de formules personnalisées

Dernière mise à jour: octobre 9, 2024

Disponible avec le ou les abonnements suivants, sauf mention contraire :

Operations Hub   Pro , Enterprise

Si vous utilisez une formule personnalisée pour formater vos données dans un Workflow, vous pouvez utiliser des fonctions avec des valeurs de propriété de l'enregistrement enrôlé ou des résultats d'actions précédentes pour créer des formules complexes. 

Passez en revue les différentes fonctions ci-dessous pour déterminer celle à utiliser : 

Fonction Description Exemple
abs Récupérer la valeur absolue d'un nombre. Vous pouvez utiliser cette fonction pour vous assurer qu'un nombre est positif.
  • exemple de formule : abs([nombre ou propriété du nombre])
    • exemple : abs(-10) 
    • exemple de sortie : 10
add Ajoute une valeur numérique à une autre valeur numérique. Cette fonction est la même que l'opérateur +. A utiliser avec les produits suivants :
  • nombre : la valeur numérique initiale de l'opération.
  • nombre à ajouter : le nombre à ajouter à la valeur numérique initiale. 
  • exemple de formule : add(number, number to add)
    • exemple : add(5, 10)
    • exemple de sortie : 15

Vous pouvez également utiliser :

  • exemple de formule : number + number to add
    • exemple : 5+10
    • exemple de sortie : 15
concat Combine plusieurs valeurs de chaîne. Cette fonction n'est disponible que lorsque l'action Format des données est utilisée en mode personnalisé
  • exemple de formule :concat([string 1], " ", [string 2]) 
    • exemple : concat([company name], " ", [MonthYear])
    • exemple de sortie : HubSpot juin 2006
capitalize Mettre en majuscule la première lettre d'une valeur de chaîne. Le premier caractère sera en majuscule, tandis que toutes les autres lettres seront en minuscules. Les autres mots de l'entrée n'auront pas leur première lettre en majuscule
  • exemple de formule : capitalize([string])
    • exemple : capitalize([firstname])
    • exemple de sortie : Henry
cut Coupe un ou plusieurs caractères pour supprimer une chaîne de caractères d'une valeur. Cette fonction peut être utilisée pour faire correspondre et couper une partie spécifique d'une chaîne de caractères. Le paramètre indique la partie de la chaîne qui doit être supprimée. A utiliser avec les produits suivants :
  • source : la chaîne de caractères source dont il faut supprimer les caractères. 
  • characters_to_cut : les caractères spécifiques à supprimer. Ce format est sensible à la casse. 
  • formule : cut(source, characters to cut)
    • exemple : cut([phone], "-")
    • exemple de sortie : 80081234567 


datetimeformat

Remarque : cette formule est obsolète et remplacée par la fonction format_datetime ci-dessous. Les actions utilisant cette fonction continueront à fonctionner, mais la nouvelle fonction devra être utilisée à l'avenir.

 
format_datetime Convertir un horodatage dans un format convivial. Inclure l'horodatage ou la propriété avec les paramètres suivants pour configurer son format :
  • format : le format à utiliser. Les valeurs comprennent : 'short', 'medium' , 'long' , 'full'. Vous pouvez également spécifier un format personnalisé en utilisant Unicode LDML patterns.
  • timeZone : le fuseau horaire des données de sortie au format IANA TZDB. Par défaut, renvoie l'heure UTC.
  • locale : la locale à utiliser pour les formats sensibles à la langue.
  • formule : format_datetime(date, format, timeZone, locale)
    • exemple : format_datetime([closedate], 'medium', 'America/New_York, 'de-DE')
    • exemple de sortie : 08.02.2024, 17:09:49
divide Diviser un nombre. Cette fonction est une alternative à l'opérateur /. A utiliser avec les produits suivants :
  • nombre : le nombre à diviser. 
  • diviseur : le nombre par lequel il faut diviser pour l'opération de division. 
  • formule : divide(number, divisor)
    • exemple : divide (8, 4)
    • exemple de sortie : 2

Vous pouvez également utiliser : 

  • formule : number/divisor
    • exemple : 8/4
    • exemple de sortie : 2
divisible Testez si un nombre est divisible de manière égale. S'il n'y a pas de reste, cette fonction sera évaluée à true. S'il y a un reste, cette fonction sera évaluée à faux. A utiliser avec les produits suivants :
  • nombre : le nombre à diviser. 
  • diviseur : le nombre par lequel il faut diviser pour l'opération de division. 
  • formule : divisible(number, divisor)
    • exemple : divisible (5,2)
    • exemple de sortie : false
join Combinez deux chaînes ou plus dans une chaîne obtenue, en utilisant un séparateur entre toutes les valeurs. Cette fonction n'est disponible que lorsque l'action Format des données est utilisée en mode personnalisé

A utiliser avec les produits suivants :
  • delimiter : une chaîne de séparation à insérer entre chaque élément.
  • items : un nombre quelconque de chaînes de caractères à combiner. 
  • formule : join(delimiter, items)
    • exemple : join("-", "A", "B", "C")
    • exemple de sortie : A-B-C
gauche Renvoie une sous-chaîne de caractères d'une valeur de chaîne à partir du début d'une valeur de chaîne. Cette fonction n'est disponible que lorsque l'action Format des données est utilisée en mode personnalisé.
  • formule : left(string, length)
    • exemple : left("Maria", "1")
    • exemple de sortie : M


length Renvoie le nombre de caractères d'une chaîne de caractères.
  • formule : length(string)
    • exemple : left("Hello World!")
    • exemple de sortie : 12
lower Convertit tous les caractères d'une chaîne en lettres minuscules.
  • formule : lower([string])
    • exemple : lower(["HELLO WORLD"])
    • exemple de sortie : hello world
milieu du site Renvoie une sous-chaîne de caractères à partir d'une valeur de chaîne. Cette fonction n'est disponible que lorsque l'action Format des données est utilisée en mode personnalisé.
  • formule : mid(string, start-index, length)
    • exemple : join("abc123", 2, 2)
    • exemple de sortie : c1
minus_time Soustrait une durée d'un objet date/heure. A utiliser avec les produits suivants :
  • datetime : l'objet date/heure auquel ajouter du temps.
  • diff : le temps à ajouter. 
  • timeunit : l'unité de temps à ajouter. Les éléments suivants peuvent être utilisés : 
    • secondes
    • minutes
    • heures
    • demi-journées
    • jours
    • semaines
    • mois
    • ans
  • formule : minus_time(datetime, diff, timeunit)
    • exemple : minus_time([closedate], 2, "days")
    • exemple de sortie : 04/11/2020
multiplicateur Multiplie une valeur par un nombre. Cette fonction est une alternative à l'opérateur *. A utiliser avec les produits suivants :
  • nombre : le nombre à multiplier.
  • multiplicateur : le nombre à multiplier par. 
  • formule : multipler(number, multipler)
    • exemple : multiplier(5, 3) 
    • exemple de sortie : 15

Vous pouvez également utiliser :

  • formule : number*multipler
    • exemple : 5*3 
    • exemple de sortie : 15
number Convertit une chaîne de caractères en un nombre.
  • formule : number(string, default?)
    • exemple : left("36")
    • exemple de sortie : 36
plus_time Ajoute une quantité de temps à un objet date/heure. A utiliser avec les produits suivants :
  • datetime : l'objet date/heure auquel ajouter du temps.
  • diff : le temps à ajouter. 
  • timeunit : l'unité de temps à ajouter. 
  • formule : plus_time(datetime, diff, timeunit)
    • exemple : plus_time([closedate], 2, "days")
    • exemple de sortie : 06/11/2020


nombre aléatoire Générer un nombre aléatoire dans une plage.

Avec cette fonction, les numéros générés sont totalement aléatoires et peuvent se répéter. Par exemple, si vous avez utilisé une fourchette de un à trois et inscrit trois contacts, vous n'obtiendrez peut-être pas trois numéros uniques. 

Les nombres minimum et maximum sont inclus dans la fourchette. Vous pouvez également utiliser 0 et des nombres négatifs lorsque vous définissez votre fourchette. 
  • formule : randomNumber(minimum, maximum)
    • exemple : randomNumber(1, 3)
    • exemple de sortie : 1 ou 2
replace Remplacez toutes les instances d'une sous-chaîne par une autre chaîne. A utiliser avec les produits suivants :
  • chaîne : la chaîne à rechercher et à remplacer. 
  • old : la sous-chaîne qui doit être remplacée. 
  • nouveau : la chaîne de remplacement. 
  • count : le nombre d'instances de la sous-chaîne à remplacer. Si elle n'est pas fournie, toutes les sous-chaînes seront remplacées
  • formule : replace(string, old, new, count)
    • exemple : replace( "Hello world!", "Hello", "Hi", 1)
    • exemple de sortie : Salut le monde !
droite Renvoie une sous-chaîne de caractères d'une valeur de chaîne à partir de la fin d'une valeur de chaîne. Cette fonction n'est disponible que lorsque l'action Format des données est utilisée en mode personnalisé.
  • formule : right(string, length)
    • exemple : right("abc123", 3)
    • exemple de sortie : 123
regex_replace Recherche un motif regex et le remplace par la chaîne fournie. A utiliser avec les paramètres suivants :
  • original_string : la chaîne originale dans laquelle la recherche doit être effectuée.
  • motif : le motif de l'expression rationnelle à utiliser. Des informations sur la syntaxe RE2 sont disponibles à l'adresse et à l'adresse.
  • chaîne_de_remplacement : la chaîne par laquelle remplacer les caractères correspondant au motif.
  • formule : regex_replace(original_string, pattern, replacement_string)
    • exemple : regex_replace("contact-us-2", "[^a-zA-Z]", "")
    • exemple de sortie : contactus
root Calculez la racine carrée d'un nombre. En option, spécifiez la Nième racine à calculer. A utiliser avec les produits suivants :
  • nombre : le nombre dont il faut prendre la racine Calculer la racine carrée d'un nombre. En option, spécifiez la Nième racine à calculer 
  • nthRoot : la nième racine à calculer. Si elle n'est pas spécifiée, la racine carrée sera prise. 
  • formule : root(number, nthRoot)
    • exemple : root(625, 4)
    • exemple de sortie : 5
round Arrondir un nombre à une décimale spécifiée. A utiliser avec les produits suivants :
  • précision : la décimale à arrondir. 
  • méthode d'arrondi : arrondir au nombre entier supérieur ou inférieur le plus proche. Les méthodes d'arrondi suivantes peuvent être utilisées : 
    • commun
    • plafond
    • sol
  • formule : round(number, precision, rounding method)
    • exemple : round(52.5, 0, 'floor')
    • exemple de sortie : 52
striptags Efface les balises SGML/XML et remplace les espaces blancs adjacents par un espace. Ce filtre peut être utilisé pour supprimer toutes les balises HTML d'une variable.
  • formule : striptags([string])
    • exemple : striptags(<div><p>Potato</p></div>)
    • exemple de sortie : Pomme de terre
title Changer le texte en casse de titre. Chaque mot de la chaîne résultante commencera par des lettres majuscules, tandis que tous les autres caractères seront en minuscules.
  • formule : title([string])
    • exemple : title("cheddar CHEESE")
    • exemple de sortie : Fromage Cheddar
trim Supprimez les espaces de début et de fin d'une chaîne.
  • formule : trim([string])
    • exemple : trim(" peach ")
    • exemple de sortie : peach
unixtimestamp Convertissez un objet date/heure en horodatage Unix.
  • formule : unixtimestamp([dateteime])
    • exemple : unixtimesstamp([closedate])
    • exemple de sortie : 1652863824
upper Écrivez tous les caractères en majuscules.
  • formule : upper([string])
    • exemple : upper("teatime")
    • exemple de sortie : TEATIME
urlencode Quittez et encoder l'URL d'une chaîne utilisant le formatage UTF-8.
  • formule : urlencode([string])
    • exemple : urlencode("hi there")
    • exemple de sortie : hi%20there
Cet article vous a-t-il été utile ?
Ce formulaire n'est utilisé que pour recueillir du feedback sur la documentation. Découvrez comment obtenir de l'aide sur HubSpot.