Retorna a hora do sistema operacional. Essa função é utilizada para apresentar ou imprimir a hora do sistema operacional em um relatório ou tela.

Sintaxe

Time()

Retorno

Nome

Tipo

Descrição

cTime

caractere

Retorna a hora do sistema operacional como string na forma hh:mm:ss.

Observações

  • hh é a hora (no formato de 24 horas), mm são os minutos e ss os segundos. Horas, minutos e segundos são separadas por dois pontos (:).
  • Time está relacionada a função Seconds, que retorna a quantidade de segundos decorridos desde a meia-noite.
  • A função Seconds geralmente é utilizada no lugar da Time para cálculos de tempo.

Exemplos

Exemplo 1
user function secs1()
  conout( Time() )    // Resultado: "10:37:17"
return
Exemplo 2
user function secs2()
  //Este exemplo apresenta a função TIME() utilizada em conjunto com SubStr
  //para extrair a hora, os minutos e os segundos
  
  cTime := Time() // Resultado: 10:37:17
  cHour := SubStr( cTime, 1, 2 ) // Resultado: 10
  cMin  := SubStr( cTime, 4, 2 ) // Resultado: 37
  cSecs := SubStr( cTime, 7, 2 ) // Resultado: 17
return

Abrangência

Advanced Protheus 6.09, Advanced Protheus 7.10, Microsiga Protheus 8.11, Protheus 10, TOTVS Application Server 10, ByYou Application Server

Veja também

 

  • Sem rótulos