Função DateValue (Visual Basic)
Retorna um Date valor que contém as informações de data representadas por uma seqüência de caracteres, com as informações de time conjunto à meia-noite (00: 00: 00).
Public Function DateValue(ByVal StringDate As String) As DateTime
Parâmetros
- StringDate
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 |
|---|---|---|
StringDate inclui informações de time 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
If StringDate inclui somente números de 1 a 12 separados por separadores de data válida DateValue reconhecerá a ordem de dia, mês e ano de acordo com o formato de data abreviada especificado para o seu sistema. DateValue utiliza a configuração atual de calendário da propriedade CurrentCulture da classe CultureInfo no namespace System.Globalization.Os valores CurrentCulture padrão são determinados por configurações do Painel de Controle.Você pode substituir o formato data abreviada, definindo o ShortDatePattern propriedade das DateTimeFormatInfo classe na System.Globalization espaço para nome.
DateValue reconhece os nomes dos meses no formulário longo, abreviado e numérico. Por exemplo, bem como reconhecer 12/30/1991 e 30/12/91, DateValue também reconhece 30 de dezembro de 1991 e 30 de dezembro de 1991.
Se a parte do ano de StringDate for omitido, DateValue usará o ano corrente de data do sistema do seu computador.
Se o StringDate argumento inclui informações de time DateValue não o inclui no valor retornado. No entanto, se StringDateinclui informações de time inválido, sistema autônomo "89: 98", um InvalidCastException erro ocorre.
Exemplo
Este exemplo usa o DateValue função para converter uma seqüência de caracteres em uma data. Você também pode usar literais de data para atribuir uma data diretamente a um Object ou Date variável, por exemplo, oldDate = #2/12/69#.
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
Requisitos
Namespace: Microsoft.VisualBasic
**Módulo:**DateAndTime
Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)
Consulte também
Referência
Função DateSerial (Visual Basic)
Função DateSerial (Visual Basic)
Função TimeValue (Visual Basic)
Função dia da semana (Visual Basic)