Páginas filhas
  • 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.

Sintaxe

ElapTime ( < cHoraInicial>, < cHoraFinal> )

Parâmetros

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

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 1
User Function exemplo1()
	ElapTime( "12:00:00", "13:15:15" ) // Resultado: "01:15:15"
Return
Exemplo 2
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.

Abrangência

Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10

 

  • Sem rótulos