Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Formatar data

Formata uma

determinada data utilizando um padrão específico

data, hora ou data e hora, com base na máscara indicada.

Parâmetros de Entrada

NomeTipoDoc
Parâmetro 1
data
Data e HoraData e hora para formatação
Parâmetro 2StringMáscara a ser aplicada

Retorno

Retorna uma uma

string

String formatada com o padrão da máscara passada como argumento.

Compatibilidade

Image Removed Servidor

Image Modified Cliente

Exemplo

1A função recebe a

Na figura 1, o bloco Formatar data converte o conteúdo obtido pelo bloco Obter data e hora atual

e aplica a máscara (MM/dd/yy) passada como parâmetro. 

Image Removed

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). 

Informações
titleSaiba mais

Para saber mais sobre as máscaras, acesso o link ao lado: Formatação de máscaras para campos de texto.

Dica
titleExemplos de padrões

dd/MM/yyyy, dd-MM-yyyy, MM/dd/yyyy, yyyy-MM-dd, yy/MM/dd

(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.


Image Added

Figura 1 - Exemplo de uso do bloco Formatar data


Na figura 2, 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").


Image Added

Figura 2 - Data e hora formatados


Sobre máscaras

A máscara é utilizada para alterar o formato de como a data e hora são apresentadas, por isso, existem diversos padrões. Ao utilizar "hh" (minúsculo) a hora será exibida no formato AM/PM, porém, colocando "HH" (maiúsculo), a hora será apresentada em seu formato de 24 horas.

Exemplo: Ao utiliza a máscara do exemplo abaixo na data e hora "24/02/2021 15:47:05", o resultado será "24/02/2021 03:47:05"

É possível ainda utilizar padrões específicos para hora, minuto e segundo

.

Dica
titleExemplo de
padrão
máscara
dd

DD/MM/

yyyy

YYYY hh:mm:ss

A letra h(representa um dígito da hora), m(representa um dígito de minuto) e s(representa um dígito do segundo). 


Para saber mais sobre as máscaras, acesse os links abaixo:

Sobre Fuso horário

Acesse a documentação Entendendo o funcionamento dos tipos data e hora para saber mais sobre fusos horários.