Retorna uma string, com o número de segundos decorridos entre dois horários (hora inicial e final) diferentes, no formato hh:mm:ss.
Sintaxe
ElapTime ( < cHoraInicial>, < cHoraFinal> )
Parâmetros
Nome
Tipo
Descrição
Obrigatório
Referência
cHoraInicial
caractere
Indica a hora inicial no formato hh:mm:ss
X
cHoraFinal
caractere
Indica a hora final no formato hh:mm:ss
X
Retorno
Nome
Tipo
Descrição
cRet
caractere
Retorna a diferença do tempo no formato hh:mm:ss.
Observações
O parâmetros devem ser especificados no formato hh:mm:ss, com tamanho de 8 bytes. Caso um dos parâmetros tenha tamanho diferente de 8 bytes, uma ocorrência de erro fatal "Invalid len" será gerada.
Qualquer caractere inválido nas posições referentes à hora (hh), minutos (mm) e segundos (ss), serão ignorados na composição dos números para o cálculo. Caso o horário inicial seja maior que o final, a função retornará a diferença entre os horários acrescidos de 24h
A função aceita fazer cálculos com horas maiores que 24, e minutos e segundos acima de 59. Por exemplo, calcular a diferença de tempo entre 00:00:00 ( meia-noite ) e o horário "00:70:12" ( zero horas, 70 minutos e 12 segundos), retornará a string "01:10:12" ( uma hora, dez minutos e 12 segundos )
Exemplos
Exemplo 1Expandir origem
User Function exemplo1()
ElapTime( "12:00:00", "13:15:15" ) // Resultado: "01:15:15"
Return
Exemplo 2Expandir origem
User Function exemplo2()
cHoraInicio := TIME() // Armazena hora de inicio do processamento.. .
cElapsed := ElapTime( cHoraInicio, TIME() ) // Calcula a diferença de tempo
Return
// Considerando o exemplo acima, caso cHoraInicio seja 23:45:00 , e a hora final
// do processamento seja 00:20:00 , a diferença entre eles , computada na variável cElapsed, será 00:35:00.