> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brainchat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Referência de funções

> Todas as funções disponíveis nas fórmulas, no valor inicial e nas regras das tabelas do Brainchat, com exemplos.

Esta é a lista completa de funções que você pode usar em **Fórmula**, **Valor inicial**, regras de exibição, edição e validação das colunas, e nas expressões do Flow. Para entender como as fórmulas funcionam, veja [Fórmulas e valor inicial](https://docs.brainchat.app/insights/tabelas/formulas.md).

* 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 `TRUE` e `FALSE`.
* Nas funções de lista `FILTER`, `COUNTIF` e `SUMIF`, `[_item_]` representa cada item da lista.

> [!WARNING]
>
> `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](#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

> [card] [Fórmulas e valor inicial](https://docs.brainchat.app/insights/tabelas/formulas.md)
>
> Como preencher campos com fórmulas e ler dados de outras tabelas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.