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.
Tópicos relacionados