Devolve uma Variante (Data) que contém a hora.
Sintaxe
ValorDoTempo(tempo)
Normalmente, o argumento de temponecessário é uma expressão de cadeia que representa uma hora de 0:00:00 até 23:59:59, inclusive. No entanto, a hora também pode ser qualquer expressão que represente uma hora nesse intervalo. Se a hora contiver Nulo, Nulo é devolvido.
Observações
Pode introduzir horas válidas utilizando um relógio de 12 horas ou de 24 horas. Por exemplo, "2:24PM" e "14:24" são ambos argumentos de hora válidos.
Se o argumento de hora contiver informações de data, o ValorDoTempo não as devolve. No entanto, se a hora incluir informações de data inválidas, ocorre um erro.
Exemplos de consulta
| Expressão | Resultados |
|---|---|
| SELECT TimeValue([DateTime]) AS Expr1 FROM ProductSales; | Devolve os valores de hora do campo "DataHora" sem informação de data e é apresentado na coluna Expr1. |
| SELECT TimeValue([DateTime]) AS JustTime FROM ProductSales; | Devolve os valores de hora do campo "DataHora" sem as informações de data e é apresentado na coluna JustTime. |
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 TimeValue para converter uma cadeia de caracteres em uma hora. Também pode utilizar literais de data para atribuir diretamente uma hora a uma variável Variant ou Data , por exemplo, OMeuTempo = #4:35:17 PM#.
Dim MyTime
MyTime = TimeValue("4:35:17 PM") ' Return a time.