Formatar data
Formata uma data, hora ou data e hora, com base na máscara indicada.
Parâmetros de Entrada
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | Data e Hora | Data e hora para formatação |
| Parâmetro 2 | String | Máscara a ser aplicada |
Retorno
Retorna uma uma String formatada com o padrão da máscara passada como argumento.
Compatibilidade
Servidor
Cliente
Exemplo 1
Na figura 1, o bloco Formatar data converte o parâmetro dataHora recebido pela função com base na conteúdo obtido pelo bloco Obter data e hora atual (baseado no fuso horário do cliente) e formata usando a máscara "DD/MM/YYYY HH:mm:ss", em seguida, exibe uma notificação com o resultado do bloco Obter data e hora atual e outra com o resultado da conversão.
Figura 1 - Exemplo de uso do bloco Formatar data
A Na figura 2 exibe o resultado da função na figura 1.
Figura 2 - Data e hora formatados
, a notificação de sucesso (em verde) exibe o retorno do bloco Obter data e hora atual, que possui a hora com o fuso horário do cliente, neste exemplo é GMT -3. Já a notificação de informação (em azul) exibe o retorno do bloco Formatar Data, que possui a mesma data e hora, porém convertida a partir da máscara informada e sem o fuso horário, por isso a diferença nas horas ("12:47:05, GMT -0300" e "15:47:05").
Figura 2 - Data e hora formatados
Sobre máscaras
Sobre máscaras - Padrões para Formatação
Os padrões de máscara são baseados em sequências de letras e símbolos, usados para criar um formatador. Dentro de cadeias de padrões de data e hora, os padrões mais comumente empregados podem ser usados por uma combinação da letra y (representando um dígito de ano), M (representando um dígito de mês) e d (representando um dígito do dia).
Para saber mais sobre as máscaras, acesso o link ao lado: Formatação de máscaras para campos de texto.
| Dica | ||
|---|---|---|
| ||
DD/MM/YYYY HH:mm:ss |
Sobre Fuso horário
Acesse a documentação Entendendo o funcionamento dos tipos data e hora para saber mais sobre fusos horários.