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 de fórmula personalizadas

Ultima atualização: Outubro 9, 2024

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

Operations Hub   Professional , Enterprise

Se você estiver usando uma fórmula personalizada para formate seus dados em um fluxo de trabalho, você pode usar funções com valores de propriedade do registro registrado ou saídas de ações anteriores para criar fórmulas complexas. 

Revise as diferentes funções abaixo para determinar qual usar: 

Função Descrição Exemplo
abs Recupere o valor absoluto de um número. Você pode usar esta função para garantir que um número seja positivo.
  • fórmula de exemplo: abs([número ou propriedade numérica])
    • exemplo: abs(-10) 
    • Exemplo de saída: 10
add Adiciona um valor numérico a outro valor numérico. Esta função é a mesma que o operador +. Use com o seguinte: 
  • número: o valor numérico inicial da operação.
  • número para adicionar: o número a ser adicionado ao valor numérico inicial. 
  • fórmula de exemplo: add(number, number to add)
    • exemplo: add(5, 10)
    • Exemplo de saída: 15

Alternativamente, você também pode usar:

  • fórmula de exemplo: number + number to add
    • exemplo: 5+10
    • Exemplo de saída: 15
concatenar Combine vários valores de string. Esta função só está disponível quando o Formatar dados ação é usada em 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 Coloque a primeira letra de um valor de string em maiúscula. O primeiro caractere será maiúsculo, enquanto todas as outras letras serão minúsculas. Outras palavras na entrada não terão a primeira letra maiúscula
  • fórmula de exemplo: capitalize([string])
    • exemplo: capitalize([firstname])
    • Exemplo de saída: Henrique
cut Corta um caractere ou vários caracteres para remover uma sequência de caracteres de um valor. Esta função pode ser usada para combinar e cortar uma parte específica de uma string. O parâmetro especifica a parte da string que deve ser removida. Use com o seguinte: 
  • fonte: a string de origem da qual serão removidos os caracteres. 
  • caracteres_a_cortar: os caracteres específicos a serem removidos. Este formato diferencia maiúsculas de minúsculas. 
  • fórmula: cut(source, characters to cut)
    • exemplo: cut([phone], "-")
    • Exemplo de saída: 80081234567 


datetimeformat

Observe: esta fórmula foi descontinuada e substituída pela format_datetime função abaixo. As ações que usam esta função continuarão funcionando, mas a nova função deve ser usada daqui para frente.

 
format_datetime Converta um registro de data e hora em um formato amigável. Inclua o registro de data e hora ou propriedade junto com os seguintes parâmetros para configurar seu formato:
  • formatar: o formato a ser usado. Os valores incluem: 'short', 'medium', 'long', 'full'. Você também pode especificar um formato personalizado usando Padrões Unicode LDML.
  • Fuso horário: o fuso horário dos dados de saída em IANA TZDB formatar. Por padrão, retorna a hora UTC.
  • localidade: o local a ser usado para formatos com reconhecimento de localidade.
  • 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 /. Use com o seguinte: 
  • número: o número a ser dividido. 
  • divisor: o número a ser dividido para a operação de divisão. 
  • fórmula: divide(number, divisor)
    • exemplo: divide (8, 4)
    • Exemplo de saída: 2

Alternativamente, você também pode usar: 

  • fórmula: number/divisor
    • exemplo: 8/4
    • Exemplo de saída: 2
divisible Teste se um número é divisível. Quando não há resto, esta função será avaliada como verdadeira. Quando houver um resto, esta função será avaliada como falsa. Use com o seguinte: 
  • número: o número a ser dividido. 
  • divisor: o número a ser dividido 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 o Formatar dados ação é usada em Modo personalizado

Use com o seguinte: 
  • delimitador: uma string separadora a ser inserida entre cada item.
  • Unid: qualquer número de strings para combinar. 
  • fórmula: join(delimiter, items)
    • exemplo: join("-", "A", "B", "C")
    • Exemplo de saída: abc
esquerda Retorna uma substring de caracteres de um valor de string a partir do início de um valor de string. Esta função só está disponível quando o Formatar dados ação é usada em 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 Converta todos os caracteres de uma string em letras minúsculas.
  • fórmula: lower([string])
    • exemplo: lower(["HELLO WORLD"])
    • Exemplo de saída: Olá mundo
meio Retorna uma substring de caracteres de um valor de string. Esta função só está disponível quando o Formatar dados ação é usada em Modo personalizado.
  • fórmula: mid(string, start-index, length)
    • exemplo: join("abc123", 2, 2)
    • Exemplo de saída: c1
minus_time Subtrai uma quantidade de tempo de um objeto de data/hora. Use com o seguinte: 
  • data e hora: o objeto de data/hora ao qual adicionar tempo.
  • diferença: a quantidade de tempo a adicionar. 
  • unidade de tempo: a unidade de tempo a ser adicionada. Pode ser usado 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 *. Use com o seguinte: 
  • número: o número a ser multiplicado.
  • multiplicador: o número pelo qual multiplicar. 
  • fórmula: multipler(number, multipler)
    • exemplo: multiplier(5, 3) 
    • Exemplo de saída: 15

Alternativamente, você também pode usar:

  • fórmula: number*multipler
    • exemplo: 5*3 
    • Exemplo de saída: 15
número Converte uma string em um número.
  • fórmula: number(string, default?)
    • exemplo: left("36")
    • Exemplo de saída: 36
plus_time Adicione uma quantidade de tempo a um objeto de data/hora. Use com o seguinte: 
  • data e hora: o objeto de data/hora ao qual adicionar tempo.
  • diferença: a quantidade de tempo a adicionar. 
  • unidade de tempo: 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


número aleatório Gere um número aleatório dentro de um intervalo.

Com esta função, os números gerados são completamente aleatórios e podem se repetir. Por exemplo, se você usou um intervalo de um a três e inscreveu três contatos, talvez não obtenha três números exclusivos. 

Os números mínimo e máximo estão incluídos no intervalo. Você também pode usar 0 e números negativos ao definir seu intervalo. 
  • fórmula: randomNumber(minimum, maximum)
    • exemplo: randomNumber(1, 3)
    • Exemplo de saída: 1 ou 2
replace Substitui todas as instâncias de uma substring por uma string diferente. Use com o seguinte: 
  • corda: a string a ser procurada e substituída. 
  • velho: a substring que deve ser substituída. 
  • novo: a sequência de substituição. 
  • contar: o número de instâncias da substring a ser substituída. Se não for fornecido, todas as substrings serão substituídas
  • fórmula: replace(string, old, new, count)
    • exemplo: replace( "Hello world!", "Hello", "Hi", 1)
    • Exemplo de saída: Olá, mundo!
certo Retorna uma substring de caracteres de um valor de string do final de um valor de string. Esta função só está disponível quando o Formatar dados ação é usada em Modo personalizado.
  • fórmula: right(string, length)
    • exemplo: right("abc123", 3)
    • Exemplo de saída: 123
regex_replace Procura um padrão de expressão regular e o substitui pela string fornecida. Use com os seguintes parâmetros:
  • sequência_original: a string original para pesquisar.
  • padrão: o padrão regex a ser correspondido. Informações sobre a sintaxe RE2 podem ser encontradas aqui.
  • string_de_substituição: a string para substituir os caracteres correspondidos pelo padrão.
  • fórmula: regex_replace(original_string, pattern, replacement_string)
    • exemplo: regex_replace("contact-us-2", "[^a-zA-Z]", "")
    • Exemplo de saída: Contate-nos
root Calcular a raiz quadrada de um número. Opcionalmente, especifique a raiz N a ser calculada. Use com o seguinte:
  • número: o número do qual se deseja extrair a raiz. Calcular a raiz quadrada de um número. Opcionalmente, especifique a raiz N para calcular 
  • Raiz nth: a raiz n a ser calculada. Se não for especificado, a raiz quadrada será obtida. 
  • fórmula: root(number, nthRoot)
    • exemplo: root(625, 4)
    • Exemplo de saída: 5
round Arredonde um número para um decimal especificado. Use com o seguinte:
  • precisão: o decimal para arredondar. 
  • método de arredondamento: arredondar para cima ou para baixo para o número inteiro mais próximo. Os seguintes métodos de arredondamento podem ser usados: 
    • comum
    • teto
    • chão
  • 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 texto para caixa alta/baixa. Cada palavra na sequência resultante começará com letras maiúsculas, enquanto todos os caracteres restantes serão minúsculos.
  • fórmula: title([string])
    • exemplo: title("cheddar CHEESE")
    • Exemplo de saída: Queijo Cheddar
trim Remove espaços em branco iniciais e finais de uma string.
  • fórmula: trim([string])
    • exemplo: aparar(" pêssego ")
    • Exemplo de saída: pêssego
unixtimestamp Converta um objeto de data/hora em um registro de data e 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: HORA DO CHÁ
urlencode Escape e URL codificam uma string usando formatação UTF-8.
  • fórmula: urlencode([string])
    • exemplo: urlencode("hi there")
    • Exemplo de saída: oi%20aí
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.