Funções e operadores do TimeTonic:
O guia completo para fórmulas V2
No TimeTonic, uma coluna de fórmula não exibe simplesmente um valor: ela calcula, transforma e adapta-o em tempo real. Com as fórmulas V2, você tem acesso a um poderoso mecanismo de cálculo que combina funções de data, texto, numéricas e lógicas para automatizar seus processos de negócios, sem escrever uma única linha de código. Este guia explica como funciona, o que cada família de funções faz e fornece a lista completa de todas as funções disponíveis com sua sintaxe exata e exemplos concretos.
Novas funções
O mecanismo de fórmulas do TimeTonic está em constante evolução. Sempre que nossa equipe de engenharia lança uma nova função, ela aparece na tabela abaixo — assim, você tem sempre uma visão atualizada das últimas adições, sem precisar procurar nas notas de lançamento. As funções listadas aqui também estão documentadas nas tabelas de categorias relevantes mais adiante neste guia.
| Função | Sintaxe | Exemplo | Descrição |
|---|---|---|---|
| MÉDIA | MÉDIA(val1, val2, ...) |
MÉDIA(10, 15, 20) ➡️ 15 |
Calcula a média de um conjunto de números. |
| TETO | TETO(valor) |
TETO(4,3) ➡️ 5 |
Arredonda um número para o inteiro mais próximo. |
| COUNTIF | COUNTIF(valor, critério, separador) |
COUNTIF("101 205 301 50", ">100", " ") ➡️ 3 |
Conta os elementos em um campo de texto ou relacional que correspondem a um critério, após dividir por separador. |
| ENCONTRAR | FIND(encontrar, dentro, posição inicial) |
ENCONTRAR("A", "BANANA", 1) ➡️ 2 |
Retorna a posição exata de uma substring (distingue maiúsculas de minúsculas). |
| PISO | PISO(valor) |
PISO(4.3) ➡️ 4 |
Arredonda um número para o inteiro mais próximo. |
| INT | INT(valor) |
INT(3,7) ➡️ 3 |
Retorna a parte inteira de um número, arredondando para baixo. |
| ISO_WEEKNUM | ISO_WEEKNUM(data) |
ISO_WEEKNUM(2026-01-01) ➡️ 1 |
Retorna o número da semana ISO de uma data (as semanas começam na segunda-feira; a semana 1 contém a primeira quinta-feira do ano). |
| ESQUERDA | ESQUERDA(texto, número) |
ESQUERDA("ABC1234", 3) ➡️ "ABC" |
Extraia os primeiros n caracteres de uma string. |
| COMPRIMENTO | COMPRIMENTO(texto) |
LENGTH("Olá") ➡️ 5 |
Retorna o número de caracteres em uma string (incluindo espaços). |
| INFERIOR | MENOR(texto) |
LOWER("OLÁ MUNDO") ➡️ "olá mundo" |
Converte todas as letras para minúsculas. |
| MEDIAN | MEDIAN(val1, val2, ...) |
MEDIAN(3, 1, 8, 9, 2) ➡️ 3 |
Retorna o valor mediano de um conjunto de números. |
| REGEXEXTRACT | REGEXEXTRACT(texto, padrão) |
REGEXEXTRACT("pedido n°24158", "[0-9]+") ➡️ "24158" |
Extraia o primeiro valor que corresponda a uma expressão regular. |
| REGEXMATCH | REGEXMATCH(texto, padrão) |
REGEXMATCH("ref T51234", "([A-Z].*([0-9]){5}") ➡️ verdadeiro |
Verifica se um texto corresponde a uma expressão regular. Retorna verdadeiro ou falso. |
| REGEXREPLACE | REGEXREPLACE(texto, padrão, substituição?) |
REGEXREPLACE("Supermercado", "Super", "Hiper") ➡️ "Hipermercado" |
Substitui todas as correspondências de uma expressão regular por um novo texto. |
| SUBSTITUIR | REPLACE(texto, posição, comprimento, novo_texto) |
REPLACE("TimeTonic", 1, 4, "Demo") ➡️ "DemoTonic" |
Substitui uma parte do texto definida por uma posição e um comprimento. |
| CORRETO | RIGHT(texto, número) |
RIGHT("ABC1234", 4) ➡️ "1234" |
Extrai os últimos n caracteres de uma string. |
| ROUND | ROUND(valor, precisão) |
ROUND(3,14159, 2) ➡️ 3,14 |
Arredonda um valor para o número desejado de casas decimais. |
| ROWID | ROWID() |
ROWID() ➡️ “jklm1234” |
Retorna o identificador técnico exclusivo de uma linha. Permite referência estável à linha. |
| PESQUISAR | SEARCH(encontrar, dentro, posição inicial) |
PESQUISAR("ban", "Banana", 1) ➡️ 1 |
Retorna a posição de uma substring (sem distinção entre maiúsculas e minúsculas). |
| STDEV | STDEV(val1, val2, ...) |
STDEV(4, 5, 8, 10) ➡️ 2,75 |
Calcula o desvio padrão de um conjunto de números. |
| SUBSTITUTO | SUBSTITUIR(texto, antigo, novo, instância?) |
SUBSTITUIR("TT-2026-01", "TT", "TM") ➡️ "TM-2026-01" |
Substitui uma ou mais ocorrências de uma string por outra. |
| MUDANÇA | SWITCH(fonte, val1, res1, val2, res2, ..., padrão) |
SWITCH(Status, “Novo”, “Urgente”, “Concluído”, “Fechado”, “Desconhecido”) |
Compara uma expressão com vários casos e retorna o primeiro resultado correspondente. Substitui cadeias IF() aninhadas. |
| TRIM | TRIM(texto) |
TRIM(" Olá, mundo ") ➡️ "Olá, mundo" |
Remove espaços internos à esquerda, à direita e extras. |
| PARTE SUPERIOR | SUPERIOR(texto) |
UPPER("lorem ipsum") ➡️ "LOREM IPSUM" |
Converte todas as letras para maiúsculas. |
| NÚMERO DA SEMANA | WEEKNUM(data) |
SEMANANUM(2026-01-10) ➡️ 2 |
Retorna o número da semana de uma data (as semanas começam no domingo; a semana 1 contém o dia 1º de janeiro). |
Fórmulas do TimeTonic: muito mais do que uma simples planilha
A diferença entre um campo de texto e uma coluna de fórmula
Um campo de texto armazena o que você digita. Uma coluna de fórmula, por outro lado, calcula automaticamente seu valor a partir de outras colunas, da data de hoje ou de regras que você define. O resultado: seus dados permanecem atualizados o tempo todo, sem a necessidade de intervenção manual.
Na prática, isso significa que você pode exibir a idade de um contrato em dias, sinalizar automaticamente itens em falta ou criar um identificador único a partir do nome e da data de início de um membro da equipe | tudo isso sem sair do TimeTonic.
Quais funções permitem automatizar sem codificação
Como funcionam as fórmulas: a lógica por trás delas
Funções, operadores, campos e constantes
Todas as fórmulas TimeTonic são compostas por quatro elementos básicos:
- Funções: as operações a realizar (calcular uma diferença de datas, converter para maiúsculas, arredondar um número...).
- Operadores: comparam ou combinam valores (
==,>,e…). - Campos: suas colunas TimeTonic, referenciadas no editor com o
$símbolo ou selecionado no painel do glossário. - Constantes: valores fixos que você digita diretamente, como um número ou uma string entre aspas.
Aninhamento: fórmulas dentro de fórmulas
O verdadeiro poder das fórmulas V2 reside na sua capacidade de aninhamento: o resultado de uma função pode tornar-se o argumento de outra. É isso que permite construir uma lógica sofisticada numa única expressão.
Aqui está um exemplo concreto: determinar se uma pessoa é menor ou maior de idade com base na sua data de nascimento.
Aqui, ANO_ADICIONAR() primeiro calcula a data da maioria, depois o resultado é comparado com HOJE() através da condição ternária. Três elementos aninhados, um resultado legível.
Formato de saída: controlando o que os usuários veem
Depois de escrever sua fórmula, a guia Formato de saída permite definir como o resultado será exibido: texto simples, texto com várias linhas, URL, data (com ou sem hora), número (com arredondamento e símbolo de moeda) ou coordenadas geográficas.
Operadores: comparar, combinar, condicionar
Operadores de comparação, aritméticos e lógicos
Os operadores são os conectores lógicos e aritméticos das suas fórmulas. Eles permitem comparar dois valores, realizar operações matemáticas ou combinar várias condições.
| Nome | Sintaxe | Exemplo | Descrição |
|---|---|---|---|
| EQUAL | == |
5 == 5 ➡️ verdadeiro |
Verifica se dois valores são iguais. |
| NÃO IGUAL | != |
5 != 3 ➡️ verdadeiro |
Verifica se dois valores são diferentes. |
| MENOS DE | < |
3 < 5 ➡️ true |
Verifica se um valor é estritamente menor que outro. |
| MAIS DO QUE | > |
5 > 3 ➡️ verdadeiro |
Verifica se um valor é estritamente maior que outro. |
| MENOS OU IGUAL | <= |
3 <= 5 ➡️ true |
Verifica se um valor é menor ou igual a outro. |
| MAIS OU IGUAL | >= |
5 >= 5 ➡️ verdadeiro |
Verifica se um valor é maior ou igual a outro. |
| E | e |
idade > 18 e cidade == “Londres” |
Retorna verdadeiro se todas as condições forem verdadeiras. |
| OU | ou |
idade > 18 ou cidade == “Londres” |
Retorna verdadeiro se pelo menos uma condição for verdadeira. |
| NÃO | não |
NÃO ter idade > 18 |
Inverte uma condição. Verdadeiro se a condição for falsa. |
| EM | em |
IN("5", [1, 2, 3, 5]) ➡️ verdadeiro |
Verifica se um valor pertence a um conjunto de valores. |
| MAIS | + |
5 + 3 ➡️ 8 |
Adiciona dois valores. |
| MINUS | - |
5 - 3 ➡️ 2 |
Subtrai um valor de outro. |
| MULTIPLICAR | * |
5 * 3 ➡️ 15 |
Multiplica dois valores. |
| DIVIDIR | / |
15 / 3 ➡️ 5 |
Divide um valor por outro. |
| MODULO | % |
10 % 3 ➡️ 1 |
Retorna o resto de uma divisão. Útil para verificações de paridade/imparidade ou gerenciamento de ciclo. |
| POTÊNCIA | ** |
2 ** 3 ➡️ 8 |
Elevar um valor à potência de outro. |
| CONDIÇÃO TERNÁRIA | condição ? seVerdadeiro : seFalso |
X > 5 ? “Sim”: “Não” |
Retorna um dos dois valores com base no resultado de uma condição. O operador mais poderoso para exibição condicional. |
Caso de uso empresarial: qualificar automaticamente um lead por pontuação
Um representante de vendas gerencia seus clientes potenciais em seu CRM. Cada cliente potencial tem uma pontuação entre 0 e 100. Usando a condição ternária, uma coluna de fórmula exibe automaticamente a qualificação: