Retorna uma Variante (Data) que contém a hora.
Sintaxe
TimeValue ( time )
O tempo necessárioargumento normalmente é um expressão de cadeia de caracteres representando um horário das 00:00:00 (12:00:00) às 23:59:59 (21:59:59), inclusive. No entanto, o tempo também pode ser qualquer expressão que represente um tempo nesse intervalo. Se o tempo contiver Null, Null será retornado.
Comentários
Você pode inserir horários válidos usando um relógio de 12 horas ou 24 horas. Por exemplo, "2:24PM" e "14:24" são argumentos de tempo válidos.
Se o argumento time contiver informações de data, TimeValue não 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 tempo do campo "DateTime" sem as informações de data e são exibidos na coluna Expr1. |
SELECT TimeValue([DateTime]) COMO JustTime FROM ProductSales; |
Retorna os valores de tempo do campo "DateTime" sem as informações de data e são exibidos na coluna JustTime. |
Exemplo de VBA
Observação: Exemplos a seguir demonstram o uso dessa função em um módulo VBA (Visual Basic for Applications). 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 um tempo. 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.