Histórico da Página

Sintaxe

ELAPTIME( <hora inicial>, <hora final> )

Propósito

Fornece uma cadeia de caracteres mostrando a diferença, em segundos, entre duas cadeias de caracteres que representam uma hora inicial e uma hora final, no formato “hh:mm:ss” (horas, minutos e segundos), considerando um dia de 24 horas.

Argumentos

< hora inicial >

Define a primeira marcação do tempo, no formato caracter “hh:mm:ss”.

< hora final >

Define a segunda marcação do tempo, no formato caracter “hh:mm:ss”.

Utilização

Essa função é útil para determinar o tempo decorrido entre duas operações efetuadas pela aplicação desenvolvida, ou por dois eventos provocados pelo usuário do sistema.

Se a hora inicial for maior que a hora final, a função assumirá que houve mudança de dia. Portanto, ela calculará a diferença entre o horário inicial do dia anterior e o horário final do outro dia.

As horas válidas são cadeias de oito caracteres que assumem valores entre “00:00:00” e “23:59:59”.

Exemplos

LOCAL cHora := “15:00:00”

MsgAlert( TIME() )          // Resulta “14:00:00”

MsgAlert( ELAPTIME(cHora, TIME()) )

Neste exemplo, o resultado é 3.600 segundos. Portanto, é o número de segundos contidos em uma hora.