Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 2 Atual »

Função: ElapTime

Retorna uma string, com o número de segundos decorridos entre dois horários (hora inicial e final) diferentes, no formato hh:mm:ss.

ElapTime ( < cHoraInicial>, < cHoraFinal> ) --> cRet

 

NomeTipoDescriçãoObrigatórioReferência
cHoraInicialCaracterIndica a hora inicial no formato hh:mm:ssX 
cHoraFinalCaracterIndica a hora final no formato hh:mm:ssX 

 

cRet
    (caracter)
  • Retorna a diferença do tempo no formato hh:mm:ss.
  • O parâmetros e 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 caracter 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 calculos 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 ) 
// Exemplo 1
ElapTime( "12:00:00", "13:15:15" ) // Resultado: "01:15:15"

//Exemplo 2
cHoraInicio := TIME() // Armazena hora de inicio do processamento.. .
cElapsed := ElapTime( cHoraInicio, TIME() ) // Calcula a diferença de tempo

// 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.
Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10

 

  • Sem rótulos