Como formatar uma data em uma fórmula do Notion

As fórmulas do Notion podem transformar valores brutos de data em texto legível para relatórios, quadros de tarefas ou painéis de projeto. Sem formatação, uma propriedade de data como Prazo aparece como um timestamp completo difícil de escanear. Este artigo explica como usar a função formatDate() para converter datas em formatos de string personalizados. Você aprenderá a sintaxe, os tokens disponíveis e exemplos práticos para dia-mês-ano, dia da semana e strings de data relativa.

O que a função formatDate() faz e o que você precisa antes de usá-la

A função formatDate() recebe dois argumentos: um valor de data e uma string de formato. Ela retorna a data como texto simples. O valor de data pode vir de uma propriedade de data, da função now(), de um resultado de dateAdd() ou de qualquer expressão que produza um tipo data.

A string de formato usa tokens que representam partes de uma data. Esses tokens diferenciam maiúsculas de minúsculas. Por exemplo, YYYY retorna o ano com quatro dígitos, enquanto YY retorna o ano com dois dígitos. O Notion segue a sintaxe de tokens do Moment.js para a maioria dos padrões. Uma lista completa de tokens suportados está disponível na referência de fórmulas do Notion, mas os mais comuns são abordados neste artigo.

Antes de escrever uma fórmula, verifique se a propriedade que você deseja formatar é do tipo data. Se a propriedade for uma string de texto que parece uma data, você deve primeiro convertê-la usando parseDate(). A função formatDate() não funcionará em valores que não são data e retornará um erro.

Passos para escrever uma fórmula de formatação de data em uma propriedade do Notion

Estes passos assumem que você já tem um banco de dados com uma propriedade de data. Se não tiver, crie uma nova propriedade do tipo Data primeiro.

1. Abra o banco de dados e adicione uma propriedade Fórmula
   Clique no botão + no cabeçalho da última coluna do seu banco de dados. Selecione Fórmula na lista de tipos de propriedade. Nomeie a propriedade como Data Formatada ou qualquer nome de sua preferência.
2. Clique na célula da fórmula para abrir o editor de fórmulas
   Na nova coluna, clique em qualquer célula. O painel do editor de fórmulas abre no lado direito da tela. É aqui que você digita a expressão formatDate().
3. Digite a sintaxe básica do formatDate()
   No editor, insira:
   formatDate(prop("Prazo"), "DD/MM/YYYY")
   Substitua Prazo pelo nome exato da sua propriedade de data. O segundo argumento é a string de formato. Este exemplo produz algo como 15/04/2025.
4. Teste a fórmula e ajuste a string de formato
   Clique em Concluído ou pressione Ctrl + Enter (Windows) ou Cmd + Enter (Mac). A célula exibe a data formatada. Se o resultado parecer errado, verifique novamente o nome da propriedade e as maiúsculas/minúsculas dos tokens.
5. Adicione mais tokens para dia da semana, hora ou strings relativas
   Para incluir o dia da semana, altere a string de formato para "dddd, D de MMMM de YYYY". Isso gera terça-feira, 15 de abril de 2025. Para hora no formato 12h, adicione h:mm A: "DD/MM/YYYY h:mm A" produz 15/04/2025 3:30 PM.

Usando formatDate com now() para a data atual

Você pode formatar a data e hora atuais sem uma propriedade de data. Use now() como primeiro argumento. Por exemplo:
formatDate(now(), "dddd, D de MMMM de YYYY")
Esta fórmula é atualizada sempre que a página é recarregada. É útil para um timestamp que mostra quando o banco de dados foi visualizado pela última vez.

Formatando datas relativas com formatDate

O Notion não possui um token de data relativa embutido como “há 2 dias” dentro de formatDate(). Para criar uma string de data relativa, combine formatDate() com dateBetween() e lógica condicional. Exemplo de fórmula:
if(dateBetween(now(), prop("Prazo"), "days") == 0, "Hoje", formatDate(prop("Prazo"), "MMM D"))
Isso mostra Hoje quando o prazo é o dia atual, caso contrário, mostra o mês e dia abreviados.

Erros comuns e limitações ao formatar datas

formatDate retorna um erro porque a propriedade não é uma data

Se o tipo da propriedade for Texto ou Seleção, formatDate() não funcionará. Verifique o tipo da propriedade nas configurações do banco de dados. Se o valor for uma string de texto que parece uma data, use parseDate() primeiro:
formatDate(parseDate(prop("Texto de Data")), "DD/MM/YYYY")
Isso converte o texto em uma data antes de formatar.

A data formatada mostra o mês ou dia errado

Isso geralmente acontece quando as maiúsculas/minúsculas do token estão incorretas. MM retorna o número do mês (01 a 12). mm retorna minutos e não é um token de mês válido. Use M para mês com um dígito (1 a 12) ou MM para mês com zero à esquerda. Da mesma forma, use DD para dia com zero à esquerda e D para dia com um dígito.

O nome do dia da semana aparece no idioma errado

O Notion usa a configuração de idioma do workspace para determinar a localidade dos nomes de dias da semana e meses. Para alterar o idioma, vá em Configurações e Membros > Idioma e Região > Idioma. Alterar essa configuração afeta todos os usuários no workspace. Não há token para substituir a localidade dentro de uma única fórmula.

formatDate produz um timestamp em vez de uma data limpa

Se a string de formato estiver ausente ou for inválida, formatDate() pode retornar o timestamp ISO padrão. Sempre coloque a string de formato entre aspas duplas. Uma aspa de fechamento ausente ou um erro de digitação em um token fará com que a fórmula falhe ou retorne texto inesperado.

Comparação de tokens comuns do formatDate

Token	Saída (Exemplo)	Observações
YYYY	2025	Ano com quatro dígitos
YY	25	Ano com dois dígitos
MMMM	abril	Nome completo do mês (sensível à localidade)
MMM	abr	Nome abreviado do mês
MM	04	Número do mês com zero à esquerda
M	4	Número do mês com um dígito
DD	15	Dia do mês com zero à esquerda
D	15	Dia do mês com um dígito (igual a DD para dias de dois dígitos)
dddd	terça-feira	Nome completo do dia da semana (sensível à localidade)
ddd	ter	Nome abreviado do dia da semana
h	3	Hora no formato 12h sem zero à esquerda
hh	03	Hora no formato 12h com zero à esquerda
mm	30	Minutos com zero à esquerda
A	PM	AM / PM em maiúsculas

Use esta tabela como referência rápida ao construir sua string de formato. Combine tokens com separadores como barras, traços, espaços ou dois pontos para criar a saída exata que você precisa.

Agora você pode formatar qualquer propriedade de data no Notion usando a função formatDate() com tokens personalizados. Comece escrevendo um formato simples DD/MM/YYYY e depois expanda para incluir nomes de dias da semana ou componentes de hora. Para casos de uso avançados, combine formatDate() com dateBetween() e instruções condicionais if() para mostrar rótulos relativos como Atrasado ou Vence Amanhã. Lembre-se de que o idioma do workspace controla a localidade para nomes de meses e dias da semana; verifique a configuração de idioma se a saída aparecer em um idioma inesperado.