Função DateValueDateValue function

Retorna uma Variant (Date).Returns a Variant (Date).

SintaxeSyntax

DateValue(date)DateValue(date)

O argumento date necessário é normalmente uma expressão de cadeia de caracteres que representa uma data de 1 de janeiro de 100 até 31 de dezembro de 9999.The required date argument is normally a string expression representing a date from January 1, 100, through December 31, 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.However, date can also be any expression that can represent a date, a time, or both a date and time, in that range.

ComentáriosRemarks

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.If date is a string that includes only numbers separated by valid date separators, DateValue recognizes the order for month, day, and year according to the Short Date format that you specified for your system. DateValue também reconhece datas não ambíguas que contêm nomes de mês, na forma extensa ou abreviada.DateValue also recognizes unambiguous dates that contain month names, either in long or abbreviated form. 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.For example, in addition to recognizing 12/30/1991 and 12/30/91, DateValue also recognizes December 30, 1991 and Dec 30, 1991.

Quando a parte do ano do argumento date é omitida, DateValue usa o ano atual da data do sistema do seu computador.If the year part of date is omitted, DateValue uses the current year from your computer's system date.

Quando o argumento date inclui informações de tempo, DateValue não o retorna.If the date argument includes time information, DateValue doesn't return it. No entanto, quando date inclui informações de tempo inválido (como "89:98"), ocorre um erro.However, if date includes invalid time information (such as "89:98"), an error occurs.

Observação

Para date, quando a configuração da propriedade Calendar for Gregoriano, a data fornecida deverá ser gregoriana.For date, if the Calendar property setting is Gregorian, the supplied date must be Gregorian. Quando o calendário é Islâmico, a data fornecida deve ser Islâmica.If the calendar is Hijri, the supplied date must be Hijri. 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).If the supplied date is Hijri, the argument date is a String representing a date from 1/1/100 (Gregorian Aug 2, 718) through 4/3/9666 (Gregorian Dec 31, 9999).

ExemploExample

Este exemplo usa a função DateValue para converter uma cadeia de caracteres em uma data.This example uses the DateValue function to convert a string to a date. 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#.You can also use date literals to directly assign a date to a Variant or Date variable, for example, MyDate = #2/12/69#.

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


Confira tambémSee also

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.