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.

Funzioni di formula personalizzate

Ultimo aggiornamento: novembre 5, 2024

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

Operations Hub   Professional , Enterprise

Se si utilizza una formula personalizzata per formattare i dati in un flusso di lavoro, è possibile utilizzare funzioni con valori di proprietà del record iscritto o output di azioni precedenti per creare formule complesse.

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

Funzione Descrizione Esempio
addominali Recupera il valore assoluto di un numero. È possibile utilizzare questa funzione per assicurarsi che un numero sia positivo.
  • formula di esempio: abs([numero o proprietà numerica])
    • esempio: abs(-10)
    • esempio di uscita: 10
aggiungere Aggiunge un valore numerico a un altro valore numerico. Questa funzione è identica all'operatore +. Si utilizza con i seguenti elementi:
  • 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)
    • esempio di uscita: 15

In alternativa, è possibile utilizzare anche:

  • formula di esempio: number + number to add
    • esempio: 5+10
    • esempio di uscita: 15
concat Combina più valori stringa. Questa funzione è disponibile solo quando l'azione Formatta i dati viene utilizzata in modalità Personalizzata.
  • esempio di formula:concat([string 1], " ", [string 2])
    • esempio: concat([company name], " ", [MonthYear])
    • esempio di output: HubSpot giugno 2006
capitalizzare Capitalizza la prima lettera di un valore di stringa. Il primo carattere sarà maiuscolo, mentre tutte le altre lettere saranno minuscole. Le altre parole presenti nell'input non avranno la prima lettera in maiuscolo.
  • formula di esempio: capitalize([string])
    • esempio: capitalize([firstname])
    • esempio di output: Henry
taglio Taglia un carattere o più caratteri per rimuovere una stringa da un valore. Questa funzione può essere utilizzata per abbinare e tagliare una parte specifica di una stringa. Il parametro specifica la parte della stringa che deve essere rimossa. Da utilizzare con i seguenti comandi:
  • sorgente: la stringa sorgente da cui rimuovere i caratteri.
  • caratteri_da_tagliare: i caratteri specifici da rimuovere. Questo formato è sensibile alle maiuscole e alle minuscole.
  • formula: cut(source, characters to cut)
    • esempio: cut([phone], "-")
    • esempio di output: 80081234567


formato data-ora

Nota bene: questa formula è stata deprecata e sostituita dalla funzione format_datetime riportata di seguito. Le azioni che utilizzano questa funzione continueranno a funzionare, ma in futuro si dovrà utilizzare la nuova funzione.

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

In alternativa, è possibile utilizzare anche:

  • formula: number/divisor
    • esempio: 8/4
    • esempio di uscita: 2
divisibile Verifica se un numero è uniformemente divisibile. Quando non c'è alcun resto, la funzione dà esito positivo. Quando c'è un resto, la funzione dà esito negativo. Da utilizzare con i seguenti metodi:
  • numero: il numero da dividere.
  • divisore: il numero da dividere per l'operazione di divisione.
  • formula: divisible(number, divisor)
    • esempio: divisible (5,2)
    • esempio di uscita: false
unirsi Combina due o più stringhe in un'unica stringa di risultato, utilizzando un separatore tra ogni valore. Questa funzione è disponibile solo quando l'azione Formatta i dati è utilizzata in modalità personalizzata.

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


lunghezza Restituisce il numero di caratteri di una stringa.
  • formula: length(string)
    • esempio: left("Hello World!")
    • esempio di uscita: 12
inferiore Converte tutti i caratteri di una stringa in lettere minuscole.
  • formula: lower([string])
    • esempio: lower(["HELLO WORLD"])
    • esempio di output: hello world
medio Restituisce una sottostringa di caratteri da un valore stringa. Questa funzione è disponibile solo quando l'azione Formato dati è utilizzata in modalità Personalizzata.
  • formula: mid(string, start-index, length)
    • esempio: join("abc123", 2, 2)
    • esempio di uscita: c1
meno_tempo Sottrae una quantità di tempo da un oggetto data/ora. Da utilizzare con i seguenti elementi:
  • datetime: l'oggetto data/ora da cui sottrarre il tempo.
  • diff: la quantità di tempo da sottrarre.
  • timeunit: l'unità di tempo da sottrarre. Si possono usare le seguenti opzioni:
    • secondi
    • minuti
    • ore
    • mezzo_giorno
    • giorni
    • settimane
    • mesi
    • anni
  • formula: minus_time(datetime, diff, timeunit)
    • esempio: minus_time([closedate], 2, "days")
    • esempio di uscita: 04/11/2020
moltiplicatore Moltiplica un valore per un numero. Questa funzione è un'alternativa all'operatore *. Si utilizza con i seguenti comandi:
  • numero: il numero da moltiplicare.
  • moltiplicatore: il numero per cui moltiplicare.
  • formula: multipler(number, multipler)
    • esempio: multiplier(5, 3)
    • esempio di uscita: 15

In alternativa, è possibile utilizzare anche:

  • formula: number*multipler
    • esempio: 5*3
    • esempio di uscita: 15
numero Converte una stringa in un numero.
  • formula: number(string, default?)
    • esempio: left("36")
    • esempio di uscita: 36
più_tempo Aggiunge una quantità di tempo a un oggetto data/ora. Da utilizzare con i seguenti elementi:
  • datetime: l'oggetto data/ora a cui aggiungere il tempo.
  • diff: la quantità 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 uscita: 06/11/2020


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

Con questa funzione, i numeri generati sono completamente casuali e possono ripetersi. Ad esempio, se si utilizza un intervallo da uno a tre e si iscrivono tre contatti, è possibile che non si ottengano tre numeri unici.

I numeri minimi e massimi sono inclusi nell'intervallo. È inoltre possibile utilizzare 0 e numeri negativi quando si imposta l'intervallo.
  • formula: randomNumber(minimum, maximum)
    • esempio: randomNumber(1, 3)
    • esempio di uscita: 1 o 2
sostituire Sostituisce tutte le istanze di una sottostringa con una stringa diversa. Da utilizzare con i seguenti comandi:
  • stringa: la stringa da cercare e sostituire.
  • old: la sottostringa da sostituire.
  • nuovo: la stringa sostitutiva.
  • count: il numero di istanze della sottostringa da sostituire. Se non viene fornito, tutte le sottostringhe saranno sostituite.
  • formula: replace(string, old, new, count)
    • esempio: replace( "Hello world!", "Hello", "Hi", 1)
    • esempio di output: Ciao mondo!
diritto Restituisce una sottostringa di caratteri da un valore di stringa a partire dalla fine di un valore di 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 uscita: 123
regex_replace Cerca un modello regex e lo sostituisce con la stringa fornita. Si usa con i seguenti parametri:
  • original_string: la stringa originale da cercare.
  • pattern: lo schema regex su cui effettuare la ricerca. Informazioni sulla sintassi di RE2 sono disponibili qui.
  • replacement_string: la stringa con cui sostituire i caratteri corrispondenti al pattern.
  • formula: regex_replace(original_string, pattern, replacement_string)
    • esempio: regex_replace("contact-us-2", "[^a-zA-Z]", "")
    • esempio di uscita: contactus
radice Calcola la radice quadrata di un numero. È possibile specificare l'ennesima radice da calcolare. Da utilizzare con i seguenti comandi:
  • Calcola la radice quadrata di un numero. Specificare facoltativamente l'ennesima radice da calcolare.
  • nthRoot: l'ennesima radice da calcolare. Se non viene specificata, verrà presa la radice quadrata.
  • formula: root(number, nthRoot)
    • esempio: root(625, 4)
    • esempio di uscita: 5
rotondo Arrotonda un numero a un decimale specificato. Da utilizzare con i seguenti comandi:
  • precisione: il decimale a cui arrotondare.
  • metodo di arrotondamento: arrotondare per eccesso o per difetto al numero intero più vicino. È possibile utilizzare i seguenti metodi di arrotondamento:
    • comune
    • massimo
    • piano
  • formula: round(number, precision, rounding method)
    • esempio: round(52.5, 0, 'floor')
    • esempio di uscita: 52
striptags Spoglia i tag SGML/XML e sostituisce gli spazi bianchi adiacenti con uno spazio. Questo filtro può essere usato per rimuovere qualsiasi tag HTML da una variabile.
  • formula: striptags([string])
    • esempio: striptags(<div><p>Potato</p></div>)
    • esempio di output: Patata
titolo Cambia il testo in casing del titolo. Ogni parola della stringa risultante inizierà con lettere maiuscole, mentre tutti i caratteri rimanenti saranno minuscoli.
  • formula: title([string])
    • esempio: title("cheddar CHEESE")
    • esempio di output: Formaggio Cheddar
assetto Rimuove gli spazi bianchi iniziali e finali da una stringa.
  • formula: trim([string])
    • esempio: trim(" pesca ")
    • esempio di output: peach
unixtimestamp Converte un oggetto data/ora in un timestamp Unix.
  • formula: unixtimestamp([dateteime])
    • esempio: unixtimesstamp([closedate])
    • esempio di output: 16528638 24
superiore Cambiare tutti i caratteri in maiuscolo.
  • formula: upper([string])
    • esempio: upper("teatime")
    • esempio di output: TEATIME
urlencode Eseguire l'escape e codificare l'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.