Devolve uma Variante (Data) que contém a hora de uma hora, minuto ou segundo específicos.
Sintaxe
TimeSerial ( hora, minuto, segundo )
Aviso Certifique-se de que os argumentos estão no intervalo de valores correto. Um argumento inválido pode resultar num resultado incorreto.
A sintaxe da função TimeSerial tem estes argumentos:
Argumento |
Descrição |
hora |
Obrigatório. Variante (Número Inteiro). Número entre 0 (0:00) e 23 (23:00), inclusive ou um expressão numérica. |
minuto |
Obrigatório. Variante (Número Inteiro). Qualquer expressão numérica. |
segundo |
Obrigatório. Variante (Número Inteiro). Qualquer expressão numérica. |
Observações
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 para horas e 0-59 para minutos e segundos. No entanto, também pode especificar horas relativas para cada argumento utilizando qualquer expressão numérica que represente algum número de horas, minutos ou segundos antes ou depois de uma determinada hora. O exemplo seguinte utiliza expressões em vez de números de tempo absolutos. A função TimeSerial devolve uma hora de 15 minutos antes (-15) seis horas antes do meio-dia (12 - 6) ou 5:45:00
TimeSerial(12 - 6, -15, 0)
Quando um argumento excede o intervalo normal desse argumento, incrementa para a unidade maior seguinte, conforme adequado. Por exemplo, se especificar 75 minutos, este é avaliado como uma hora e 15 minutos. Se um único argumento 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 caia fora do intervalo aceitável de datas, ocorre um erro.
Exemplo de consulta
Expressão |
Resultados |
SELECT TimeSerial(18,12;10) AS NewTime FROM ProductSales GROUP BY TimeSerial(18,12;10); |
Devolve o "Tempo" composto por hora, minuto e segundo especificados nos argumentos da função e é apresentado na coluna NewTime. Resultado: "18:12:10". |
Exemplo de VBA
Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.
Este exemplo utiliza a função TimeSerial para devolver uma hora para a hora, minuto e segundo especificados.
Dim MyTime
MyTime = TimeSerial(16, 35, 17) ' MyTime contains serial representation of 4:35:17 PM.