sCurrentTimeFormat

A função sCurrentTimeFormat recebe uma string de máscara e retorna a hora corrente formatada de acordo com a máscara.

Tipo de Retorno

String

Pacote

A função sCurrentTimeFormat está definida dentro do pacote FormatDateTime.pkg.

Sintaxe

Move (sCurrentTimeFormat({sMascara})) to {sRet}

Onde:

  • {sMascara} é uma string com a máscara de formatação. Você pode usar os seguintes tokens de máscara:
    • h - horas sem zero à esquerda nas horas com um único dígito, utilizando o formato de 12 horas;
    • hh - horas com zero à esquerda nas horas com um único dígito, utilizando o formato de 12 horas;
    • H - horas sem zero à esquerda nas horas com um único dígito, utilizando o formato de 24 horas;
    • HH - horas com zero à esquerda nas horas com um único dígito, utilizando o formato de 24 horas;
    • m - minutos sem zero à esquerda nos minutos com um único dígito;
    • mm - minutos com zero à esquerda nos minutos com um único dígito;
    • s - segundos sem zero à esquerda nos segundos com um único dígito;
    • ss - segundos com zero à esquerda nos segundos com um único dígito;
    • t - um caractere representando o ante meridiem (a.m.) ou post meridiem (p.m.);
    • tt - múltiplos caracteres representando o ante meridiem (a.m.) ou post meridiem (p.m.).
  • {sRet} é a variável que receberá o resultado da função.

Exemplo

Abaixo exemplo da chamada da função, onde sResultado receberá a hora atual como ’14:08:04’:

Move (sCurrentTimeFormat("HH:mm:ss")) to sResultado

Observações

  • Os caracteres que representam o a.m. e p.m., são obtidos a partir das configurações regionais do Windows.

sCurrentTimeFormatsCurrentTimeFormat

Tópicos relacionados