Mostrar tudo

Ocultar tudo

Devolve uma Variante (Data) que contém a hora.

Sintaxe

ValorHora(hora)

O argumento (argumento: valor que fornece informações a uma acção, evento, método, propriedade, função ou procedimento.) hora obrigatório é normalmente uma expressão de cadeia (expressão de cadeia: expressão que equivale a uma sequência de caracteres contíguos. Os elementos da expressão podem ser: funções que devolvem uma cadeia ou uma Variante de cadeia (VarType 8); uma cadeia literal, uma constante, uma variável ou Variante.) que representa uma hora entre as 0:00:00 (12:00:00) e as 23:59:59 (23:59:59) inclusive. No entanto, a hora também pode ser qualquer expressão (expressão: qualquer combinação de funções, constantes, operadores lógicos ou matemáticos e nomes de campos, controlos e propriedades que resulta num único valor. As expressões podem efectuar cálculos, manipular caracteres ou testar dados.) que represente uma hora nesse intervalo. Se a hora contiver Nulo (Null: valor que pode introduzir num campo ou utilizar em expressões ou consultas para indicar dados em falta ou desconhecidos. No Visual Basic, a palavra-chave Null indica um valor nulo (Null). Alguns campos, tais como campos de chave primária, não podem conter um valor Null.), é devolvido um valor Nulo.

Observações

Pode introduzir horas válidas utilizando um relógio de 12 ou de 24 horas. Por exemplo, "2:24PM" e "14:24" são argumentos de hora válidos.

Se o argumento hora contiver informações da data, a função ValorHora não as devolve. No entanto, se o argumento hora incluir informações de data inválidas, ocorre um erro.

Exemplo

 Nota   Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de procura.

Este exemplo utiliza a função ValorHora para converter uma cadeia numa hora. Também pode utilizar datas literais para atribuir directamente uma hora a uma Variante ou variável de Data como, por exemplo, MinhaHora = #16:35:17#.

Dim MinhaHora
MinhaHora = ValorHora("4:35:17 PM")    ' Devolver uma hora.