Função DateValue

Observação: Desejamos fornecer o conteúdo da Ajuda mais recente no seu idioma da forma mais rápida possível. Esta página foi traduzida de forma automatizada e pode conter imprecisões ou erros gramaticais. Nosso objetivo é que este conteúdo seja útil para você. As informações foram úteis? Dê sua opinião no final desta página. Aqui está o artigo em inglês para facilitar a referência.

Retorna uma variante (Data).

Sintaxe

DateValue ( Data )

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

Comentários

Se a Data for uma cadeia de caracteres que inclua apenas números separados por válido separadores de data, DateValue reconhecerá a ordem de dia, mês 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 contêm nomes de mês, na forma longa ou abreviada. 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 dez de 1991.

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

Se o argumento de Data inclui informações de tempo, DateValue não retorná-lo. No entanto, se Data inclui informações de tempo inválido (como "89: 98"), ocorrerá um erro.

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

Exemplo

Observação: Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa 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 uma data diretamente a uma variável Variant ou Data , por exemplo, MyDate = # #2/12/69.

Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.
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.

×