Compartilhar via

Função DateValue

  • Artigo

Retorna uma Variant (Date).

Sintaxe

DateValue(date)

O argumentode data necessário é normalmente uma expressão de cadeia que representa uma data de 1 de janeiro de 100 a 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.