Retorna uma Variante (Data) para um ano, mês e dia especificado.
Sintaxe
DateSerial(ano, mês, dia)
Atenção Verifique se os argumentos estão no intervalo de valores correto. Um argumento inválido pode resultar em um resultado incorreto.
A sintaxe da função DateSerial tem os seguintes argumentos:
| Argumento | Descrição |
|---|---|
| ano | Obrigatório. Inteiro. Número entre 100 e 9999, inclusive, ou uma expressão numérica. |
| mês | Obrigatório. Inteiro. Qualquer expressão numérica. |
| dia | Obrigatório. Inteiro. Qualquer expressão numérica. |
Comentários
Para especificar uma data, como 31 de dezembro de 1991, o intervalo de números para cada argumento DateSerial deve estar no intervalo aceito para a unidade; ou seja, 1–31 para dias e 1–12 para meses. No entanto, você também pode especificar datas relativas para cada argumento usando qualquer expressão numérica que represente um certo número de dias, meses ou anos antes ou depois de uma determinada data.
O exemplo a seguir usa expressões numéricas em vez de números de data absoluta. Aqui, a função DateSerial retorna uma data que é o dia antes do primeiro dia (1 - 1), dois meses antes de agosto (8 - 2), 10 anos antes de 1990 (1990 - 10); em outras palavras, 31 de maio de 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Os anos de dois dígitos para o argumento do ano são interpretados com base nas configurações de computador definidas pelo usuário. As configurações padrão são valores entre 0 e 29, inclusive, são interpretados como os anos de 2000 a 2029. Os valores padrão entre 30 e 99 são interpretados como os anos de 1930 a 1999. Para todos os outros argumentos de ano , use um ano de quatro dígitos (por exemplo, 1800).
As versões do Windows anteriores ao Windows 2000 interpretam anos de dois dígitos com base nos padrões descritos acima. Para ter certeza de que a função retorna o valor adequado, use um ano de quatro dígitos.
Quando qualquer argumento excede o intervalo aceito para esse argumento, ele é incrementado para a próxima unidade maior, conforme apropriado. Por exemplo, se você especificar 35 dias, ele será avaliado como um mês e um certo número de dias, dependendo de onde no ano ele será aplicado. Se um único argumento estiver fora do intervalo de -32.768 a 32.767, ocorrerá um erro. Se a data especificada pelos três argumentos estiver fora do intervalo aceitável de datas, ocorrerá um erro.
Observação
Para ano,mês e dia, se a configuração da propriedade Calendar for gregoriano, o valor fornecido será considerado gregoriano. Se a configuração da propriedade Calendar for islâmico, o valor fornecido será considerado islâmico.
A parte da data devolvida está nas unidades de período de tempo do calendário Visual Basic atual. Por exemplo, se o calendário atual for islâmico e a parte da data a ser retornada for o ano, o valor do ano será um ano islâmico. Para o argumento ano, valores entre 0 e 99, inclusive, são interpretados como os anos 1400-1499. Para todos os outros valores de ano , use o ano completo de quatro dígitos (por exemplo, 1520).
Exemplo de consulta
| Expressão. | Resultados |
|---|---|
| SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; | Retorna a "data" para o ano, mês e dia especificados inseridos nos argumentos da função e exibe na coluna "NewDate". Resultado: "13/12/2018". |
Exemplo de VBA
Observação
Os exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.
Este exemplo usa a função DateSerial para retornar a data para o ano, mês e dia especificados.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.