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.

Tópicos relacionados