Ir para o conteúdo principal
Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.

Funções da Fórmula Personalizada

Ultima atualização: Fevereiro 12, 2024

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Operations Hub   Professional , Enterprise

Se estiver a utilizar uma fórmula personalizada para formatar os seus dados num fluxo de trabalho, pode utilizar funções com valores de propriedade do registo inscrito ou resultados de acções anteriores para criar fórmulas complexas. 

Rever as diferentes funções abaixo para determinar quais utilizar: 

Função Descrição Exemplo
abs Recuperar o valor absoluto de um número. Pode usar esta função para garantir que um número é positivo.
  • fórmula de exemplo: abs([número ou propriedade numérica])
    • exemplo: abs(-10) 
    • exemplo de saída: 10
add Acrescenta um valor numérico a outro valor numérico. Esta função é a mesma que a do operador +. Utilizar com o seguinte:
  • número: o valor numérico inicial para a operação.
  • número a acrescentar: o número a ser acrescentado ao valor numérico inicial. 
  • fórmula de exemplo: add(number, number to add)
    • exemplo: add(5, 10)
    • exemplo de saída: 15

Alternativamente, também pode utilizar:

  • fórmula de exemplo: number + number to add
    • exemplo: 5+10
    • exemplo de saída: 15
concat Combinar múltiplos valores de cordas. Esta função só está disponível quando a acção Formatar dados é utilizada no modo Personalizado
  • fórmula de exemplo:concat([string 1], " ", [string 2]) 
    • exemplo: concat([company name], " ", [MonthYear])
    • exemplo de saída: HubSpot Junho de 2006
capitalize Capitalizar a primeira letra de um valor de corda. O primeiro caracter será maiúsculo, enquanto todas as outras letras serão minúsculas. Outras palavras na entrada não terão a sua primeira letra em maiúsculas
  • fórmula de exemplo: capitalize([string])
    • exemplo: capitalize([firstname])
    • exemplo de saída: Henry
cut Cortar um carácter ou múltiplos caracteres para remover uma corda de um valor. Esta função pode ser utilizada para combinar e cortar uma parte específica de um fio. O parâmetro especifica a parte da string que deve ser removida. Utilizar com o seguinte:
  • fonte: o fio condutor para remover caracteres. 
  • caracteres_a_cortar: os caracteres específicos a remover. Este formato é sensível a maiúsculas e minúsculas. 
  • fórmula: cut(source, characters to cut)
    • exemplo: cut([phone], "-")
    • exemplo de saída: 80081234567 


datetimeformat

Atenção: esta fórmula foi descontinuada e substituída pela função format_datetime abaixo. As acções que utilizam esta função continuarão a funcionar, mas a nova função deve ser utilizada daqui para a frente.

 
format_datetime Converte um carimbo de data/hora num formato amigável para o ser humano. Incluir o carimbo de data/hora ou a propriedade juntamente com os seguintes parâmetros para configurar o seu formato:
  • format: o formato a utilizar. Os valores incluem: 'short', 'medium' , 'long' , 'full'. Também é possível especificar um formato personalizado utilizando padrões LDML Unicode.
  • timeZone: o fuso horário dos dados de saída no formato IANA TZDB. Por padrão, retorna a hora UTC.
  • locale: o locale a utilizar para formatos com reconhecimento de local.
  • fórmula: format_datetime(date, format, timeZone, locale)
    • exemplo: format_datetime([closedate], 'medium', 'America/New_York, 'de-DE')
    • exemplo de saída: 08.02.2024, 17:09:49
divide Dividir um número. Esta função é uma alternativa ao / operador. Utilizar com o seguinte:
  • número: o número a dividir. 
  • divisor: o número a dividir por para a operação de divisão. 
  • fórmula: divide(number, divisor)
    • exemplo: divide (8, 4)
    • exemplo de saída: 2

Alternativamente, também pode utilizar: 

  • fórmula: number/divisor
    • exemplo: 8/4
    • exemplo de saída: 2
divisible Testar se um número for igualmente divisível. Quando não há resto, esta função será avaliada até à verdade. Quando há um remanescente, esta função avaliará a falso. Utilizar com o seguinte:
  • número: o número a dividir. 
  • divisor: o número a dividir por para a operação de divisão. 
  • fórmula: divisible(number, divisor)
    • exemplo: divisible (5,2)
    • exemplo de saída: falso
join Combine duas ou mais strings em uma string de resultado, usando um separador entre cada valor. Esta função só está disponível quando a acção Formatar dados é utilizada no modo Personalizado

Utilizar com o seguinte:
  • delimitador: um fio separador a ser inserido entre cada item.
  • artigos: qualquer número de cordas a combinar. 
  • fórmula: join(delimiter, items)
    • exemplo: join("-", "A", "B", "C")
    • exemplo de saída: A-B-C
esquerda Devolve uma substring de caracteres de um valor de cadeia de caracteres a partir do início de um valor de cadeia de caracteres. Esta função só está disponível quando a acção Formatar dados é utilizada no modo Personalizado.
  • fórmula: left(string, length)
    • exemplo: left("Maria", "1")
    • exemplo de saída: M


length Retorna o número de caracteres em uma string.
  • fórmula: length(string)
    • exemplo: left("Hello World!")
    • exemplo de saída: 12
lower Converter todos os caracteres numa cadeia em todas as letras minúsculas.
  • fórmula: lower([string])
    • exemplo: lower(["HELLO WORLD"])
    • exemplo de saída: olá mundo
meados de Devolve uma substring de caracteres de um valor de cadeia de caracteres. Esta função só está disponível quando a acção Formatar dados é utilizada no modo Personalizado.
  • fórmula: mid(string, start-index, length)
    • exemplo: join("abc123", 2, 2)
    • exemplo de saída: c1
minus_time Subtrai um valor de tempo de um objeto de data/hora. Utilizar com o seguinte:
  • data/hora: o objecto data/hora a que se deve acrescentar hora.
  • dif: a quantidade de tempo a acrescentar. 
  • timeunit: a unidade de tempo a ser adicionada. Pode ser utilizado o seguinte: 
    • segundos
    • minutos
    • horas
    • meio_dia
    • dias
    • semanas
    • meses
    • anos
  • fórmula: minus_time(datetime, diff, timeunit)
    • exemplo: minus_time([closedate], 2, "days")
    • exemplo de saída: 04/11/2020
multiplicador Multiplica um valor por um número. Esta função é uma alternativa ao operador *. Utilizar com o seguinte:
  • número: o número a multiplicar.
  • multiplicador: o número pelo qual se deve multiplicar. 
  • fórmula: multipler(number, multipler)
    • exemplo: multiplier(5, 3) 
    • exemplo de saída: 15

Alternativamente, também pode utilizar:

  • fórmula: number*multipler
    • exemplo: 5*3 
    • exemplo de saída: 15
número Converte um fio para um número.
  • fórmula: number(string, default?)
    • exemplo: left("36")
    • exemplo de saída: 36
plus_time Adicionar uma quantidade de tempo a um objecto de data/hora. Utilizar com o seguinte:
  • data/hora: o objecto data/hora a que se deve acrescentar hora.
  • dif: a quantidade de tempo a acrescentar. 
  • timeunit: a unidade de tempo a ser adicionada. 
  • fórmula: plus_time(datetime, diff, timeunit)
    • exemplo: plus_time([closedate], 2, "days")
    • exemplo de saída: 06/11/2020


randomNumber Gerar um número aleatório dentro de um intervalo.

Com esta função, os números gerados são completamente aleatórios e podem repetir-se. Por exemplo, se utilizou um intervalo de um a três e inscreveu três contactos, poderá não obter três números únicos. 

Os números mínimo e máximo estão incluídos no intervalo. Também pode usar números 0 e negativos ao definir o seu intervalo. 
  • fórmula: randomNumber(minimum, maximum)
    • exemplo: randomNumber(1, 3)
    • exemplo de saída: 1 ou 2
replace Substitua todas as instâncias de uma substring por uma string diferente. Utilizar com o seguinte:
  • corda: a corda a procurar e substituir. 
  • antigo: o substrato que deve ser substituído. 
  • novo: a corda de substituição. 
  • contagem: o número de instâncias do substrato a substituir. Se não forem fornecidos, todos os substratos serão substituídos
  • fórmula: replace(string, old, new, count)
    • exemplo: replace( "Hello world!", "Hello", "Hi", 1)
    • exemplo de saída: Olá mundo!
right Retorna um substrato de caracteres de um valor de cadeia a partir do fim de um valor de cadeia. Esta função só está disponível quando a acção Formatar dados é utilizada no modo Personalizado.
  • fórmula: right(string, length)
    • exemplo: right("abc123", 3)
    • exemplo de saída: 123
root Calcular a raiz quadrada de um número. Opcionalmente, especificar a enésima raiz a calcular. Utilizar com o seguinte:
  • número: o número para tomar a raiz de. Calcular a raiz quadrada de um número. Opcionalmente, especificar a Nth raiz para calcular 
  • nthRoot: a enésima raiz a ser calculada. Se não for especificado, a raiz quadrada será tomada. 
  • fórmula: root(number, nthRoot)
    • exemplo: root(625, 4)
    • exemplo de saída: 5
round Arredondar um número até uma casa decimal especificada. Utilizar com o seguinte:
  • precisão: o decimal a arredondar para. 
  • método de arredondamento: arredondar para cima ou para baixo para o número inteiro mais próximo. Podem ser utilizados os seguintes métodos de arredondamento: 
    • comum
    • ceil
    • andar
  • fórmula: round(number, precision, rounding method)
    • exemplo: round(52.5, 0, 'floor')
    • exemplo de saída: 52
striptags Remove as tags SGML/XML e substitua o espaço em branco adjacente por um espaço. Este filtro pode ser usado para remover quaisquer tags HTML de uma variável.
  • fórmula: striptags([string])
    • exemplo: striptags(<div><p>Potato</p></div>)
    • exemplo de saída: Batata
title Alterar o texto para invólucro do título. Cada palavra na cadeia resultante começará com letras maiúsculas, enquanto todos os restantes caracteres são minúsculos.
  • fórmula: title([string])
    • exemplo: title("cheddar CHEESE")
    • exemplo de saída: Queijo Cheddar
trim Remova os espaços em branco à esquerda e à direita de uma string.
  • fórmula: trim([string])
    • exemplo: guarnição(" pêssego ")
    • exemplo de saída: pêssego
unixtimestamp Converta um objeto de data/hora em um carimbo de data/hora unix.
  • fórmula: unixtimestamp([dateteime])
    • exemplo: unixtimesstamp([closedate])
    • exemplo de saída: 1652863824
upper Altere todos os caracteres para maiúsculas.
  • fórmula: upper([string])
    • exemplo: upper("teatime")
    • exemplo de saída: TEATIME
urlencode Escape e URL codificam uma string usando a formatação UTF-8.
  • fórmula: urlencode([string])
    • exemplo: urlencode("hi there")
    • exemplo de saída: hi%20there
Esse artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.