DateAndTime.DateValue(String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve um Date valor contendo a informação de data representada por uma cadeia, com a informação da hora definida para a 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
Required. expressão de corda representando um valor de data/hora das 00:00:00 de 1 de janeiro do ano 1 até às 23:59:59 de 31 de dezembro de 9999.
Devoluções
Um Date valor contendo a informação da data representada por uma cadeia, com a informação da hora definida para a 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 numa data. Também pode usar datas literais 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")
Observações
Se StringDate incluir apenas números de 1 a 12 separados por datas válidas, DateValue reconhece a ordem do mês, dia e ano de acordo com o formato de Data Curta especificado para o seu sistema.
DateValue usa a definição atual do calendário da CurrentCulture propriedade da CultureInfo classe no System.Globalization namespace. Os valores predefinidos de CurrentCulture são determinados pelas definições Painel de Controlo. Pode sobrescrever o formato Short Date definindo a ShortDatePattern propriedade da DateTimeFormatInfo classe no System.Globalization namespace.
DateValue reconhece os nomes dos meses em forma longa, abreviada e numérica. 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 usa o ano atual da data do sistema do teu computador.
Se o StringDate argumento incluir informação temporal, DateValue não a inclui no valor devolvido. No entanto, se StringDate incluir informação de tempo inválida, como "89:98", ocorre um InvalidCastException erro.