sTimeFormat

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.

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:

Tópicos relacionados

• AplicaMascara
• ColocaZerosEsquerda
• HoraMinutoSegundoToString
• sDateFormat
• sCurrentTimeFormat