Função TimeSerial

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Retorna uma Variante (Data) que contém o horário de uma determinada hora, minuto e segundo.

Sintaxe

TimeSerial ( hora, minuto, segundo )

A sintaxe da função TimeSerial possui os seguintes argumentos:

Argumento

Descrição

hora

Necessário. Variant (Inteiro). Número entre 0 (12:00 A.M.) e 23 (11:00 P.M.), 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; Isto é, 0 – 23 para horas e 0 – 59 para minutos e segundos. No entanto, você também pode especificar horas relativas para cada argumento usando qualquer expressão numérica que representa um número de horas, minutos ou segundos antes ou depois de um certo tempo. O exemplo a seguir usa expressões em vez de números absolutos. A função TimeSerial retorna uma hora para 15 minutos antes (-15) seis horas antes de meio-dia (12 - 6) ou 5:45:00 A.M.

TimeSerial(12 - 6, -15, 0)

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

Exemplo

Observação : Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa e insira um ou mais termos na caixa de pesquisa.

Este exemplo usa a função TimeSerial para retornar um horário para a hora especificada, minuto e segundo.

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

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×