Funções de fórmula personalizadas

Written by HubSpot Support | 27/jun/2022 7:06:47

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 do qual subtrair o tempo. diferença: a quantidade de tempo a subtrair. unidade de tempo: a unidade de tempo a ser subtraída. 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: `numbermultipler` exemplo: `53`* 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í

View full post