TimeValue

Devolve um objeto Variant do subtipo Date que contém a hora.

Estrutura

TimeValue(hora)

Parâmetros

O argumento de hora é normalmente uma expressão de cadeia de caracteres que representa uma hora a partir das 0:00:00 (00:00:00) até às 23:59:59 (23h59:59), inclusive. No entanto, o tempo também pode ser qualquer expressão que represente um momento dentro desse intervalo. Se time contiver Null, é devolvido Null.

Descrição

Pode introduzir horários válidos utilizando o formato de 12 ou 24 horas. Por exemplo, «14h24» e «2:24PM» são ambas formas válidas de indicar a hora. Se o argumento de hora contiver informações de data, a função TimeValue não devolve essas informações. No entanto, se a hora incluir informações de data inválidas, ocorre um erro.

Exemplo

O exemplo seguinte utiliza a função TimeValue para converter uma cadeia de caracteres numa hora. Também pode utilizar literais de data para atribuir diretamente uma hora a uma variável (por exemplo, MyTime = #4:35:17 PM#).

Dim MyTime

MyTime = TimeValue("4:35:17 PM") ' MyTime contém 4:35:17 PM. |