Devolve uma Variante (Data) que contém a hora de uma hora, minuto ou segundo específicos.
Sintaxe
TimeSerial(hora; minuto; segundo)
Advertência Certifique-se de que os argumentos estão no intervalo de valores correto. Um argumento inválido pode originar um resultado incorreto.
A sintaxe da função SerieHora tem estes argumentos:
| Argumento | Descrição |
|---|---|
| hora | Obrigatório. Variant (Inteiro). Número entre 0 (00:00) e 23 (23:00), inclusive, ou uma expressão numérica. |
| minuto | Obrigatório. Variant (Inteiro). Qualquer expressão numérica. |
| segundo | Obrigatório. Variant (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 para a unidade; ou seja, 0–23 para horas e 0–59 para minutos e segundos. No entanto, também pode especificar horas relativas para cada argumento através de qualquer expressão numérica que represente um determinado número de horas, minutos ou segundos antes ou depois de um determinado tempo. O exemplo seguinte utiliza expressões em vez de números de tempo absolutos. A função SerieHora devolve um tempo para 15 minutos antes de (-15) seis horas antes do meio-dia (12 - 6) ou 5:45:00 A.M.
TimeSerial(12 - 6, -15, 0)
Quando um argumento excede o intervalo normal desse argumento, ele incrementa até a unidade maior seguinte, conforme apropriado. Por exemplo, se especificar 75 minutos, será avaliado como uma hora e 15 minutos. Se um único argumento estiver fora do intervalo -32.768 a 32.767, ocorre um erro. Se a hora especificada pelos três argumentos fizer com que a data fique fora do intervalo de datas aceitável, 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 a "Hora" composta por hora, minuto e segundo especificados introduzidos nos argumentos da função e apresentados na coluna HoraNova. Resultado: "18:12:10". |
Exemplo do 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 usa a função TimeSerial para retornar um tempo para a hora, minuto e segundo especificados.
Dim MyTime
MyTime = TimeSerial(16, 35, 17)
' MyTime contains serial representation of 4:35:17 PM.