DateAndTime.DateValue(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 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 -> DateTimePublic Function DateValue (StringDate As String) As DateTimeParâ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
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
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.
