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
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | data | Data para formatação |
| Parâmetro 2 | String | Má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
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | data | Data para formatação |
| Parâmetro 2 | String | Máscara a ser aplicada |
| Parâmetro 3 | Inteiro | Valor do fuso horário. Não é necessário informar "+" para valores positivos. Ex:
|
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: