DateAndTime.TimeValue(String) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

DateAndTime.vb

Retorna um valor Date que contém as informações de hora representadas por uma cadeia de caracteres, com as informações de data definidas como 1 de janeiro do ano 1.

public:
 static DateTime TimeValue(System::String ^ StringTime);

public static DateTime TimeValue (string StringTime);

static member TimeValue : string -> DateTime

Public Function TimeValue (StringTime As String) As DateTime

Parâmetros

StringTime

String

Obrigatórios. Uma expressão de cadeia de caracteres que representa um valor de data/hora entre 00:00:00 de 1º de janeiro do ano 1 e 23:59:59 de 31 de dezembro de 9999.

Retornos

DateTime

Um valor Date que contém as informações de hora representadas por uma cadeia de caracteres, com as informações de data definidas como 1º de janeiro do ano 1.

Exceções

InvalidCastException

O StringTime inclui informações de data inválidas.

Exemplos

O exemplo a seguir usa a TimeValue função para converter uma cadeia de caracteres em uma hora. Você também pode usar literais de data para atribuir diretamente uma hora a uma Date variável.

Dim thisTime As Date
thisTime = TimeValue("4:35:17 PM")

Comentários

Você pode inserir horários válidos usando um relógio de 12 ou 24 horas. Por exemplo, "2:24 P.M." e "14:24" são argumentos válidos StringTime .

Se o StringTime argumento incluir informações de data, TimeValue não o incluirá no valor retornado. No entanto, se StringTime incluir informações de data inválidas, por exemplo , "32 de janeiro", ocorrerá um InvalidCastException erro.

Confira também

• DateTime
• DateSerial(Int32, Int32, Int32)
• DateValue(String)
• Hour(DateTime)
• Minute(DateTime)
• Now
• Second(DateTime)
• TimeSerial(Int32, Int32, Int32)