Essa documentação diz respeito aos blocos de programação Formatar Data (depreciado) e Formatar Data com Fuso (depreciado), apesar de terem nomes parecidos, funcionam de formas diferentes.

Para mais detalhes sobre as máscaras aceitas por esses blocos, acesse a documentação oficial.


Os blocos a seguir estão depreciados e serão descontinuados em breve, recomendamos utilizar os novos blocos Formatar Data e Formatar Data com Fuso.


Formatar data [depreciado]

Formata uma determinada data a partir da máscara (padrão) informada. 

Esse bloco sempre retornará termos em inglês ao informar meses ou dias. Utilize o novo bloco Formatar Data para selecionar o idioma de retorno.

Parâmetros de Entrada

NomeTipoDoc
Parâmetro 1dataData para formatação
Parâmetro 2StringMáscara a ser aplicada

Retorno

Retorna uma string formatada com o padrão da máscara passada como argumento.

Compatibilidade

 Servidor

Exemplo 1

A função abaixo recebe a data e hora atual e aplica a máscara (EEEEE MMMMM yyyy HH:mm:ss.SSS) passada como parâmetro. O resultado está impresso no Console do Depurador. 


Figura 1 - Executando o bloco Formatar data


Formatar data com Fuso Horário [depreciado]

Formata uma determinada data (com um fuso horário) a partir da máscara (padrão) informada. 

Esse bloco sempre retornará termos em inglês ao informar meses ou dias. Utilize o novo bloco Formatar data com Fuso Horário para selecionar o idioma de retorno.

Parâmetros de Entrada

NomeTipoDoc
Parâmetro 1dataData para formatação
Parâmetro 2StringMáscara a ser aplicada
Parâmetro 3Inteiro

Valor do fuso horário. Não é necessário informar "+" para valores positivos.

Ex:

  • -5
  • 3

Retorno

Retorna uma string formatada com o padrão da máscara passada como argumento.

Compatibilidade

 Servidor

Exemplo 1

A função abaixo recebe a data e hora atual, mais o fuso horário (3), e aplica a máscara (EEEEE MMMMM yyyy HH:mm) passada como parâmetro. O resultado está impresso no Console do Depurador.


Figura 2 - Executando o bloco Formatar data com Fuso Horário

Nessa página


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

Exemplos de padrões

  • dd/MM/yyyy
  • dd-MM-yyyy
  • MM/dd/yyyy
  • yyyy-MM-dd
  • yy/MM/dd



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

Exemplo de padrão

dd/MM/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). 


Saiba mais

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