DateAndTime.TimeValue(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.