Compartilhar via


Função TimeSerial

Retorna uma Variant (Data) que contém a hora de uma hora, minuto e segundo específicos.

Sintaxe

TimeSerial(hora, minuto, segundo)

A sintaxe da função TimeSerial tem esses argumentos nomeados:

Sair Descrição
Hora Necessário; Variant (Inteiro). Número entre 0 (12:00) e 23 (21:00), inclusive ou uma expressão numérica.
Minuto Necessário; Variant (Inteiro). Qualquer expressão numérica.
Segundo Necessário; Variant (Inteiro). Qualquer expressão numérica.

Comentários

Para especificar uma hora, como 11:59:59, o intervalo de números para cada argumento TimeSerial deve estar no intervalo normal da unidade; ou seja, 0 a 23 por horas e 0 a 59 por minutos e segundos. No entanto, você também pode especificar tempos relativos para cada argumento usando qualquer expressão numérica que represente algum número de horas, minutos ou segundos antes ou depois de um determinado tempo.

O exemplo a seguir usa expressões em vez de números de tempo absolutos. A função TimeSerial retorna um tempo de 15 minutos antes (-15) seis horas antes do meio-dia (12 - 6) ou 5:45:00 da manhã.

TimeSerial(12 - 6, -15, 0)

Quando qualquer argumento excede o intervalo normal para esse argumento, ele incrementa para a próxima unidade maior, conforme apropriado. Por exemplo, se você especificar 75 minutos, ele será avaliado como uma hora e 15 minutos. Um erro ocorrerá se um único argumento estiver fora do intervalo de -32.768 a 32.767. Se a hora especificada pelos três argumentos fizer com que a data fique fora do intervalo aceitável de datas, ocorrerá um erro.

Exemplo

Este exemplo usa a função TimeSerial para retornar um tempo para a hora, o minuto e o segundo especificados.

Dim MyTime
MyTime = TimeSerial(16, 35, 17)    ' MyTime contains serial 
    ' representation of 4:35:17 PM.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.