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

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

Páginas filhas