Devolve uma Variante (Data) para um ano, mês ou dia especificado.
Sintaxe
DateSerial ( ano, mês, dia )
Aviso Certifique-se de que os argumentos estão no intervalo de valores correto. Um argumento inválido pode resultar num resultado incorreto.
A sintaxe da função DateSerial tem estes argumentos:
Argumento |
Descrição |
ano |
Obrigatório. Número inteiro. Número entre 100 e 9999, inclusive ou um expressão numérica. |
mês |
Obrigatório. Número inteiro. Qualquer expressão numérica. |
dia |
Obrigatório. Número inteiro. Qualquer expressão numérica. |
Observações
Para especificar uma data, como 31 de dezembro de 1991, o intervalo de números para cadaargumentoDateSerial deve estar no intervalo aceite para a unidade; ou seja, 1 a 31 para dias e 1 a 12 durante meses. No entanto, também pode especificar datas relativas para cada argumento utilizando qualquer expressão numérica que represente algum número de dias, meses ou anos antes ou depois de uma determinada data.
O exemplo seguinte utiliza expressões numéricas em vez de números de data absolutos. Aqui, a função DateSerial devolve uma data que é o dia anterior ao primeiro dia (1 - 1), dois meses antes de agosto (8 - 2), 10 anos antes de 1990 (1990 - 10); por outras palavras, 31 de maio de 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Os anos de dois dígitos para o argumento ano são interpretados com base nas definições de máquina definidas pelo utilizador. As predefinições são que os valores entre 0 e 29, inclusive, são interpretados como os anos 2000-2029. Os valores predefinidos entre 30 e 99 são interpretados como os anos 1930-1999. Para todos os outros argumentos de ano , utilize 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 nas predefinições descritas acima. Para se certificar de que a função devolve o valor adequado, utilize um ano de quatro dígitos.
Quando um argumento excede o intervalo aceite para esse argumento, incrementa para a unidade maior seguinte, conforme adequado. Por exemplo, se especificar 35 dias, este é avaliado como um mês e um número de dias, consoante o local no ano em que é aplicado. Se um único argumento estiver fora do intervalo -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.
Nota: Para ano, mês e dia, se a definição da propriedade Calendário for Gregoriano, o valor fornecido é considerado Gregoriano. Se a definição da propriedade Calendário for Hijri, assume-se que o valor fornecido é Hijri.
A parte da data devolvida encontra-se nas unidades de período de tempo do calendário atual do Visual Basic. Por exemplo, se o calendário atual for Hijri e a parte da data a devolver for o ano, o valor do ano é um ano Hijri. Para o argumento ano, os valores entre 0 e 99, inclusive, são interpretados como os anos 1400-1499. Para todos os outros valores de ano , utilize 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; |
Devolve a "data" para o ano, mês e dia especificados introduzidos nos argumentos da função e é apresentado na coluna "NewDate". Resultado: "12/13/2018". |
Exemplo de VBA
Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.
Este exemplo utiliza a função DateSerial para devolver a data do ano, mês e dia especificados.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.