parseDateTime
Transforma um texto em data. Serve para ler datas digitadas por pessoas, como 03/04/2026, antes de somar dias, comparar ou formatar. O parâmetro de cultura decide qual número é o dia e qual é o mês.
Sintaxe
parseDateTime(texto, [cultura], [formato])
Exemplos testados
| Expressão | Resultado |
|---|---|
parseDateTime('03/04/2026', 'pt-BR')3 de abril | 2026-04-03T00:00:00.0000000 |
parseDateTime('03/04/2026', 'en-US')4 de março | 2026-03-04T00:00:00.0000000 |
formatDateTime(parseDateTime('03/04/2026', 'pt-BR'), 'dd/MM/yyyy')ida e volta | 03/04/2026 |
Quando usar
Use parseDateTime sempre que a data chegar como texto digitado por pessoas ou exportado de planilhas: campos de formulário, colunas de texto, arquivos CSV. É o primeiro passo antes de qualquer conta com datas, porque addDays, formatDateTime e as comparações precisam de uma data de verdade, não de um texto parecido com data. O padrão seguro é converter logo que o dado entra no fluxo, guardar o resultado em uma ação Compor com nome claro (por exemplo, Data_vencimento) e usar essa ação no resto do fluxo. Informe sempre a cultura ('pt-BR'): é o que impede que o dia e o mês troquem de lugar em silêncio.
Armadilhas
- Sem cultura, o dia e o mês podem trocar. Com
'en-US',03/04/2026é 4 de março; com'pt-BR', é 3 de abril. Informe sempre a cultura. - O resultado não traz fuso (não termina em Z). Combine com
convertTimeZonese o fuso importar. - O texto precisa estar limpo. Espaços, barras diferentes ou ano de dois dígitos podem dar erro: valide antes.
Perguntas frequentes
Como somar 30 dias a uma data digitada?
Primeiro converta com parseDateTime(..., 'pt-BR') e depois use addDays sobre o resultado.
Como mostrar o resultado como dd/mm/aaaa?
Passe-o por formatDateTime, como no último exemplo.