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 Date valor 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).
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ório expressão de cadeia de caracteres que representa um valor de data/hora de 00:00:00 em 1º de janeiro do ano 1 até 23:59:59 em 31 de dezembro de 9999.
Retornos
Um Date valor 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 tempo 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 ou Date variável, 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 Curta 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 pelas configurações do Painel de Controle . Você pode substituir o formato Data Curta definindo a ShortDatePattern propriedade da DateTimeFormatInfo classe no System.Globalization namespace.
DateValue reconhece nomes de mês 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 for StringDate omitida, DateValue 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.
