Introdução às fórmulas

Neste documento de ajuda

Aqui no Notion, você pode adicionar uma propriedade de fórmula para executar tudo quanto é cálculo e função com base em outras propriedades. Além disso, você também pode usar fórmulas para manipular dados existentes e obter outros valores úteis 🔮

As fórmulas do Notion podem executar cálculos úteis usando as propriedades, as funções e as bases de dados existentes.

Exemplos de fórmulas

Vamos analisar algumas maneiras diferentes de usar fórmulas. Se você estiver pronto para começar a criar a sua, pule para nossas instruções sobre como criar uma fórmula abaixo →

Exemplo 1: Gerenciamento de projetos

Neste exemplo, usaremos três fórmulas para acompanhar o andamento dos projetos.

Você pode explorar e brincar com as configurações da fórmula para este exemplo duplicando esta página no seu espaço de trabalho!

Meta	Nome da propriedade	Fórmula	Funções e embutidos usados
Definir o prazo de um projeto como duas semanas após a data de início	Prazo	`dateAdd(Start Date, 2, "week")`	`dateAdd()` adiciona tempo à data. O argumento da unidade pode ser um dos seguintes: `anos`, `trimestres`, `meses`, `semanas`, `dias`, `horas` ou `minutos`. Nesse caso, usaremos `semanas`.
Marque um projeto como vencido se o prazo tiver passado e seu status não for `Concluído`. Marque um projeto como vencido em negrito, letras vermelhas se o prazo tiver passado e seu status não for `Concluído`.	Vencido?	`if(and(now() > Prazo, Status != "Concluído"), "Atrasado", "")` `if(and(now() > Prazo, Status != "Concluído"), estilo("Atrasado", "vermelho", "b"), "")`	`if()` retorna o primeiro valor se a condição for verdadeira; caso contrário, retorna o segundo valor. Isso permite um resultado condicional. `and()` é um operador lógico. Isso permite avaliar múltiplos fatores como verdadeiros. `now()` retorna a data e a hora atuais. Isso permite avaliar em que ponto estamos agora, em comparação com a data de vencimento do projeto. `>` é um operador de comparação. Isso permite comparar a condição do prazo ser maior que a data atual. `!=` é um operador de comparação. Isso permite definir a condição do status não ser igual a `Concluído`. `style()` adiciona estilos e cores ao texto. Estilos de formatação válidos incluem `b` (negrito), `u` (sublinhado), `i` (itálico), `c` (código) ou `s` (tachado). Cores válidas são `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink` e `red`. Adicione `_background` às cores para definir as cores de fundo. Nesse caso, aplicaremos`negrito` e `vermelho`.
Exibir o número de tarefas vencidas associadas a um projeto	Tarefas restantes	`Tasks.length()`	`length()` retorna o comprimento do texto ou valor da lista. Isso permite uma contagem das tarefas restantes.

Exemplo 2: brainstorm de projetos

Neste exemplo, usaremos duas fórmulas para brainstorm de ideias de projetos, calcular uma pontuação de prioridade para cada uma delas e contar o número de votos a favor que cada projeto recebe.

Você pode explorar e brincar com as configurações da fórmula para este exemplo duplicando esta página no seu espaço de trabalho! Confira este modelo para ter acesso a outra configuração que usa a estrutura RICE.

Meta	Nome da propriedade	Fórmula
Com base nas pontuações de Alcance, Impacto, Confiança e Esforço (RICE), calcule uma pontuação de priorização	Pontuação (RICE)	`Alcance * Impacto * Confiança / Esforço`
Quando alguém clicar no botão de voto a favor, conte-o para o número total de votos e adicione o seu nome à página de base de dados	Total de votos	`length(Votado a favor por)`

(Avançado) Exemplo 3: Automação de gerenciamento de tarefas

Neste exemplo, usaremos algumas fórmulas em uma automação de base de dados (outro tipo de propriedade de base de dados) para facilitar o gerenciamento de projetos e tarefas à medida que são concluídos, marcando uma tarefa pai como Concluída quando todas as suas subtarefas estiverem Concluídas.

As automações de base de dados têm gatilhos e ações que são executadas com base nesses gatilhos. As fórmulas permitem definir variáveis que você pode usar em suas ações.

Você pode explorar e brincar com as configurações da fórmula para este exemplo duplicando esta página no seu espaço de trabalho!

Meta	Como construir	Funções e embutidos usados
Toda vez que uma tarefa é definida como `Concluída`, acionar a automação	Gatilho: quando o status é definido como `Concluído`	-
Defina a tarefa principal encontrando a primeira página relacionada à tarefa que acionou a automação	Ação 1: definir variável de `tarefa principal` Fórmula:`acionar page.Parent item.first()`	A `página de gatilho` faz referência à página na base de dados da qual a automação foi acionada e `.` permite acessar as propriedades associadas a essa página. `O item principal` retorna o conteúdo dessa propriedade, que neste caso é uma lista de páginas relacionadas. A aplicação da função `.first ()` na propriedade `do item Principal` retorna a primeira página relacionada dessa lista.
Se a tarefa pai tiver subtarefas, verifique se todas as suas subtarefas têm o status `Concluído`. Se a tarefa pai não tiver subtarefas, retorne `falso`.	Ação 2: definir `todas as subtarefas concluídas?` variáveis Fórmula:`Parent Task.Sub-item ? Parent Task.Sub-item.every(current.Status == \"Done\") : false`	O operador ternário `X ? Y : Z` é uma expressão condicional abreviada que significa: se a condição X for verdadeira, retorne Y; caso contrário, retorne Z. É uma alternativa concisa a uma instrução `if()` . `.every()` verifica se uma condição é verdadeira para cada item em uma lista. Dentro desta função, você pode usar a palavra-chave `current` para se referir à linha que está sendo avaliada. Nesse caso, a condição `current.Status == "Concluído"` verifica se a propriedade de status da página atual está definida como `Concluído`. Se estiver, ela retornará `verdadeiro`; caso contrário, retornará `falso`.
Se todas as subtarefas estiverem `Concluído`, defina o status da tarefa pai como `Concluído`. Caso contrário, mantenha o status existente da tarefa pai.	Ação 3: editar propriedade `Status` Fórmula: `All subtasks done? ? \"Concluído\" : Parent Task.Status`	Novamente, o operador ternário é usado aqui para verificar se todas as subtarefas estão concluídas. Se estiverem, a automação definirá o status da tarefa pai como `Concluído`; caso contrário, manterá o status da tarefa pai como está.

Mais inspiração de fórmulas

Este modelo do Notion calcula o tempo entre duas datas com uma propriedade de fórmula.
Este modelo do Notion usa uma fórmula para contar votos a favor para ideias diferentes.
Você pode encontrar ainda mais exemplos de fórmulas aqui →

Onde as fórmulas podem ser usadas

No Notion, você pode usar fórmulas de algumas maneiras diferentes:

Como uma propriedade de base de dados, que é o que este artigo aborda principalmente.
Em uma ação de botão.
Em uma ação de botão de base de dados.
Em uma ação de automação de base de dados.

Criar uma fórmula

Para criar uma fórmula de propriedade de base de dados:

Selecione o ícone deslizante na parte superior de uma base de dados → Editar propriedades → Nova propriedade.
Selecione Fórmula.
Se desejar, dê um nome à sua propriedade.
Selecione Editar fórmula.

Editar uma fórmula

Após criar uma fórmula em uma base de dados ou botão, você poderá criá-la e editá-la no editor de fórmulas, que tem é assim:

O campo na parte superior é onde você adicione e edita sua fórmula. Ao escrever sua fórmula na parte superior do editor, o editor informará o que está faltando ou o que a fórmula espera para retornar um valor para você.

O painel no lado esquerdo da edição mostra os elementos que você pode usar na fórmula — em outras palavras, as propriedades, as bases e as funções que estão disponíveis para você.

O painel no lado direito define os elementos da fórmula à medida que você passa o mouse sobre eles no painel esquerdo. Ele também fornece exemplos de como você pode usar esses elementos e como eles devem ser estruturados.

Caso você abra o editor em uma linha da base de dados, você verá uma prévia em tempo real do resultado da fórmula para essa linha.

Está com problemas com a sua fórmula? Saiba mais sobre erros comuns de fórmulas e como solucioná-los neste artigo →

Crie e edite fórmulas com a IA do Notion

Observação: este recurso só está disponível nos Planos Plus, Business e Enterprise.

Sabe o que você quer que sua fórmula faça, mas não tem certeza de como criá-la? Quer fazer alguns ajustes em uma fórmula existente? Viu um erro na sua fórmula, mas não sabe como corrigi-lo? O Notion AI pode ajudar.

Quando você estiver no editor de fórmulas, verá um campo contendo o rosto da IA do Notion. Clique neste campo e diga à IA do Notion o que você deseja que sua fórmula faça, ou faça perguntas sobre a fórmula para entendê-la melhor.

Aqui estão alguns exemplos de prompts para a IA do Notion:

“Transforme a propriedade do título em um slug de URL.”
“Mostre ⚠️ se o prazo tiver passado.”
“Adicione um dia à propriedade de data e deixe o resultado em verde e negrito.”
“Mostre a propriedade de data da base de dados relacionada” (a IA do Notion também conhece as propriedades das suas relações!)
“Coloque o resultado desta fórmula em itálico.”
“Corrija os erros nesta fórmula.”
“Ajuste a fórmula para contemplar exceções.” (Por exemplo, a IA do Notion pode adicionar uma instrução “if” para que a fórmula não falhe quando um campo estiver vazio.)
“O que esta fórmula faz?”

Assim que você adicione seu prompt, a IA do Notion gerará uma fórmula ou responderá à sua consulta sobre ela. Você também pode ver uma prévia da saída da sua fórmula, bem como habilitar Mostrar tipos para ver o tipo de saída (por exemplo, texto), para que você possa garantir que tudo esteja como deseja. Você pode desfazer as alterações da IA do Notion, fornecer mais prompts ou dar um like ou dislike para nos informar como ele se saiu.

Ao criar e editar fórmulas usando a IA do Notion, observe que ela atualmente não contempla o seguinte:

Lógica iterativa (como no caso de loops).
Gerações aleatórias que exigiriam uma função random(), que as fórmulas do Notion não possuem. Um prompt como “Gere um número aleatório entre 1 e 10” não funcionaria.
Lembrar de prompts anteriores.

A IA do Notion pode ajudar você com propriedades de fórmulas, bem como fórmulas dentro de botões, botões de base de dados e automações de base de dados.

Qual a composição das fórmulas

As fórmulas podem ser criadas usando uma combinação de:

Propriedades.
Integrados, ou operadores e booleanos que são usados para configurar um cálculo específico. Alguns exemplos incluem + (adição), false e or.
Funções, ou ações que a fórmula pode realizar para retornar um determinado resultado. Alguns exemplos incluem replace, sum e ordenar.

Uma lista completa dos embutidos e funções que estão disponíveis nas fórmulas pode ser encontrada aqui →