sTimeFormat

A função sTimeFormat recebe uma varíavel do tipo Time e uma string de máscara e retorna a hora formatada.

Tipo de Retorno

String

Pacote

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

Sintaxe

Move (sTimeFormat({tmHora},{sMascara})) to {sRet}

Onde:

  • {tmHora} é a hora que será formatada, e se for passada uma hora nula utilizará a hora corrente;
  • {sMascara} é uma string com a máscara de formatação, sendo que é possível 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

Após a execução do código que segue, a variável sResultado terá o valor "15:20:35", supondo que o conteúdo dos campos iHrEntrada, iMnEntrada e iSgEntrada seja 15, 20 e 35, respectivamente.

Time tmHora
Move (DateSetHour  (tmHora,Ponto.iHrEntrada)) to tmHora
Move (DateSetMinute(tmHora,Ponto.iMnEntrada)) to tmHora
Move (DateSetSecond(tmHora,Ponto.iSgEntrada)) to tmHora
Move (sTimeFormat(tmHora,"HH:mm:ss")) to sResultado

Observações

  • Para obter diretamente a hora atual formatada você também pode usar a função sCurrentTimeFormat;
  • Os caracteres que representam o a.m. e p.m., são obtidos a partir das configurações regionais do Windows:

sTimeFormat

Tópicos relacionados