DateAndTime.TimeValue(String) Método

Definição

Retorna um Date valor que contém as informações de tempo 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

Required. Uma expressão de cadeia de caracteres que representa um valor de data/hora de 00:00:00 em 1º de janeiro do ano 1 até 23:59:59 em 31 de dezembro de 9999.

Retornos

Um Date valor 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

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 um tempo. 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

Pode introduzir horas válidas utilizando um relógio de 12 horas ou 24 horas. Por exemplo, "2:24 P.M." e "14:24" ambos 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