Introdução às funções Auxiliares functions
Last update: Thu Dec 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
Criado para:
- Experiente
- Desenvolvedor
As funções auxiliares permitem transformar e manipular dados em seu conteúdo personalizado. Use-os para realizar cálculos, formatar dados, aplicar condições e executar várias operações para criar experiências dinâmicas e personalizadas para seus clientes.
Essas funções usam a linguagem de modelo Journey Optimizer. Saiba mais sobre as diretrizes da sintaxe de personalização em esta página.
➡️ Saiba como usar funções auxiliares neste vídeo
Acessar funções auxiliares
As funções auxiliares estão disponíveis no menu de função do editor de personalização:
As funções são organizadas em três categorias para facilitar a navegação:
- Funções - Operações de manipulação e transformação de dados
- Auxiliares - Lógica condicional e funções utilitárias
- Operadores - Comparação e operadores lógicos
Para usar uma função auxiliar:
- Selecione uma categoria para exibir suas subcategorias e funções disponíveis
- Clique no ícone
>para expandir subcategorias - Clique no ícone
+ao lado de uma função para adicioná-lo ao seu código de personalização - Clique no ícone
...para exibir a descrição da função ou adicioná-la aos favoritos. Saiba mais
NOTE
As funções e os recursos disponíveis no editor de personalização são diferentes daqueles disponíveis no editor de expressão avançado do Jornada. Por exemplo, a função
now() só está disponível em expressões de jornada. Saiba maisFunções functions-helper
Funções de agregação e array
Esta função retorna a média aritmética de todos os valores selecionados dentro da matriz.
Esta função retorna o número de elementos dentro da matriz especificada.
Esta função conta o número de valores nulos na lista.
Esta função conta todos os elementos da lista, incluindo valores nulos.
Esta função obtém valores de uma matriz ou lista com valores duplicados removidos
Esta função conta o número de valores diferentes, incluindo os valores nulos.
Esta função retorna o primeiro item em uma matriz ou lista.
Esta função retorna os primeiros itens "N" em uma matriz quando classificados em ordem crescente com base na expressão numérica fornecida
Esta função é usada para determinar se um item é membro de uma matriz ou lista
Esta função determina se uma matriz ou lista contém um determinado item.
Esta função determina se duas matrizes ou listas têm pelo menos um membro comum.
Esta função retorna os últimos itens "N" em uma matriz quando classificados em ordem crescente com base na expressão numérica fornecida
Esta função retorna o maior valor dentro de uma matriz.
Esta função retorna o menor valor dentro da matriz.
Esta função determina se um item não é membro de uma matriz ou lista.
Esta função determina se uma matriz específica (matriz A) é um subconjunto de outra matriz (matriz B), isto é, se todos os elementos na matriz A são elementos da matriz B
Esta função retorna a soma de todos os valores selecionados na matriz.
Esta função determina se uma matriz específica (matriz A) é um superconjunto de outra matriz (matriz B), isto é, se essa matriz A contém todos os elementos na matriz B
Funções de data e hora date-functions
Esta função ajusta uma determinada data por um número especificado de dias, usando valores positivos para incrementar e valores negativos para diminuir.
Esta função ajusta uma determinada data por um número especificado de horas, usando valores positivos para incrementar e valores negativos para diminuir.
Esta função ajusta uma determinada data por um número especificado de minutos, usando valores positivos para incrementar e valores negativos para diminuir.
Esta função ajusta uma determinada data por um número especificado de meses, usando valores positivos para incrementar e valores negativos para diminuir.
Esta função ajusta uma determinada data por um número especificado de segundos, usando valores positivos para incrementar e valores negativos para diminuir.
Esta função ajusta uma determinada data por um número especificado de anos, usando valores positivos para incrementar e valores negativos para diminuir.
Esta função recupera a idade de uma determinada data.
Essa função calcula a idade de uma determinada data em dias, ou seja, o número de dias decorridos entre a data especificada e a data atual, negativo para datas futuras e positivo para datas passadas.
Essa função calcula a idade de uma determinada data em meses, ou seja, o número de meses decorridos entre a data especificada e a data atual , negativo para datas futuras e positivo para datas passadas.
Esta função compara a primeira data de entrada com a outra. Retorna 0 se data1 for igual a data2, -1 se data1 for anterior a data2 e 1 se data1 for posterior a data2.
Esta função converte uma data-hora em um determinado fuso horário.
Esta função recupera a hora atual em milissegundos da época.
Esta função recupera a diferença entre duas datas em número de dias.
Esta função retorna o número que representa o dia do mês.
Esta função recupera o dia da semana.
Esta função recupera o dia do ano.
Esta função retorna a diferença entre duas datas em termos de segundos.
Esta função extrai o componente de hora de um determinado carimbo de data e hora.
Esta função extrai o componente de minuto de um determinado carimbo de data e hora.
Esta função extrai o componente de mês de um determinado carimbo de data e hora.
Esta função extrai o segundo componente de um determinado carimbo de data e hora.
Essa função formata um valor de data e hora.
Essa função formata um valor de data e hora em sua representação sensível a idioma correspondente, ou seja, em um local desejado.
Esta função retorna a data e a hora atuais com informações de fuso horário.
Esta função retorna a diferença entre duas datas em termos de horas.
Esta função retorna a diferença entre duas datas em termos de minutos.
Esta função retorna a diferença entre duas datas em termos de meses.
Esta função define o dia do mês para a data-hora especificada.
Esta função define a hora da data-hora.
Esta função converte a sequência de caracteres em data. Retorna a data da época como saída para entrada inválida.
Esta função converte um datetime em UTC.
Esta função modifica uma determinada data-hora definindo-a para o início do dia com a hora definida como 00:00.
Essa função trunca uma data-hora para o primeiro dia de seu trimestre (por exemplo, Jan 1, Abr 1, Jul 1, Out 1) às 00:00.
Essa função modifica uma determinada data-hora definindo-a para o início da semana (segunda-feira às 00:00).
Essa função modifica uma determinada data-hora, truncando-a para o primeiro dia do ano (1º de janeiro) às 00:00.
Esta função retorna a semana do ano.
Esta função retorna a diferença entre duas datas em termos de anos.
Mapear Funções map-functions
Esta função é usada para recuperar o valor de um mapa para uma determinada chave.
Esta função é usada para recuperar todas as chaves de um determinado mapa
Esta função recupera todos os valores de um determinado mapa.
Funções matemáticas math-functions
Essa função formata qualquer número em sua representação sensível a linguagem.
Essa função formata qualquer número em sua representação sensível a linguagem.
Esta função retorna um valor aleatório entre 0 e 1.
Esta função arredonda um número para baixo.
Esta função arredonda um número para cima.
Converte qualquer número em sua cadeia de caracteres hexadecimal.
Converte qualquer um desses tipos (número, duplo, int, longo, flutuante, curto, byte, booleano, string) em um inteiro.
Esta função converte um número em porcentagem.
Esta função converte um número para a precisão necessária.
Esta função converte qualquer número em sua representação de sequência de caracteres.
Funções do objeto object-functions
Esta função é usada para determinar se existe uma referência de objeto.
Esta função é usada para determinar se uma referência de objeto não existe.
Funções de string string-functions
Esta função é usada para colocar a primeira letra de cada palavra de uma sequência de caracteres em maiúsculas.
Essa função retorna o valor ASCII de um caractere, como a função charCodeAt no JavaScript
Esta função é usada para combinar duas strings em uma
Esta função é usada para determinar se uma sequência de caracteres contém uma subsequência especificada.
Esta função é usada para determinar se uma sequência de caracteres não contém uma subsequência especificada.
Esta função é usada para determinar se uma sequência de caracteres não termina com uma subsequência especificada.
Esta função é usada para determinar se uma sequência de caracteres não inicia com uma subsequência especificada.
Esta função é usada para codificar uma sequência de caracteres.
Esta função é usada para determinar se uma sequência de caracteres termina com uma subsequência especificada.
Esta função é usada para determinar se uma sequência de caracteres não inicia com uma subsequência especificada, diferencia maiúsculas de minúsculas.
Esta função é usada para determinar se uma sequência de caracteres não inicia com uma subsequência especificada, sem diferenciar maiúsculas de minúsculas
Esta função é usada para extrair o domínio de um endereço de email.
Essa função converte qualquer número em sua representação de moeda correspondente sensível ao idioma, dependendo da localidade transmitida como uma string no segundo argumento
Esta função é usada para obter o host de URL.
Esta função é usada para obter o caminho do URL
Esta função é usada para obter o protocolo de URL
Esta função retorna a posição (no primeiro argumento) da primeira ocorrência do segundo parâmetro. Retorna -1 se não houver correspondência
Esta função é usada para verificar se uma sequência de caracteres ou expressão está vazia.
Esta função retorna verdadeiro se a sequência de caracteres no parâmetro não estiver vazia.
Esta função retorna a posição (no primeiro argumento) da última ocorrência do segundo parâmetro. Retorna -1 se não houver correspondência.
Esta função remove os espaços em branco do início de uma sequência de caracteres.
Esta função é usada para obter o número de caracteres em uma sequência ou expressão
Esta função é usada para determinar se uma sequência de caracteres corresponde a um padrão especificado.
Esta função converte uma sequência de caracteres em letras minúsculas.
Esta função é usada para substituir uma parte de uma sequência de caracteres por caracteres "X".
Esta função é usada para determinar se uma sequência de caracteres corresponde a uma expressão regular específica
Esta função retorna o hash md5 da sequência de caracteres de entrada.
Esta função é usada para determinar se uma sequência de caracteres não é igual à sequência especificada.
Esta função compara duas sequências de caracteres ignorando maiúsculas e minúsculas.
Esta função é usada para extrair informações específicas com base na expressão regular fornecida.
Esta função substitui uma determinada subsequência de caracteres em uma sequência de caracteres por outra subsequência.
Esta função substitui todas as subsequências de um texto que corresponde ao "destino" pela sequência literal de "substituição" especificada.
Esta função remove os espaços em branco do final de uma sequência de caracteres.
Esta função calcula e retorna o hash sha256 de uma sequência de caracteres.
Esta função é usada para dividir uma sequência de caracteres por um determinado caractere.
Esta função é usada para determinar se uma sequência de caracteres inicia com uma subsequência especificada.
Esta função converte um valor de sequência de caracteres em um valor de data-hora.
Esta função converte um valor de sequência de caracteres em um valor inteiro.
Esta função é usada para converter uma sequência de caracteres em número. Ele retorna a mesma string que a saída para entrada inválida.
Esta função retorna a subsequência de caracteres da expressão de sequência de caracteres entre o índice inicial e o índice final.
Esta função é usada para colocar em maiúsculas as primeiras letras de cada palavra de uma sequência de caracteres.
Esta função converte um valor de argumento em um valor booleano, dependendo de seu tipo.
Esta função é usada para converter sequência de caracteres em data. Retorna a data da época como saída para entrada inválida.
Esta função converte um valor de argumento em um valor somente de data e hora. Retorna a data da época como saída para entrada inválida.
Esta função remove os espaços em branco do início e do fim de uma sequência de caracteres.
Esta função converte uma sequência de caracteres em letras maiúsculas.
Esta função é usada para decodificar uma sequência de caracteres codificada em URL.
Esta função é usada para codificar uma sequência de caracteres em URL.
Auxiliares helper-helper
Os auxiliares estão detalhados em esta página.
Esta função é usada para renderizar uma variável com o padrão
Esta função é usada para iterar em uma matriz.
Este auxiliar captura metadados de valor chave personalizados durante a renderização da mensagem para que eles possam ser armazenados no objeto de metadados de execução em tempo de execução
Esta função é usada para definir um bloco condicional - se a expressão evaluation retornar true, o bloco será renderizado
Essa função permite que uma expressão seja armazenada como uma variável a ser usada posteriormente em uma consulta
Esta função é usada para definir um bloco condicional - se a expressão evaluation retornar false, o bloco será renderizado
Esta função é usada para alterar o token de avaliação da parte do modelo
Operadores operators-helper
Funções aritméticas arithmetic-helper
Funções aritméticas são usadas para realizar cálculos básicos em valores.
Este operador é usado para encontrar a soma de duas expressões de argumento
Este operador é usado para encontrar o quociente de duas expressões de argumento
Este operador é usado para encontrar o produto de duas expressões de argumento
Este operador é usado para encontrar o restante após dividir as duas expressões de argumento
Este operador encontra a diferença entre duas expressões
Funções booleanas boolean-functions
Funções booleanas são usadas para executar lógica booleana em elementos diferentes.
Funções de comparação comparison-functions
As funções de comparação são usadas para comparar entre diferentes expressões e valores, retornando verdadeiro ou falso de acordo.
Esta operação verifica se os valores são iguais
Este operador verifica se o primeiro valor é maior que o segundo valor
Este operador verifica se o primeiro valor é maior ou igual ao segundo valor
Este operador verifica se o primeiro valor é menor ou igual ao segundo valor
Este operador verifica se determinada expressão não é igual a determinado valor
Vídeo tutorial video
Saiba como transformar valores de personalização usando funções de ajuda de personalização e entenda diferentes casos de uso para funções de ajuda.
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76