Partilhar via


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

InvalidCastException

13

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

DateTime

Função DateSerial (Visual Basic)

Função DateValue (Visual Basic)

Função Hour (Visual Basic) 

Função Minute

Propriedade agora

Segunda função (Visual Basic)

Função DateSerial (Visual Basic)

Tipo de dados Data (Visual Basic)

TimeSpan