sDateFormat
Veja também:
sDateFormat
A função sDateFormat recebe uma data e uma string de máscara e retorna a data formatada.
Tipo de Retorno
String
Pacote
A função sDateFormat está definida dentro do pacote FormatDateTime.pkg.
Sintaxe
Move (sDateFormat({dData},{sMascara})) to {sRet}
Onde:
- {dDate} é a data que será formatada. Se for passado 0 (zero), utilizará a data corrente;
- {sMascara} é uma string com a máscara de formatação. Você pode usar os seguintes tokens de máscara;
-
d – dia do mês sem zero à esquerda nos dias com um único dígito.
-
dd – dia do mês com zero à esquerda nos dias com um único dígito.
-
ddd – dia da semana abreviado.
-
dddd – nome completo do dia da semana.
-
M – mês do ano sem zero à esquerda nos meses com um único dígito.
-
MM – mês do ano com zero à esquerda nos meses com um único dígito.
-
MMM – nome do mês abreviado.
-
MMMM – nome completo do mês.
-
y – ano com 2 dígitos, mas sem zero à esquerda nos anos menores que 10.
-
yy – ano com 2 dígitos, mas com zero à esquerda nos anos menores que 10.
-
yyyy – ano com 4 ou 5 dígitos, dependendo do calendário.
-
yyyyy – igual a “yyyy”
-
gg – era/período. Este elemento será ignorado se a data a ser formatada não tem uma era ou período associada.
-
/ – separador, conforme configurado nas configurações regionais do Windows
-
- {sRet} é a variável que receberá o resultado da função.
Exemplo
Após a execução da chamada a seguir, a variável sResultado terá o valor “quinta-feira, 28 de maio de 2009”.
Move (sDateFormat(05/28/2009,"dddd, d ’de’ MMMM ’de’ yyyy")) to sResultado
Observações
- Se a data informada for 29/02/2100, a função retorna “”. Este erro foi identificado em testes e aparentemente trata-se de um bug da função do Windows que é responsável por esta conversão.
- E caso seja necessário complementar com alguma informação adicional, temos o espaço para isso no final da documentação.