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