- Os nomes das funções são em inglês, no estilo do AppSheet.
- Argumentos são separados por vírgula (ponto e vírgula também é aceito).
- Campos vão entre colchetes (
[Valor]) e textos entre aspas ("Pago"). - Verdadeiro e falso são
TRUEeFALSE. - Nas funções de lista
FILTER,COUNTIFeSUMIF,[_item_]representa cada item da lista.
LOOKUP e SELECT usam a ordem de argumentos do Brainchat, diferente do AppSheet: o nome da tabela vem sempre primeiro. Veja a seção Tabela.Lógica
| Função | O que faz | Exemplo |
|---|---|---|
IF(condition, value_if_true, value_if_false) | Devolve o primeiro valor quando a condição é verdadeira e o segundo quando é falsa. | IF([Valor] > 1000, "Alto", "Normal") |
IFS(cond1, value1, cond2, value2, …) | Testa condições em sequência e devolve o valor da primeira verdadeira. | IFS([Nota] >= 9, "Ótimo", [Nota] >= 7, "Bom", TRUE, "Revisar") |
SWITCH(value, key1, result1, …, default) | Compara o valor com cada chave e devolve o resultado correspondente. | SWITCH([UF], "SP", "Sudeste", "BA", "Nordeste", "Outra") |
AND(cond1, cond2, …) | Verdadeiro quando todas as condições são verdadeiras. | AND([Status] = "Aprovado", [Valor] > 0) |
OR(cond1, cond2, …) | Verdadeiro quando pelo menos uma condição é verdadeira. | OR([UF] = "SP", [UF] = "RJ") |
NOT(condition) | Inverte o resultado da condição. | NOT(ISBLANK([CNPJ])) |
ISBLANK(value) | Verdadeiro quando o campo não tem valor. | ISBLANK([Observação]) |
ISNOTBLANK(value) | Verdadeiro quando o campo tem valor. | ISNOTBLANK([E-mail]) |
IN(value, list) | Verdadeiro quando o valor está na lista informada. | IN([UF], LIST("SP", "RJ", "MG")) |
Texto
| Função | O que faz | Exemplo |
|---|---|---|
CONCATENATE(text1, text2, …) | Junta vários valores em um texto único. | CONCATENATE([Nome], " - ", [Cidade]) |
TEXT(value) | Converte qualquer valor em texto. | TEXT([Valor]) |
UPPER(text) | Deixa o texto em letras maiúsculas. | UPPER([Nome]) |
LOWER(text) | Deixa o texto em letras minúsculas. | LOWER([E-mail]) |
TRIM(text) | Remove espaços sobrando no começo e no fim. | TRIM([Nome]) |
SUBSTITUTE(text, find, replace_with) | Troca todas as ocorrências de um trecho. | SUBSTITUTE([Telefone], "-", "") |
LEFT(text, count) | Primeiros caracteres do texto. | LEFT([CNPJ], 2) |
RIGHT(text, count) | Últimos caracteres do texto. | RIGHT([Protocolo], 4) |
MID(text, start, count) | Pedaço do texto a partir de uma posição (começa em 1). | MID([CPF], 4, 3) |
FIND(text, find) | Posição do trecho dentro do texto (0 quando não encontra). | FIND([E-mail], "@") |
LEN(text) | Quantidade de caracteres. | LEN([CPF]) |
SPLIT(text, separator) | Quebra o texto em uma lista. | SPLIT([Tags], ",") |
JOIN(list, separator) | Junta os itens de uma lista em texto. | JOIN([Etiquetas], ", ") |
CONTAINS(text, part) | Verdadeiro quando o texto contém o trecho. | CONTAINS([Observação], "urgente") |
STARTSWITH(text, part) | Verdadeiro quando o texto começa com o trecho. | STARTSWITH([Telefone], "55") |
ENDSWITH(text, part) | Verdadeiro quando o texto termina com o trecho. | ENDSWITH([E-mail], ".com.br") |
INITIALS(text) | Primeira letra de cada palavra. | INITIALS([Nome]) |
NUMBER(value) | Converte texto em número (vazio quando não dá). | NUMBER([Quantidade informada]) |
DIGITS(text) | Mantém apenas os números do texto. | DIGITS([Telefone]) |
ENCODEURL(text) | Prepara o texto para usar dentro de um link. | CONCATENATE("https://busca?q=", ENCODEURL([Nome])) |
UNIQUEID() | Gera um identificador aleatório. | UNIQUEID() |
Número
| Função | O que faz | Exemplo |
|---|---|---|
SUM(value1, value2, …) | Soma números ou uma lista de números. | SUM([Produto], [Frete]) |
AVERAGE(value1, value2, …) | Média dos números informados. | AVERAGE([Nota1], [Nota2]) |
MIN(value1, value2, …) | Menor valor. | MIN([Preço], 100) |
MAX(value1, value2, …) | Maior valor. | MAX([Preço], 0) |
ROUND(number, decimals) | Arredonda com a quantidade de casas escolhida. | ROUND([Total], 2) |
CEILING(number) | Arredonda para cima. | CEILING([Horas]) |
FLOOR(number) | Arredonda para baixo. | FLOOR([Horas]) |
ABS(number) | Valor sem sinal. | ABS([Saldo]) |
MOD(number, divisor) | Resto da divisão. | MOD([Quantidade], 2) |
RAND() | Número aleatório entre 0 e 1. | ROUND(RAND() * 100, 0) |
POWER(number, exponent) | Eleva o número ao expoente. | POWER([Lado], 2) |
SQRT(number) | Raiz quadrada. | SQRT([Área]) |
TRUNC(number, decimals) | Corta as casas decimais sem arredondar. | TRUNC([Total], 2) |
LN(number) | Logaritmo natural. | LN([Valor]) |
LOG(number, base) | Logaritmo na base informada (padrão 10). | LOG([Valor], 2) |
SIGN(number) | 1 para positivo, -1 para negativo, 0 para zero. | SIGN([Saldo]) |
STDEV(list) | Desvio padrão dos números informados. | STDEV(REF_ROWS([Itens], [Valor])) |
RANDBETWEEN(min, max) | Número inteiro sorteado no intervalo. | RANDBETWEEN(1, 100) |
Data e hora
| Função | O que faz | Exemplo |
|---|---|---|
TODAY() | Data de hoje (sem hora). | DAYS([Prazo], TODAY()) |
NOW() | Data e hora atuais. | HOURS(NOW(), [Abertura]) |
YEAR(date) | Ano da data. | YEAR([Criado em]) |
MONTH(date) | Mês da data (1 a 12). | MONTH([Criado em]) |
DAY(date) | Dia do mês. | DAY([Criado em]) |
HOUR(date) | Hora da data. | HOUR([Abertura]) |
MINUTE(date) | Minuto da data. | MINUTE([Abertura]) |
WEEKDAY(date) | Dia da semana (1 = domingo). | WEEKDAY(TODAY()) |
DAYS(end_date, start_date) | Diferença em dias entre duas datas. | DAYS([Prazo], TODAY()) |
HOURS(end_date, start_date) | Diferença em horas entre duas datas. | HOURS(NOW(), [Abertura]) |
DATE(text) or DATE(year, month, day) | Converte texto ou números em data. | DATE(2026, 1, 31) |
ADD_DAYS(date, days) | Soma (ou subtrai) dias a uma data. | ADD_DAYS(TODAY(), 30) |
ADD_HOURS(date, hours) | Soma (ou subtrai, com número negativo) horas a uma data. | ADD_HOURS(NOW(), -3) |
ADD_MINUTES(date, minutes) | Soma (ou subtrai) minutos a uma data. | ADD_MINUTES([Início], 30) |
FORMAT_DATE(date, format) | Formata a data (dd, MM, yyyy, HH, mm). | FORMAT_DATE([Criado em], "dd/MM/yyyy") |
SECOND(date) | Segundo da data. | SECOND(NOW()) |
WEEKNUM(date) | Número da semana no ano. | WEEKNUM(TODAY()) |
EOMONTH(date, months) | Último dia do mês, podendo avançar ou voltar meses. | EOMONTH(TODAY(), 0) |
EOWEEK(date) | Sábado da semana da data informada. | EOWEEK(TODAY()) |
WORKDAY(date, days) | Avança dias úteis (pula sábado e domingo). | WORKDAY(TODAY(), 5) |
MINUTES(end_date, start_date) | Diferença em minutos entre duas datas. | MINUTES(NOW(), [Abertura]) |
SECONDS(end_date, start_date) | Diferença em segundos entre duas datas. | SECONDS(NOW(), [Abertura]) |
DATETIME(date, time) | Junta uma data com uma hora (“HH:mm”). | DATETIME([Data], "08:30") |
Lista
| Função | O que faz | Exemplo |
|---|---|---|
LIST(item1, item2, …) | Monta uma lista com os itens informados. | IN([UF], LIST("SP", "RJ")) |
COUNT(list) | Quantidade de itens preenchidos na lista. | COUNT([Etiquetas]) |
FIRST(list) | Primeiro item da lista. | FIRST([Etiquetas]) |
UNIQUE(list) | Remove repetições da lista. | UNIQUE([Etiquetas]) |
SORT(list, descending) | Ordena os itens da lista. | SORT([Valores], TRUE) |
FILTER(list, condition with [_item_]) | Mantém apenas os itens que atendem à condição. | FILTER([Valores], [_item_] > 100) |
LAST(list) | Último item da lista. | LAST([Etiquetas]) |
INDEX(list, position) | Item em uma posição da lista (começa em 1). | INDEX([Etiquetas], 2) |
TOP(list, count) | Primeiros itens da lista. | TOP(SORT([Valores], TRUE), 3) |
INTERSECT(list1, list2) | Itens presentes nas duas listas. | INTERSECT([Etiquetas], LIST("VIP", "Novo")) |
DIFFERENCE(list1, list2) | Itens da primeira lista que não estão na segunda. | DIFFERENCE([Etiquetas], LIST("Arquivado")) |
COUNTIF(list, condition with [_item_]) | Quantos itens atendem à condição. | COUNTIF([Valores], [_item_] > 100) |
SUMIF(list, condition with [_item_]) | Soma apenas os itens que atendem à condição. | SUMIF([Valores], [_item_] > 0) |
Tabela
| Função | O que faz | Exemplo |
|---|---|---|
ANY(list) | Um valor qualquer da lista (útil depois de SELECT). | ANY(SELECT("Produtos", [Preço], [SKU] = [Código])) |
LOOKUP("Table", [search_column], value, [return_column]) | Procura a primeira linha da outra tabela e devolve o valor de uma coluna. A tabela é citada pelo nome, só entre as tabelas da organização que você lê; renomear a tabela não quebra a fórmula. | LOOKUP("Produtos", [SKU], [Código do produto], [Preço]) |
LOOKUP_ALL("Table", [search_column], value, [return_column]) | Lista os valores de uma coluna em todas as linhas da outra tabela que combinam com o valor. Se a coluna de busca guardar vários valores (lista), basta um deles combinar. A tabela é citada pelo nome, só entre as tabelas da organização que você lê; renomear a tabela não quebra a fórmula. | LOOKUP_ALL("Contatos", [Org ID], [Org ID], [Nome]) |
SELECT("Table", [column], condition) | Lista os valores de uma coluna nas linhas da outra tabela que atendem à condição. A tabela é citada pelo nome, só entre as tabelas da organização que você lê; renomear a tabela não quebra a fórmula. | SUM(SELECT("Itens", [Total], [Pedido] = [Número])) |
REF_ROWS([connection], [column]) | Valores de uma coluna nos registros ligados por uma coluna de conexão. | SUM(REF_ROWS([Itens do pedido], [Subtotal])) |
ITEMS_TOTAL([Items]) | Soma quantidade × preço dos itens do registro. | ITEMS_TOTAL([Itens]) |
ITEMS_QTY([Items]) | Soma das quantidades dos itens. | ITEMS_QTY([Itens]) |
ITEMS_COUNT([Items]) | Quantidade de linhas de item no registro. | ITEMS_COUNT([Itens]) |
Resumo de registros relacionados
[Relação] é uma coluna de conexão do registro atual ou o nome de outra tabela que tem uma conexão apontando para esta. A condição é opcional e vai sempre como último argumento.
| Função | O que faz | Exemplo |
|---|---|---|
[Relação].SUM([coluna], condição) | Soma a coluna nos registros relacionados. | [Pedidos].SUM([Valor], [Status] = "Pago") |
[Relação].SUMUNIQUE([chave], [valor], condição) | Soma o valor uma vez por chave: registros repetidos com a mesma chave contam uma vez só. | [Itens].SUMUNIQUE([Pedido], [Total do pedido]) |
[Relação].COUNT([coluna], condição) | Conta os registros relacionados. Com coluna, conta só os que têm a coluna preenchida. | [Pedidos].COUNT() |
[Relação].AVERAGE([coluna], condição) | Média da coluna nos registros relacionados. | [Avaliações].AVERAGE([Nota]) |
[Relação].MAX([coluna], condição) | Maior valor (ou data mais recente) da coluna nos registros relacionados. | [Agendamentos].MAX([Data]) |
[Relação].MIN([coluna], condição) | Menor valor (ou data mais antiga) da coluna nos registros relacionados. | [Agendamentos].MIN([Data]) |
[Relação].MAXBY([coluna de ordem], [coluna a trazer], condição) | Traz outro campo do registro relacionado com o maior valor na coluna de ordem. | [Agendamentos].MAXBY([Data], [Unidade]) |
[Relação].MINBY([coluna de ordem], [coluna a trazer], condição) | Traz outro campo do registro relacionado com o menor valor na coluna de ordem. | [Agendamentos].MINBY([Data], [Unidade]) |
[Relação].FIRST([coluna], condição) | Primeiro valor preenchido da coluna nos registros relacionados. | [Contatos].FIRST([E-mail]) |
[Relação].LIST([coluna], condição) | Lista com os valores da coluna nos registros relacionados. | [Pedidos].LIST([Número]) |
[Relação].UNIQUE([coluna], condição) | Lista dos valores da coluna nos registros relacionados, sem repetições. | [Pedidos].UNIQUE([Produto]) |
Informação
| Função | O que faz | Exemplo |
|---|---|---|
USERID() | Identificador da pessoa: em Valor inicial, quem cria o registro; em Mostrar, Editável, Obrigatório e Válido quando, fase e ação, quem vê ou age. Vazio em gravação sem pessoa (Flow, API, agendamento) e em campo com fórmula. | [Responsável] = USERID() |
USERNAME() | Nome da pessoa (o do perfil, sem nome, o e-mail). Mesma pessoa de USERID(). Use só para exibir: a própria pessoa edita o nome, então compare por USERID() ou USEREMAIL(). | USERNAME() |
ROW_ID() | Identificador do registro atual. | ROW_ID() |
CREATED_AT() | Data de criação do registro. | DAYS(TODAY(), CREATED_AT()) |
UPDATED_AT() | Data da última alteração do registro. | UPDATED_AT() |
USEREMAIL() | E-mail de login da pessoa (mesma de USERID()). No Studio público, o e-mail com que o visitante entrou; sem ele, vazio. | [Responsável] = USEREMAIL() |
USERROLE() | Papel da pessoa na organização da tabela: “dono”, “admin” (admin da organização ou da plataforma) ou “membro” (demais pessoas logadas). Vazio para visitante do Studio público e em gravação sem pessoa. | USERROLE() = "admin" |
CONTEXT("screen") | Onde a expressão está rodando: formulário, ficha, grade ou lista. | CONTEXT() = "formulario" |
Próximo passo
Fórmulas e valor inicial
Como preencher campos com fórmulas e ler dados de outras tabelas.