Função TimeValue (Visual Basic)
Retorna um Date valor que contém as informações de time representadas por uma seqüência de caracteres, com as informações de data definidas para 1 º de janeiro do ano 1.
Public Function TimeValue(ByVal StringTime As String) As DateTime
Parâmetros
- StringTime
Obrigatório.String expressão representando um valor de data/time de 00: 00: 00 em 1 de janeiro do ano 1 por meio de 23: 59: 59 em 31 de dezembro de 9999.
Exceções
Tipo de exceção |
Número de erro |
Condição |
|---|---|---|
StringTime inclui informações de data inválido. |
Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.
Comentários
Você pode inserir horas válidas usando um relógio de 12 horas ou 24 horas.Por exemplo, "2:24 P.M." e "14:24" ambos são válido StringTime argumentos.
Se o StringTime argumento inclui informações de data TimeValue não o inclui no valor retornado. No entanto, se StringTimeinclui informações de data inválido, por exemplo "janeiro de 32", um InvalidCastException erro ocorre.
Exemplo
O exemplo a seguir utiliza o TimeValue função para converter uma seqüência de caracteres em uma time. Você também pode usar literais de data para atribuir um time diretamente a um Date variável.
Dim thisTime As Date
thisTime = TimeValue("4:35:17 PM")
Requisitos
Namespace: Microsoft.VisualBasic
**Módulo:**DateAndTime
Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)
Consulte também
Referência
Função DateSerial (Visual Basic)
Função DateValue (Visual Basic)
Função DateSerial (Visual Basic)