Função DateValue

  • Artigo

Retorna uma Variant (Date).

Sintaxe

DateValue(date)

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

Comentários

Se date é uma cadeia de caracteres que inclui apenas números separados por separadores de data válidos, DateValue reconhece 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 extensa 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.

Quando a parte do ano do argumento date é omitida, DateValue usa o ano atual da data do sistema do seu computador.

Quando o argumento date inclui informações de tempo, DateValue não o retorna. No entanto, quando date inclui informações de tempo inválido (como "89:98"), ocorre um erro.

Observação

Para date, quando a configuração da propriedade Calendar for Gregoriano, a data fornecida deverá ser gregoriana. Quando o calendário é Islâmico, a data fornecida deve ser Islâmica. Se a data fornecida for Islâmica, o argumento date será uma Cadeia de caracteres que representa uma data de 1/1/100 (2 de agosto de 718 no calendário gregoriano) até 4/3/9666 (31 de dezembro de 9999 no calendário gregoriano).

Exemplo

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

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

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.