sCurrentTimeFormat
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.
