Função DateValue

Retorna uma Variant (Data).

Sintaxe

DateValue ( data )

A data necessáriaargumento normalmente é uma expressão de cadeia de caracteres que representa uma data de 1º de janeiro de 100 a 31 de dezembro de 9999. No entanto, a data também pode ser qualquer expressão que possa representar uma data, uma hora ou uma data e uma hora, nesse intervalo.

Comentários

Se date for uma cadeia de caracteres que inclui apenas números separados por separadores de data válidos, DateValue reconhecerá o pedido para mês, dia e ano de acordo com o formato De Data Curta especificado para seu sistema. DateValue também reconhece datas nãombíguas que contêm nomes de mês, em formato longo ou abreviado. 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 anual da data for omitida, DateValue usará o ano atual da data do sistema do computador.

Se o argumento date incluir informações de hora, DateValue não as retornará. No entanto, se a data incluir informações de hora inválidas (como "89:98"), ocorrerá um erro.

Observação: For date, if the Calendar property setting is Gregorian, the supplied date must be Gregorian. Se o calendário for Hijri, a data fornecida deverá ser Hijri. Se a data fornecida for Hijri, a data do argumento será uma String que representa uma data de 1/1/100 (2 de agosto de 718 gregoriano) a 3/4/9666 (31 de dezembro de 9999).

Exemplos de consulta

Expressão

Resultados

SELECT DateValue([DateTime]) AS Expr1 FROM ProductSales;

Retorna os valores de data do campo "DateTime" no formato De data curta sem as informações de hora.

SELECT DateValue([DateTime]) AS NewDate, Count(ProductSales.DateTime) AS CountOfDateTime FROM ProductSales GROUP BY DateValue([DateTime]);

Retorna os valores de data do campo "DateTime" no formato De data curta sem as informações de hora.

Exemplo do VBA

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Desenvolvedor na listada ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.

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

Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.

Consulte Também

Escolher a função de data certa

Precisa de mais ajuda?

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider