Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

ElapTime

ElapTime( cHoraInicial, cHoraFinal ) --> cRet

Calcula intervalo textual entre dois horários.

ElapTimeAdvPL
01 · VISÃO GERAL

Visão geral

ElapTime recebe textos de oito bytes em hh:mm:ss e devolve texto no mesmo formato. Comprimento diferente pode gerar erro fatal. Quando o início é maior que o fim, a ficha descreve acréscimo de 24 horas; isso não identifica datas nem resolve múltiplos dias. O exemplo comunitário usa Sleep e Time, enquanto a adaptação usa horários fixos, sem espera ou leitura do relógio. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

ElapTime( cHoraInicial, cHoraFinal ) --> cRet

Parâmetros

cHoraInicial
CaractereObrigatório

Horário inicial hh:mm:ss.

cHoraFinal
CaractereObrigatório

Horário final hh:mm:ss.

Retorno

Intervalo textual hh:mm:ss.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed360()
    // Dois horarios fixos validos.
    ConOut(ElapTime("10:00:00", "10:01:30"))
Return Nil
Resultado esperado

Resultado esperado: 00:01:30. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Validar formato e não usar relógio de parede como medidor monotônico.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. ElapTime. TDN. Consulta em 2026-10-26.
  2. EURAI. ADVPL/Funcoes/Hora/ELAPTIME.PRW. universo_do_desenvolvedor_site, commit a5c83e9490302bdb4a0fc5a9d92c2d569a60773c. Exemplo analisado. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha