Histórico da Página

import.css=/download/attachments/3279126062824/newLayouttecnologia.css

...

...

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

...

...

...

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

User Function exemplo1()
	

ElapTime( "12:00:00", "13:15:15" ) // Resultado: "01:15:15"
Return

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