Retorna uma Variante (Data) que contém o horário de uma determinada hora, minuto e segundo.
Sintaxe
TimeSerial ( hora, minuto, segundo )
Aviso Verifique se os argumentos estão no intervalo correto de valores. Um argumento inválido pode resultar em um resultado incorreto.
A sintaxe da função TimeSerial tem esses argumentos:
|
Argumento |
Descrição |
|
hora |
Obrigatório. Variant (Inteiro). Número entre 0 (12:00) e 23 (21:00), inclusivo ou um expressão numérica. |
|
minuto |
Obrigatório. Variant (Inteiro). Qualquer expressão numérica. |
|
segundo |
Obrigató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 de (-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. Se algum argumento único estiver fora do intervalo -32.768 a 32.767, ocorrerá um erro. 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 de consulta
|
Expressão |
Resultados |
|
SELECT TimeSerial(18,12,10) AS NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10); |
Retorna o "Tempo" composto por hora, minuto e segundo especificados nos argumentos da função e exibidos na coluna NewTime. Resultado: "18:12:10". |
Exemplo de VBA
Observação: Exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.
Este exemplo usa a função TimeSerial para retornar um tempo para a hora, o minuto e o segundo especificados.
Dim MyTimeMyTime = TimeSerial(16, 35, 17) ' MyTime contains serial representation of 4:35:17 PM.
