Função DateValue

Retorna uma variante (Data).

Sintaxe

DateValue ( Data )

A Data necessáriaargumento normalmente é uma expressão de cadeia de caracteres que representa a 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 hora, nesse intervalo.

Comentários

Se Data for uma cadeia de caracteres que inclua apenas números separados por separadores de data válidas, Date reconhecerá a ordem de mês, dia e ano de acordo com o formato de data abreviada especificado para o seu sistema. DateValue também reconhece datas não ambíguas que contenham nomes de mês, seja em formato longo ou abreviado. Por exemplo, além de reconhecer o 12/30/1991 e o 12/30/91, DateValue também reconhece 30 de dezembro de 1991 e 30 de dezembro de 1991.

Se a parte do ano for omitida, datefile usará o ano atual da data do sistema do computador.

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

Observação: Para Data, se a configuração da propriedade calendário for Gregoriano, a data fornecida deverá ser Gregoriana. Se o calendário for islâmico, a data fornecida deverá ser islâmica. Se a data fornecida for Hijri, a Data do argumento será uma cadeia de caracteres que representa uma data de 1/1/100 (2 de agosto de 718) a 4/3/9666 (calendário gregoriano de 31, 9999).

Exemplos de consulta

Expressão

Resultados

SELECIONAR DateValue ([DateTime]) como expr1 FROM ProductSales;

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

SELECIONAR DateValue ([DateTime]) AS NewDate, Count (ProductSales. DateTime) AS CountOfDateTime de ProductSales GROUP BY Date ([DateTime]);

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

Exemplo de VBA

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione referência do desenvolvedor na lista suspensa 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.

Observação:  Esta página foi traduzida automaticamente e pode apresentar erros gramaticais ou imprecisões. Nosso objetivo é que este conteúdo seja útil para você. Você pode nos dizer se as informações foram úteis? Use o artigo em inglês como referência.​

Consulte Também

Escolher a função de data certa

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

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×