Essa documentação diz respeito aos blocos de programação Formatar Data e Formatar Data com Fuso, apesar de terem nomes parecidos, funcionam de formas diferentes.
Para mais detalhes sobre as máscaras aceitas por esse bloco, acesse a documentação oficial.
Formatar data
Formata uma determinada data a partir da máscara informada, permite selecionar o idioma de retorno a partir das configurações do cliente ou servidor.
Parâmetros de Entrada
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | date | Data para formatação |
| Parâmetro 2 | String | Máscara a ser aplicada |
| Parâmetro 3 | Boolean | Define o idioma da data formatada:
|
Retorno
Retorna uma string formatada com o padrão da máscara e idioma passados 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. A função foi requisitada 3 vezes (destaque 1 da figura 1) alterando apenas a configuração do parâmetro "Usar idioma do cliente?" e o campo "País e Idioma" nas configurações do projeto.
- A opção "Usar idioma do cliente" foi marcado como "Sim" e o navegador que executou a aplicação estava configurado para o idioma "Francês".
- A opção "Usar idioma do cliente" foi marcado como "Não" e não foi definido um valor no campo "País e Idioma" nas configurações do projeto, logo o bloco usou a configuração de idioma da máquina virtual do servidor.
- A opção "Usar idioma do cliente" foi marcado como "Não" e o valor no campo "País e Idioma" nas configurações do projeto foi definido como "Brasil - Português".
Figura 1 - Executando o bloco Formatar data
Formatar data com Fuso Horário
Formata uma determinada data (com um fuso horário) a partir da máscara informada, permite selecionar o idioma de retorno a partir das configurações do cliente ou servidor.
Parâmetros de Entrada
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | date | 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:
|
| Parâmetro 4 | Boolean | Define o idioma da data formatada:
|
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.
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. A função foi requisitada 3 vezes (destaque 1 da figura 2) alterando apenas a configuração do parâmetro "Usar idioma do cliente?" e o campo "País e Idioma" nas configurações do projeto.
- A opção "Usar idioma do cliente" foi marcado como "Sim" e o navegador que executou a aplicação estava configurado para o idioma "Francês".
- A opção "Usar idioma do cliente" foi marcado como "Não" e não foi definido um valor no campo "País e Idioma" nas configurações do projeto, logo o bloco usou a configuração de idioma da máquina virtual do servidor.
- A opção "Usar idioma do cliente" foi marcado como "Não" e o valor no campo "País e Idioma" nas configurações do projeto foi definido como "Brasil - Português".
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: