DateAndTime.DateValue(String) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

DateAndTime.vb

Retorna um valor Date que contém as informações de data representadas por uma cadeia de caracteres, com as informações de hora definidas para meia-noite (00:00:00).

public:
 static DateTime DateValue(System::String ^ StringDate);

public static DateTime DateValue (string StringDate);

static member DateValue : string -> DateTime

Public Function DateValue (StringDate As String) As DateTime

Parâmetros

StringDate

String

Obrigatórios. 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

DateTime

Um valor Date que contém as informações de data representadas por uma cadeia de caracteres, com as informações de hora definidas como meia-noite (00:00:00).

Exceções

InvalidCastException

StringDate inclui informações de hora inválidas.

Exemplos

Este exemplo usa a DateValue função para converter uma cadeia de caracteres em uma data. Você também pode usar literais de data para atribuir diretamente uma data a uma Object variável ou Date , por exemplo, oldDate = #2/12/69#.

Dim oldDate As Date
oldDate = DateValue("February 12, 1969")

Comentários

Se StringDate incluir apenas números de 1 a 12 separados por separadores de data válidos, DateValue reconhecerá a ordem de mês, dia e ano de acordo com o formato de Data Abreviada especificado para seu sistema. DateValue usa a configuração de calendário atual da CurrentCulture propriedade da CultureInfo classe no System.Globalization namespace . Os valores padrão CurrentCulture são determinados por Painel de Controle configurações. Você pode substituir o formato de Data Abreviada definindo a ShortDatePattern propriedade da DateTimeFormatInfo classe no System.Globalization namespace .

DateValue reconhece nomes de meses em formato longo, abreviado e numérico. Por exemplo, além de reconhecer 30/12/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 omitida, DateValue o usará o ano atual da data do sistema do computador.

Se o StringDate argumento incluir informações de tempo, DateValue não o incluirá no valor retornado. No entanto, se StringDate incluir informações de tempo inválidas, como "89:98", ocorrerá um InvalidCastException erro.

Confira também

• DateSerial(Int32, Int32, Int32)
• Day(DateTime)
• Month(DateTime)
• Now
• TimeSerial(Int32, Int32, Int32)
• TimeValue(String)
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• DateTime
• Resumo do tipo de dados (Visual Basic)