Mostrar tudo

Ocultar tudo

Devolve uma Variante (Data).

Sintaxe

ValorData(data)

Normalmente, o argumento (argumento: valor que fornece informações a uma acção, evento, método, propriedade, função ou procedimento.) data obrigatório é uma expressão de cadeia (expressão de cadeia: expressão que equivale a uma sequência de caracteres contíguos. Os elementos da expressão podem ser: funções que devolvem uma cadeia ou uma Variante de cadeia (VarType 8); uma cadeia literal, uma constante, uma variável ou Variante.)que representa uma data de 1 de Janeiro de 100 a 31 de Dezembro de 9999. No entanto, a data também pode ser qualquer expressão (expressão: qualquer combinação de funções, constantes, operadores lógicos ou matemáticos e nomes de campos, controlos e propriedades que resulta num único valor. As expressões podem efectuar cálculos, manipular caracteres ou testar dados.)que represente uma data, uma hora ou ambos nesse intervalo.

Observações

Se a data for uma cadeia que inclui apenas números separados por separadores de data (separadores de data: caracteres utilizados para separar o dia, o mês e o ano quando os valores de data são formatados. Os caracteres são determinados pelas definições do sistema ou pela função de formatação.) válidos, a função ValorData reconhece a ordem de mês, dia e ano, de acordo com o formato de Data Abreviada que especificou para o sistema. A função ValorData também reconhece datas não ambíguas que contêm nomes de meses, em formato longo ou abreviado. Por exemplo, além de reconhecer 30/12/1991 e 30/12/91, a função ValorData reconhece também 30 de Dezembro de 1991 e 30 Dez, 1991.

Se a parte do ano da data for omitida, a função ValorData utiliza o ano actual da data do sistema do computador.

Se o argumento data incluir informações da hora, a função ValorData não o devolve. No entanto, se a data incluir informações de hora inválidas (como "89:98"), ocorre um erro.

 Nota   Em data, se a definição da propriedade do Calendário for Gregoriano, a data fornecida tem de ser Gregoriana. Se o calendário for Hijri, a data fornecida tem de ser Hijri. Se a data fornecida for Hijri, o argumento data é uma Cadeia que representa uma data de 1/1/100 (2 Ago de 718, Gregoriano) a 3/4/9666 (31 Dez de 9999, Gregoriano).

Exemplo

 Nota   Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de procura.

Este exemplo utiliza a função ValorData para converter uma cadeia numa data. Também pode utilizar literais de data para atribuir directamente uma data a uma variável de Variante ou de Data, por exemplo, MinhaData = #12/2/69#.

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