Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Composition Setup
import.css=/download/attachments/3279126062824/newLayouttecnologia.css
Portuguese

Pagetitle
ElapTime

...

...

...

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

Bloco de código
collapsefalse
ElapTime ( < cHoraInicial>, < cHoraFinal> )
--> cRet

Parâmetros

...

NomeTipoDescriçãoObrigatórioReferência
cHoraInicial

...

caractereIndica a hora inicial no formato hh:mm:ssX 
cHoraFinal

...

caractereIndica 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

Bloco de código
themeEclipse
languagecpp
titleExemplo 1
linenumberstrue
collapsetrue
User Function exemplo1()
	ElapTime
// Exemplo 1ElapTime
( "12:00:00", "13:15:15" ) // Resultado: "01:15:15"
Return
Bloco de código
themeEclipse
languagecpp
titleExemplo 2
linenumberstrue
collapsetrue
User Function exemplo2()
	cHoraInicio
//Exemplo 2cHoraInicio
 := TIME() // Armazena hora de inicio do processamento.. .
	cElapsed := 
ELAPTIME
ElapTime( cHoraInicio, TIME()
,cHoraInicio
 )  // 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