Retorna uma Variante (Data) que contém a hora.
Sintaxe
TimeValue(time)
O argumento de temponecessário é normalmente uma expressão de cadeia de caracteres que representa um horário de 0:00:00 (12:00:00 A.M.) a 23:59:59 (11:59:59 P.M.), inclusive. No entanto, tempo também pode ser qualquer expressão que represente um tempo nesse intervalo. Se a hora contiver Nulo, Nulo será retornado.
Comentários
Você pode inserir horas válidas usando um relógio de 12 ou 24 horas. Por exemplo, "2:24PM" e "14:24" ambos são argumentos de hora válidos.
Se o argumento da hora contiver informações de data, o TimeValue não as retornará. No entanto, se a hora incluir informações de data inválidas, ocorrerá um erro.
Exemplos de consulta
| Expressão. | Resultados |
|---|---|
| SELECT TimeValue([DateTime]) AS Expr1 FROM ProductSales; | Retorna os valores de hora do campo "DateTime" sem as informações de data e exibe na coluna Expr1. |
| SELECT TimeValue([DateTime]) AS JustTime FROM ProductSales; | Retorna os valores de hora do campo "DateTime" sem as informações de data e exibe na coluna JustTime. |
Exemplo de VBA
Observação
Os 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 TimeValue para converter uma cadeia de caracteres em uma hora. Você também pode usar literais de data para atribuir diretamente uma hora a uma variável Variant ou Date , por exemplo, MyTime = #4:35:17 PM#.
Dim MyTime
MyTime = TimeValue("4:35:17 PM") ' Return a time.