Salta al contenuto
Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

Utilizzare le funzioni di formula personalizzate durante la formattazione dei dati nei flussi di lavoro

Ultimo aggiornamento: 3 agosto 2026

Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:

Se utilizzi una formula personalizzata per formattare i dati in un flusso di lavoro, puoi utilizzare funzioni con i valori delle proprietà del record associato o gli output delle azioni precedenti per creare formule complesse.

Queste funzioni non si applicano alle proprietà di calcolo. Se desideri esaminare gli operatori, le funzioni e altre informazioni relative alle proprietà di calcolo, consulta invece la guida sulla creazione di proprietà di calcolo con equazioni personalizzate

 

Autorizzazioni richieste Per utilizzare lo strumento dei flussi di lavoro sono necessarie le autorizzazioni di Superamministratore o Flussi di lavoro.


Esamina le diverse funzioni riportate di seguito per determinare quale utilizzare: 

Funzione Descrizione Esempio
abs Recupera il valore assoluto di un numero. È possibile utilizzare questa funzione per verificare che un numero sia positivo.
  • formula di esempio: abs([numero o proprietà numerica])
    • esempio: abs(-10) 
    • risultato dell'esempio: 10
add Somma un valore numerico a un altro valore numerico. Questa funzione equivale all'operatore +. Utilizzarla con quanto segue: 
  • numero: il valore numerico iniziale per l'operazione.
  • numero da aggiungere: il numero da aggiungere al valore numerico iniziale. 
  • formula di esempio: add(number, number to add)
    • esempio: add(5, 10)
    • risultato dell'esempio: 15

In alternativa, è possibile utilizzare anche:

  • formula di esempio: number + number to add
    • esempio: 5+10
    • risultato di esempio: 15
concat Unisci più valori stringa. Questa funzione è disponibile solo quando l'azione " Formatta dati " viene utilizzata in modalità Personalizzata
  • formula di esempio:concat([string 1], " ", [string 2]) 
    • esempio: concat([company name], " ", [MonthYear])
    • risultato di esempio: HubSpot giugno 2006
maiuscola Mette in maiuscolo la prima lettera di un valore stringa. Il primo carattere sarà maiuscolo, mentre tutte le altre lettere saranno minuscole. Le altre parole nell’input non avranno la prima lettera maiuscola
  • formula di esempio: capitalize([string])
    • esempio: capitalize([firstname])
    • risultato di esempio: Henry
cut Taglia uno o più caratteri per rimuovere una stringa da un valore. Questa funzione può essere utilizzata per individuare e tagliare una parte specifica di una stringa. Il parametro specifica la parte della stringa che deve essere rimossa. Utilizzare con quanto segue: 
  • source: la stringa di origine da cui rimuovere i caratteri. 
  • caratteri_da_tagliare: i caratteri specifici da rimuovere. Questo formato distingue tra maiuscole e minuscole. 
  • formula: cut(source, characters to cut)
    • esempio: cut([phone], "-")
    • Esempio di output: 80081234567 


formato_data_ora

Nota: questa formula è stata deprecata e sostituita dalla funzione format_datetime riportata di seguito. Le azioni che utilizzano questa funzione continueranno a funzionare, ma d'ora in poi è consigliabile utilizzare la nuova funzione.

 
format_datetime Converte un timestamp in un formato di facile lettura. Includere il timestamp o la proprietà insieme ai seguenti parametri per configurarne il formato:
  • format: il formato da utilizzare. I valori possibili sono: 'short', 'medium', 'long', 'full' È inoltre possibile specificare un formato personalizzato utilizzando i modelli Unicode LDML.
  • timeZone: il fuso orario dei dati di output nel formato IANA TZDB. Per impostazione predefinita, restituisce l'ora UTC.
  • locale: le impostazioni locali da utilizzare per i formati sensibili alle impostazioni locali.
  • formula: format_datetime(date, format, timeZone, locale)
    • esempio: format_datetime([closedate], 'medium', 'America/New_York, 'de-DE')
    • Esempio di output: 08.02.2024, 17:09:49
divide Divide un numero. Questa funzione è un'alternativa all'operatore /. Utilizzarla con quanto segue: 
  • numero: il numero da dividere. 
  • divisore: il numero per cui eseguire la divisione. 
  • formula: divide(number, divisor)
    • esempio: divide (8, 4)
    • risultato di esempio: 2

In alternativa, è possibile utilizzare anche: 

  • formula: number/divisor
    • esempio: 8/4
    • risultato di esempio: 2
divisibile Verifica se un numero è divisibile senza resto. Se non c'è resto, questa funzione restituisce "vero". Se c'è un resto, questa funzione restituisce "falso". Da utilizzare con quanto segue: 
  • numero: il numero da dividere. 
  • divisore: il numero per cui eseguire la divisione. 
  • formula: divisible(number, divisor)
    • esempio: divisible (5,2)
    • risultato di esempio: false
unisci Unisci due o più stringhe in un'unica stringa di risultato, utilizzando un separatore tra ciascun valore. Questa funzione è disponibile solo quando l'azione " Formatta dati " viene utilizzata in modalità Personalizzata

Da utilizzare con quanto segue: 
  • delimitatore: una stringa di separazione da inserire tra ogni elemento.
  • elementi: un numero qualsiasi di stringhe da unire. 
  • formula: join(delimiter, items)
    • esempio: join("-", "A", "B", "C")
    • Esempio di output: A-B-C
sinistra Restituisce una sottostringa di caratteri a partire dall'inizio di una stringa. Questa funzione è disponibile solo quando l'azione " Formatta dati " viene utilizzata in modalità Personalizzata.
  • formula: left(string, length)
    • esempio: left("Maria", "1")
    • Esempio di output: M


lunghezza Restituisce il numero di caratteri presenti in una stringa.
  • formula: length(string)
    • esempio: left("Hello World!")
    • Esempio di output: 12
lower Converte tutti i caratteri di una stringa in lettere minuscole.
  • formula: lower([string])
    • esempio: lower(["HELLO WORLD"])
    • Esempio di output: hello world
mid Restituisce una sottostringa di caratteri da un valore di stringa. Questa funzione è disponibile solo quando l'azione " Formatta dati " viene utilizzata in modalità Personalizzata.
  • formula: mid(string, start-index, length)
    • esempio: join("abc123", 2, 2)
    • Esempio di output: c1
minus_time Sottrae un intervallo di tempo da un oggetto data/ora. Da utilizzare con quanto segue: 
  • datetime: l'oggetto data/ora da cui sottrarre il tempo.
  • diff: l'intervallo di tempo da sottrarre. 
  • timeunit: l'unità di tempo da sottrarre. È possibile utilizzare quanto segue: 
    • secondi
    • minuti
    • ore
    • mezze_giornate
    • giorni
    • settimane
    • mesi
    • anni
  • formula: minus_time(datetime, diff, timeunit)
    • esempio: minus_time([closedate], 2, "days")
    • Esempio di output: 11/04/2020
moltiplicatore Moltiplica un valore per un numero. Questa funzione è un'alternativa all'operatore *. Utilizzarla con quanto segue: 
  • numero: il numero da moltiplicare.
  • moltiplicatore: il numero per cui moltiplicare. 
  • formula: multipler(number, multipler)
    • esempio:multiplier(5, 3) 
    • Esempio di output: 15

In alternativa, è possibile utilizzare anche:

  • formula: number*multipler
    • esempio: 5*3 
    • risultato di esempio: 15
numero Converte una stringa in un numero.
  • formula: number(string, default?)
    • esempio: left("36")
    • Esempio di risultato: 36
plus_time Aggiunge un intervallo di tempo a un oggetto data/ora. Da utilizzare con quanto segue: 
  • datetime: l'oggetto data/ora a cui aggiungere il tempo.
  • diff: l'intervallo di tempo da aggiungere. 
  • timeunit: l'unità di tempo da aggiungere. 
  • formula: plus_time(datetime, diff, timeunit)
    • esempio: plus_time([closedate], 2, "days")
    • Esempio di output: 11/06/2020


numeroCasuale Genera un numero casuale all'interno di un intervallo.

Con questa funzione, i numeri generati sono completamente casuali e potrebbero ripetersi. Ad esempio, se si utilizza un intervallo compreso tra uno e tre e si inseriscono tre contatti, è possibile che non si ottengano tre numeri distinti. 

Sia il numero minimo che quello massimo sono inclusi nell'intervallo. È inoltre possibile utilizzare lo 0 e i numeri negativi quando si imposta l'intervallo. 
  • formula: randomNumber(minimum, maximum)
    • esempio: randomNumber(1, 3)
    • Esempio di output: 1 o 2
sostituisci Sostituisci tutte le occorrenze di una sottostringa con una stringa diversa. Utilizzare con quanto segue: 
  • string: la stringa da cercare e sostituire. 
  • vecchia: la sottostringa da sostituire. 
  • nuova: la stringa di sostituzione. 
  • count: il numero di occorrenze della sottostringa da sostituire. Se non specificato, verranno sostituite tutte le sottostringhe
  • formula: replace(string, old, new, count)
    • esempio: replace( "Hello world!", "Hello", "Hi", 1)
    • Esempio di output: Hi world!
right Restituisce una sottostringa di caratteri a partire dalla fine di una stringa. Questa funzione è disponibile solo quando l’azione “Formatta dati” viene utilizzata in modalità Personalizzata.
  • formula: right(string, length)
    • esempio: right("abc123", 3)
    • Esempio di output: 123
regex_replace Cerca un pattern regex e lo sostituisce con la stringa specificata. Da utilizzare con i seguenti parametri:
  • original_string: lastringa originale in cui effettuare la ricerca.
  • pattern: ilmodello di espressione regolare da cercare. Le informazioni sulla sintassi RE2 sono disponibili qui.
  • replacement_string: la stringa con cui sostituire i caratteri trovati dal pattern.
  • formula: regex_replace(original_string, pattern, replacement_string)
    • esempio: regex_replace("contact-us-2", "[^a-zA-Z]", "")
    • Esempio di output: contactus
radice Calcola la radice quadrata di un numero. Facoltativamente, specifica la radice N-esima da calcolare. Utilizzare con quanto segue:
  • numero: il numero di cui calcolare la radice. Calcola la radice quadrata di un numero. Facoltativamente, specificare la radice N-esima da calcolare 
  • nthRoot: la radice n-esima da calcolare. Se non specificata, verrà calcolata la radice quadrata. 
  • formula: root(number, nthRoot)
    • esempio: root(625, 4)
    • Esempio di output: 5
arrotondare Arrotonda un numero a un numero decimale specificato. Da utilizzare con quanto segue:
  • precision: il numero di cifre decimali a cui arrotondare. 
  • metodo di arrotondamento: arrotondare per eccesso o per difetto al numero intero più vicino. È possibile utilizzare i seguenti metodi di arrotondamento: 
    • common
    • ceil
    • floor
  • formula: round(number, precision, rounding method)
    • esempio: round(52.5, 0, 'floor')
    • Esempio di risultato: 52
striptags Rimuove i tag SGML/XML e sostituisce gli spazi bianchi adiacenti con un unico spazio. Questo filtro può essere utilizzato per rimuovere eventuali tag HTML da una variabile.
  • formula: striptags([string])
    • esempio: striptags(<div><p>Potato</p></div>)
    • risultato di esempio: Potato
title Converte il testo in maiuscolo-minuscolo. Ogni parola nella stringa risultante inizierà con lettere maiuscole, mentre tutti gli altri caratteri saranno minuscoli.
  • formula: title([string])
    • esempio: title("cheddar CHEESE")
    • Esempio di output: Formaggio Cheddar
trim Rimuove gli spazi iniziali e finali da una stringa.
  • formula: trim([string])
    • esempio: trim("pesca ")
    • Risultato dell'esempio: pesca
unixtimestamp Converte un oggetto data/ora in un timestamp Unix.
  • formula: unixtimestamp([dateteime])
    • esempio: unixtimesstamp([closedate])
    • Esempio di output: 1652863824
upper Converte tutti i caratteri in maiuscolo.
  • formula: upper([string])
    • esempio: upper("teatime")
    • Esempio di output: TEATIME
urlencode Esegue l'escape e la codifica URL di una stringa utilizzando la formattazione UTF-8.
  • formula: urlencode([string])
    • esempio: urlencode("hi there")
    • Esempio di output: hi%20there
L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.