Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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)