Compartilhar via


DateAndTime.TimeValue(String) Método

Definição

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

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

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.

Aplica-se a

Confira também