Você está aqui:
Operadores e funções de fórmula pelo contexto
Use estes operadores e funções ao criar fórmulas. Todas as funções estão disponíveis em todos os locais, de forma que é possível incluir uma fórmula como campos de fórmula, regras de validação, processos de aprovação e regras de fluxo de trabalho, a não ser que haja alguma especificação diferente.
Dentro de um modelo de email, os campos de mesclagem só podem ser usados em funções e operações de fórmula quando o campo de mesclagem pertence ao registro ao qual o email está relacionado. Caso contrário, esses campos não serão resolvidos.
Espaços externos são ignorados nos exemplos.
Operadores matemáticos
| Operador | Descrição |
|---|---|
| + (Somar) | Calcula a soma de dois valores. |
| - (Subtrair) | Calcula a diferença entre dois valores. |
| * (Multiplicar) | Multiplica os seus valores. |
| / (Dividir) | Divide seus valores. |
| ^ (Exponenciação) | Eleva um número à potência de um número especificado. |
| () (Parênteses de abertura e de fechamento) | Especifica que as expressões entre parênteses são avaliadas em primeiro lugar. Todas as outras expressões são avaliadas com a precedência do operador padrão. |
Operadores lógicos
| Operador | Descrição |
|---|---|
| = e == (igual) | Avalia se dois valores são equivalentes. Os operadores = e == são equivalentes. |
| <> e != (não igual) | Avalia se dois valores não são equivalentes. |
| < (Menor que) | Avalia se um valor é menor que aquele após o símbolo. |
| > (Maior que) | Avalia se um valor é maior que aquele após o símbolo. |
| <= (Menor que ou igual a) | Avalia se um valor é menor que ou igual àquele após o símbolo. |
| >= (Maior que ou igual a) | Avalia se um valor é maior que ou igual àquele após o símbolo. |
| && (E) | Avalia se dois valores ou expressões são verdadeiros. Use esse operador como alternativa à função lógica E. |
| || (Ou) | Avalia se pelo menos um dos vários valores ou expressões é verdadeiro. Use esse operador como alternativa à função lógica OU. |
Funções de data e hora
| Função | Descrição |
|---|---|
| ADDMONTHS | Retorna a data que é anterior ou posterior à data especificada pelo número de meses indicado. Se a data especificada for o último dia do mês, a data resultante será o último dia do mês resultante. Caso contrário, o resultado tem o mesmo componente de data que aquela que foi especificada. |
| DATE | Retorna um valor de data dos valores de ano, mês e dia inseridos. O Salesforce apresenta um erro na página de detalhes quando o valor da função DATE de um campo de fórmula é uma data inválida, como 29 de fevereiro em um ano que não seja bissexto. |
| DATEVALUE | Retorna um valor de data para uma expressão de data/hora ou texto. |
| DATETIMEVALUE | Retorna um valor de ano, mês, dia e hora GMT. |
| DAY | Retorna o dia do mês como um número entre 1 e 31. |
| DAYOFYEAR | Retorna o dia do ano calendário como um número entre 1 e 366. |
| FORMATDURATION | Formata o número de segundos com dias opcionais ou a diferença entre horas ou dateTimes como HH:MM:SS. |
| HOUR | Retorna o valor da hora local, sem a data, na forma de um número de 1 a 24. |
| ISOWEEK | Retorna o número de semana ISO 8601 (1 a 53) para a data especificada, garantindo que a primeira semana comece na segunda-feira. |
| ISOYEAR | Retorna o ano da semana ISO 8601 com quatro dígitos para a data especificada, garantindo que o primeiro dia seja uma segunda-feira. |
| MILLISECOND | Retorna um valor em milissegundos, na forma de um número de 0 a 999. |
| MINUTE | Retorna um valor em minutos, na forma de um número de 0 a 60. |
| MONTH | Retorna o mês, um número de 1 (janeiro) a 12 (dezembro) no formato numérico de uma determinada data. |
| NOW | Retorna uma data/hora que representa o momento atual. |
| SECOND | Retorna um valor em segundos, na forma de um número de 0 a 60. |
| TIMENOW | Retorna um valor de hora, em GMT, que representa o momento atual. Quando quiser utilizar apenas a hora, sem data, use esta função em vez da função NOW. |
| TIMEVALUE | Retorna o valor de hora, sem a data, como horário de funcionamento, por exemplo. |
| TODAY | Retorna a data atual como um tipo de dados de data. |
| UNIXTIMESTAMP | Retorna o número de segundos desde 1º de janeiro de 1970 para a data fornecida ou o número de segundos no dia para uma hora. |
| WEEKDAY | Retorna o dia da semana da data especificada, usando 1 para domingo, 2 para segunda e assim por diante, até 7 para sábado. |
| YEAR | Retorna o ano de 4 dígitos de uma determinada data em formato de número. |
Funções lógicas
| Função | Descrição |
|---|---|
| E | Retorna uma resposta VERDADEIRO se todos os valores forem verdadeiros ou FALSO se um ou mais valores forem falsos. |
| BLANKVALUE | Determina se uma expressão tem um valor e retorna uma expressão substituta se não tiver. Se a expressão tiver um valor, retorna o valor da expressão. |
| CASE | Compara determinada expressão a uma série de valores. Se a expressão for igual a um valor na série, retornará o resultado correspondente. Se ela não for igual a um valor na série, retornará else_result. |
| IF | Determina se as expressões são falsas ou verdadeiras. Retornará um determinado valor se for verdadeiro e outro se for falso. |
| ISBLANK | Determina se uma expressão tem um valor e retorna TRUE se não tiver. Se ela contiver um valor, retornará FALSE. |
| ISCLONE | Verifica se o registro é um clone de outro registro e retorna VERDADEIRO se um item é um clone. Caso contrário, retorna FALSE. |
| ISNEW | Verifica se a fórmula está em execução durante a criação de um novo registro e retorna VERDADEIRO caso esteja. Se algum registro estiver sendo atualizado, retornará FALSE. |
| ISNULL | Determina se uma expressão é nula (em branco) e retorna VERDADEIRO caso seja. Se ela contiver um valor, retornará FALSE. Use ISBLANK em vez de ISNULL nas novas fórmulas. ISBLANK tem a mesma funcionalidade que ISNULL, mas também suporta campos de texto. O Salesforce continuará oferecendo suporte a ISNULL, então, não é necessário mudar a fórmula existente. |
| ISNUMBER | Determina se um valor de texto é um número e retorna VERDADEIRO caso seja. Caso contrário, retorna FALSE. |
| NOT | Retorna FALSO para VERDADEIRO e VERDADEIRO para FALSO. |
| NULLVALUE | Determina se uma expressão é nula (em branco) e, em caso afirmativo, retorna uma expressão substituta. Se a expressão não está em branco, retorna o valor da expressão. Use BLANKVALUE em vez de NULLVALUE nas novas fórmulas. BLANKVALUE tem a mesma funcionalidade que NULLVALUE, mas também suporta campos de texto. O Salesforce continua oferecendo suporte a NULLVALUE, portanto, não é necessário alterar as fórmulas existentes. |
| OU | Determina se as expressões são falsas ou verdadeiras. Retorna VERDADEIRO se qualquer expressão for verdadeira e FALSO se todas as expressões forem falsas. |
| PRIORVALUE | Retorna o valor anterior de um campo. |
Funções matemáticas
| Função | Descrição |
|---|---|
| ABS | Calcula o valor absoluto de um número. O valor absoluto de um número é o número sem o sinal de positivo ou negativo. |
| ACOS | Retorna o arco cosseno do número em radianos se o número informado estiver entre -1 e 1. Caso contrário, retorna NULL. |
| ASIN | Retorna o arco seno do número em radianos se o número informado estiver entre -1 e 1. Caso contrário, retorna NULL. |
| ATAN | Retorna o arco tangente do número em radianos. |
| ATAN2 | Retorna o arco tangente do cociente de y e x em radianos. |
| CEILING | Arredonda um número para o maior número inteiro mais próximo, para longe de zero caso seja negativo. |
| CHR | Retorna uma string com o primeiro ponto de código de caractere como o número informado. |
| COS | Retorna o cosseno do número em radianos se o número informado estiver entre -1 e 1. Caso contrário, retorna NULL. |
| EXP | Retorna um valor para e elevado à potência de um número que você especifica. |
| FLOOR | Retorna um número arredondado para o menor número inteiro mais próximo, na direção de zero caso seja negativo. |
| FROMUNIXTIME | Retorna a data e hora que representa o número informado como os segundos decorridos desde 1º de janeiro de 1970. |
| LN | Retorna o logaritmo natural de um número especificado. Os logaritmos naturais baseiam-se no valor e constante de 2.71828182845904. |
| LOG | Retorna o logaritmo na base 10 de um número. |
| MAX | Retorna o maior número de uma lista de números. |
| MCEILING | Arredonda um número para o maior número inteiro mais próximo, na direção de zero caso seja negativo. |
| MFLOOR | Arredonda um número para o menor número inteiro mais próximo, para longe de zero caso seja negativo. |
| MIN | Retorna o menor número de uma lista de números. |
| MOD | Retorna o restante após um número ter sido dividido por um divisor especificado. |
| PI | Retorna o pi. |
| PICKLISTCOUNT | Retorna o número de valores selecionados em uma lista de opções de seleção múltipla. |
| ROUND | Retorna o número mais próximo para um número que você especifica, isso restringe o novo número por um número de dígitos especificado. |
| SIN | Retorna o seno do número, em que o número é dado em radianos. |
| SQRT | Retorna a raiz quadrada positiva de um determinado número. |
| TAN | Retorna a tangente do número, em que o número é dado em radianos. |
| TRUNC | Trunca um número para um número de dígitos especificado. |
Funções de texto
| Função | Descrição |
|---|---|
| ASCII | Retorna o primeiro ponto de código de caractere da string informada como um número. |
| BEGINS | Determina se o texto começa com caracteres específicos. Retorna VERDADEIRO caso positivo e FALSO se não. |
| BR | Insere uma quebra de linha em uma string de texto. |
| CASESAFEID | Converte um ID de 15 caracteres em um ID de 18 caracteres que não diferencia maiúsculas de minúsculas. |
| CONTAINS | Compara dois argumentos de texto e retorna VERDADEIRO se o primeiro argumento contiver o segundo argumento. Caso contrário, retornará FALSO. |
| FIND | Retorna a posição de uma string em uma string de texto representada como um número. |
| GETSESSIONID | Retorna o ID da sessão do usuário. |
| HTMLENCODE | Codifica o texto e os valores do campo de mesclagem para uso no HTML, substituindo caracteres reservados no HTML, como o sinal "maior que" (>), com equivalentes da entidade HTML, como > |
| HYPERLINK | Cria um link para um URL especificado que pode ser acessado do texto especificado. |
| IMAGE | Insere uma imagem com texto alternativo e especificações de altura e largura. |
| INCLUDES | Determina se qualquer valor selecionado em um campo de lista de opções de seleção múltipla seja igual a um texto literal que você especificar. |
| INITCAP | Retorna o texto como minúscula com o primeiro caractere de cada palavra maiúsculo. |
| ISPICKVAL | Determina se o valor de um campo de lista de opções é igual ao texto literal especificado. |
| JSENCODE | Codifica o texto e os valores do campo de mesclagem para uso em JavaScript, inserindo caracteres de escape, como barra invertida (\), antes de caracteres JavaScript inseguros, como o apóstrofo ('). |
| JSINHTMLENCOD | Codifica o texto e os valores do campo de mesclagem para uso em JavaScript dentro dos tags HTML substituindo os caracteres reservados em HTML por equivalentes da entidade HTML e inserindo caracteres de escape antes de caracteres JavaScript inseguros. JSINHTMLENCODE(someValue) é uma função de conveniência equivalente a JSENCODE(HTMLENCODE((someValue)). Ou seja, JSINHTMLENCODE primeiro codifica someValue com HTMLENCODE e depois codifica o resultado com JSENCODE. |
| LEFT | Retorna o número especificado de caracteres no início de uma string de texto. |
| LEN | Retorna o número de caracteres em uma string de texto especificada. |
| LOWER | Converte todas as letras na string de texto especificada em letras minúsculas. Os caracteres que não forem letras não serão afetados por essa função. As regras de localidade serão aplicadas se for fornecida uma localidade. |
| LPAD | Insere caracteres especificados por você no lado esquerdo de uma string de texto. |
| MID | Retorna o número especificado de caracteres no meio de uma string de texto, dada uma posição inicial. |
| REVERSE | Retorna os caracteres de uma string de texto de origem na ordem reversa. |
| RIGHT | Retorna o número especificado de caracteres do fim de uma string de texto. |
| RPAD | Insere caracteres especificados por você à direita de uma string de texto. |
| SUBSTITUTE | Substitui o texto antigo pelo novo em uma string de texto. |
| TEXT | Converte um campo do tipo porcentagem, número, data, data/hora ou moeda em texto em qualquer lugar onde sejam usadas fórmulas. Além disso, converte valores de lista de opções para texto em regras de aprovação, etapa de aprovação, fluxo de trabalho, escalação, atribuição, resposta automática, validação, campos de fórmula, atualizações de campo e botões e links personalizados. |
| TRIM | Remove os espaços e as tabulações do início e do final de uma string de texto. |
| UPPER | Converte todas as letras na string de texto especificada em letras maiúsculas. Os caracteres que não forem letras não serão afetados por essa função. As regras de localidade serão aplicadas se for fornecida uma localidade. |
| URLENCODE | Codifica o texto e os valores do campo de mesclagem para uso em URLs ao substituir caracteres que sejam ilegais nos URLs, como espaços em branco, com o código que os representa, conforme definido em RFC 3986, identificador uniforme de recurso (URI): Sintaxe genérica. Por exemplo: espaços em branco são substituídos por %20 e pontos de exclamação são substituídos por %21. |
| VALUE | Converte uma string de texto em um número. |
Funções de resumo
Estas funções estão disponíveis com relatórios de resumo, de matriz e combinados.
| Função | Descrição |
|---|---|
| PARENTGROUPVAL | Retorna o valor de um agrupamento pai especificado. Um agrupamento “pai” é qualquer nível acima do nível que contém a fórmula. Você pode usar essa função apenas em fórmulas de resumo personalizadas e em níveis de agrupamento para relatórios, mas não em níveis de resumo. |
| PREVGROUPVAL | Retorna o valor de um agrupamento anterior especificado. Um agrupamento “anterior” é um que vem antes do agrupamento atual no relatório. Escolha o nível de agrupamento e o incremento. O incremento é o número de colunas ou linhas antes do resumo atual. O padrão é 1, o máximo é 12. Você pode usar essa função apenas em fórmulas de resumo personalizadas e em níveis de agrupamento para relatórios, mas não em níveis de resumo. |
Funções avançadas
| Função | Descrição |
|---|---|
| CURRENCYRATE | Retorna a taxa de câmbio da moeda corporativa referente ao código ISO dado. Se a moeda for inválida, ela retornará 1,0. |
| GETRECORDIDS | Retorna uma variedade de strings na forma de IDs para os registros selecionados em uma lista, como um modo de exibição de lista ou uma lista relacionada. |
| IMAGEPROXYURL | Recupera imagens externas com segurança e impede solicitações não autorizadas de credenciais do usuário. |
| INCLUDE | Retorna conteúdo de um snippet s-control. Use esta função para reutilizar código comum em vários s-controls. |
| ISCHANGED | Compara o valor de um campo ao valor anterior e retorna VERDADEIRO se os valores diferirem. Se os valores forem iguais, retornará FALSE. |
| JUNCTIONIDLIST | Retorna um JunctionIDList com base nos IDs fornecidos. |
| LINKTO | Retorna um URL relativo na forma de link (marcas href e de âncora) para um custom s-control ou uma página do Salesforce. |
| PREDICT | Retorna uma previsão do Einstein Discovery para um registro com base no ID de registro especificado ou para uma lista de campos e seus valores. |
| REGEX | Compara um campo de texto com uma expressão regular e retorna VERDADEIRO se há correspondência. Caso contrário, retorna FALSE. Uma expressão regular é uma string usada para descrever um formato de string de acordo com algumas regras de sintaxe. |
| REQUIRESCRIPT | Retorna uma marca de script com a origem em um URL especificado por você. Use esta função ao fazer referência ao kit de ferramentas AJAX da Plataforma do Lightning ou a outros kits de ferramentas JavaScript. |
| URLFOR | Retorna um URL relativo para uma ação, s-control, página do Visualforce ou arquivo em um repositório de recursos estáticos em uma página do Visualforce. |
| VLOOKUP | Retorna um valor procurando um valor relacionado em um objeto personalizado semelhante à função do Excel VLOOKUP(). |
- Todos os operadores de fórmula e funções
Use operadores e funções ao criar fórmulas. Todas as funções estão disponíveis em toda parte, de forma que é possível incluir uma fórmula como campos de fórmula, regras de validação, processos de aprovação e regras de fluxo de trabalho, a não ser que haja alguma especificação diferente.
Consulte também:
Este artigo resolveu seu problema?
Diga-nos para podermos melhorar!
