Função TimeValue

Retorna uma Variant (Data) que contém a hora.

Sintaxe

TimeValue(time)

O argumento de tempo necessário normalmente é uma expressão de cadeia de caracteres que representa uma hora das 0:00:00 (12:00:00) às 23:59:59 (23:59:59), inclusive. No entanto, o tempo também pode ser qualquer expressão que represente um tempo nesse intervalo. Se o tempocontiver 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 de hora contiver informações de data, TimeValue não o retornará. No entanto, se a hora incluir informações de data inválidas, ocorrerá um erro.

Exemplo

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.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.