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.
Workflows

Funções de fórmula personalizadas

Ultima atualização: Setembro 7, 2022

Disponível para

Operations Hub Professional, Enterprise

Se você estiver usando uma fórmula personalizada para formatar seus dados em um fluxo de trabalho, poderá 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 essa 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 do operador +. Use com o seguinte: 
  • número: o valor numérico inicial para a operação.
  • número a ser adicionado: o número a ser adicionado ao valor numérico inicial. 
  • fórmula de exemplo: adicionar(número, número para adicionar)
    • exemplo: add(5, 10)
    • saída de exemplo: 15

Como alternativa, você também pode usar:

  • fórmula de exemplo: número + número para adicionar
    • exemplo: 5+10
    • saída de exemplo: 15
concat Combine vários valores de cadeia de caracteres. Essa função está disponível apenas quando a ação de Formatar dados é usada no modo Personalizado
  • fórmula de exemplo: concat([string 1], [string 2]) 
    • exemplo: concat([nome da empresa], [anoMês])
    • exemplo de saída: HubSpot Junho de 2006
capitalize Capitalize a primeira letra de um valor de string. 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])
    • saída de exemplo: Henry
cut Cortar um ou vários caracteres para remover uma string 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: 
  • source: a cadeia de caracteres de origem da qual remover caracteres. 
  • characters_to_cut: os caracteres específicos a serem removidos. Este formato diferencia maiúsculas de minúsculas. 
  • fórmula: cut(fonte, caracteres a cortar)
    • exemplo: cut([phone], "-")
    • saída de exemplo: 80081234567 


datetimeformat Altere o formato de data para converter um carimbo de data e hora em texto amigável. Use o parâmetro de formato para escolher como o texto resultante será exibido. Use com o seguinte:
  • datetime: o objeto de data/hora a ser formatado.
  • format: o formato para o objeto date/time. Este parâmetro usa os tokens de formatação do filtro HubL datetimeformat
  • fórmula: formato de data e hora (data e hora, formato, fuso horário)
    • exemplo: datetimeformat([closedate], %B %e %Y %l %p", "America/Los_Angeles")
    • exemplo de saída: 1 de outubro de 2020 às 9h
divide Dividir um número. Esta função é uma alternativa ao operador/. Use com o seguinte: 
  • número: o número para dividir. 
  • divisor: o número para dividir para a operação de divisão. 
  • fórmula: dividir(número, divisor)
    • exemplo: dividir (8, 4)
    • exemplo de saída: 2

Como alternativa, você também pode usar: 

  • fórmula: número/divisor
    • exemplo: 8/4
    • exemplo de saída: 2
divisible Testar se um número é divisível uniformemente. Quando não houver mais, esta função será avaliada como true. Quando houver um restante, esta função será avaliada como falsa. Use com o seguinte: 
  • número: o número para dividir. 
  • divisor: o número para dividir para a operação de divisão. 
  • fórmula: divisível(número, divisor)
    • exemplo: divisível (5,2)
    • saída de exemplo: false
join Combine duas ou mais strings em uma string de resultado, usando um separador entre cada valor. Essa função está disponível apenas quando a ação de Formatar dados é usada no modo Personalizado

Use com o seguinte: 
  • delimitador: uma string separadora a ser inserida entre cada item.
  • items: qualquer número de strings para combinar. 
  • fórmula: esquerda(string, comprimento)
    • exemplo: left("Maria", "1")
    • saída de exemplo: M
esquerda Retorna uma subcadeia de caracteres de um valor de string do início de um valor de string. Essa função está disponível apenas quando a ação de Formatar dados é usada no modo Personalizado.
  • fórmula: join(delimitador, itens)
    • exemplo: join("-", "A", "B", "C")
    • saída de exemplo: A-B-C
lower Converta todos os caracteres em uma string para todas as letras minúsculas.
  • formula: lower([string])
    • exemplo: lower(["OLÁ MUNDO"])
    • exemplo de saída: hello world
mID Retorna uma subcadeia de caracteres de um valor de string. Essa função está disponível apenas quando a ação de Formatar dados é usada no modo Personalizado.
  • fórmula: mid(string, start-index, length)
    • exemplo: join("abc123", 2, 2)
    • saída de exemplo: c1
minus_time Subtrai um valor de tempo de um objeto de data/hora. Use com o seguinte: 
  • datetime: o objeto de data/hora ao qual adicionar hora.
  • diff: a quantidade de tempo para adicionar. 
  • timeunit: a unidade de tempo a ser adicionada. O seguinte pode ser usado: 
    • segundos
    • minutos
    • horas
    • half_days
    • dias
    • semanas
    • meses
    • anos
  • fórmula: minus_time(datetime, diff, timeunit)
    • exemplo: minus_time([closedate], 2, "dias")
    • saída de exemplo: 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 para multiplicar. 
  • fórmula: multipler(número, multipler)
    • exemplo: multiplicador(5, 3) 
    • saída de exemplo: 15

Como alternativa, você também pode usar:

  • fórmula: number*multipler
    • exemplo: 5*3 
    • saída de exemplo: 15
plus_time Adicionar uma quantidade de tempo a um objeto de data/hora. Use com o seguinte: 
  • datetime: o objeto de data/hora ao qual adicionar hora.
  • diff: a quantidade de tempo para adicionar. 
  • timeunit: a unidade de tempo a ser adicionada. 
  • fórmula: plus_time(datetime, diff, timeunit)
    • exemplo: plus_time([closedate], 2, "dias")
    • saída de exemplo: 06/11/2020


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

Com essa 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, pode não obter três números exclusivos.  

Os números mínimo e máximo estão incluídos no intervalo. Você também pode usar números 0 e negativos ao definir seu intervalo. 
  • fórmula: randomNumber(mínimo, máximo)
    • exemplo: randomNumber(1, 3)
    • exemplo de saída: 1 ou 2
replace Substitua todas as instâncias de uma substring por uma string diferente. Use com o seguinte: 
  • string: a string para procurar e substituir. 
  • antigo: a subcadeia que deve ser substituída. 
  • new: a string de substituição. 
  • count: o número de instâncias da subcadeia a substituir. Se não for fornecido, todas as subcadeias serão substituídas
  • fórmula: substituir(string, antigo, novo, contagem)
    • exemplo: replace( "Olá mundo!", "Olá", "Olá", 1)
    • exemplo de saída: Olá mundo!
right Retorna uma subcadeia de caracteres de um valor de string do final de um valor de string. Essa função está disponível apenas quando a ação de Formatar dados é usada no modo Personalizado.
  • fórmula: direita(string, comprimento)
    • exemplo: right("abc123", 3)
    • saída de exemplo: 123
fonte Calcular a raiz quadrada de um número. Opcionalmente, especifique a enésima raiz a ser calculada. Use com o seguinte:
  • number: o número para obter a raiz de.Calcular a raiz quadrada de um número. Opcionalmente, especifique a enésima raiz a ser calculada 
  • nthRoot: a raiz nth a ser calculada. Se não for especificado, a raiz quadrada será tomada. 
  • fórmula: root(número, nthRoot)
    • exemplo: root(625, 4)
    • saída de exemplo: 5
round Arredondar um número para uma casa decimal especificada. 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: 
    • frequentes
    • tecto
    • piso
  • fórmula: arredondado(número, precisão, método de arredondamento)
    • exemplo: redondo(52,5, 0, 'piso')
    • saída de exemplo: 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.
  • formula: striptags([string])
    • exemplo: striptags(<div><p>Batata</p></div>)
    • saída de exemplo: Batata
title Altere o texto para a caixa do título. Cada palavra na string resultante começará com letras maiúsculas, enquanto todos os caracteres restantes são minúsculos.
  • formula: title([string])
    • exemplo: title("QUEIJO cheddar")
    • exemplo de saída: Queijo Cheddar
trim Remova os espaços em branco à esquerda e à direita de uma string.
  • formula: trim([string])
    • exemplo: trim(" pêssego ")
    • saída de exemplo: peach
unixtimestamp Converta um objeto de data/hora em um carimbo de data/hora unix.
  • fórmula: unixtimestamp([dateteime])
    • exemplo: unixtimesstamp([closedate])
    • saída de exemplo: 1652863824
upper Alterar todos os caracteres para maiúsculas.
  • formula: upper([string])
    • exemplo: superior("hora do chá")
    • saída de exemplo: HORA DO CHÁ
urlencode Escape e URL codificam uma string usando a formatação UTF-8.
  • formula: urlencode([string])
    • exemplo: urlencode("oi")
    • exemplo de saída: hi%20there
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.