formatDateTime
Converte uma data em texto no formato que você escolher. É a função mais usada para mostrar datas ao usuário e para montar nomes de arquivo, e a que mais dá erro por causa de maiúsculas e minúsculas.
Sintaxe
formatDateTime(data, [formato], [cultura])
Exemplos testados
| Expressão | Resultado |
|---|---|
formatDateTime('2026-11-02T08:05:09Z', 'dd/MM/yyyy HH:mm:ss') | 02/11/2026 08:05:09 |
formatDateTime('2026-11-02T08:05:09Z', 'mm')mm minúsculo = minutos | 05 |
formatDateTime('2026-11-02T08:05:09Z', 'MM')MM maiúsculo = mês | 11 |
formatDateTime('2026-03-07T15:04:05.678Z', 'dddd, d ''de'' MMMM ''de'' yyyy', 'pt-BR')o texto fixo usa aspas dobradas dentro da expressão | sábado, 7 de março de 2026 |
formatDateTime('2026-03-07T15:04:05.678Z', 'MMMM', 'en-US') | March |
formatDateTime('2026-03-07T15:04:05.678Z', 'yyyyMMdd_HHmmss')bom para nomes de arquivo | 20260307_150405 |
formatDateTime('2026-03-07T15:04:05.678Z', 'd', 'pt-BR')'d' sozinho é um formato padrão | 07/03/2026 |
formatDateTime('2026-11-02T08:05:09Z')sem formato: ISO completo | 2026-11-02T08:05:09.0000000Z |
Quando usar
Use formatDateTime sempre que uma data for mostrada a alguém ou gravada como texto: no corpo de um e-mail, no nome de um arquivo (yyyyMMdd_HHmmss), no título de uma aprovação ou em uma coluna de texto do SharePoint. Não use para fazer contas: formate só no final, depois de somar dias, converter o fuso ou comparar. Mantenha as datas como datas (ISO) enquanto o fluxo calcula e só transforme em texto na última ação. Isso evita o erro clássico de comparar "02/11/2026" com "15/10/2026" como se fossem textos: em ordem alfabética o primeiro viria antes, mesmo sendo uma data posterior.
Armadilhas
- MM é mês, mm é minuto. Trocar as maiúsculas é o erro número um: o fluxo não falha, grava o valor errado.
- HH é 24 horas e hh é 12 horas. Com
hh, acrescentettpara AM/PM. - Uma letra só é formato padrão.
'H'falha com "format parameter 'H' is not supported"; para o formato personalizado escreva'%H'. - Aspas simples dentro do formato se dobram. O formato
dd 'de' MMMMvira'dd ''de'' MMMM'na expressão. - Sem cultura, vale a do fluxo, que costuma ser en-US: os nomes saem em inglês.
Perguntas frequentes
Como mostrar a data no horário de Brasília?
Converta o fuso antes de formatar, com convertTimeZone. utcNow() devolve sempre UTC.
Os milissegundos são arredondados?
Não, são truncados: ff de 15:04:05.678 devolve 67.
Onde testo um formato antes de colar no fluxo?
No testador de formato de data, que mostra o resultado enquanto você digita.