Função DataSerial

Devolve uma Variante (Data) para um ano, mês ou dia especificado.

Sintaxe

DataSerial ( ano, mês, dia )

A sintaxe da função DataSerial tem os seguintes 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, tal como 31 de dezembro de 1991, o intervalo de números para cadaargumento de DateSerial deve estar no intervalo aceite para a unidade; ou seja, 1 – 31 para dias e 1 – 12 para meses. No entanto, também pode especificar datas relativas para cada argumento com qualquer expressão numérica que represente um 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 absoluta. Aqui, a função DateSerial devolve 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); 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 computador definidas pelo utilizador. As definições predefinidas são que os valores entre 0 e 29, inclusive, são interpretados como os anos 2000 a 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 com dois dígitos com base nos predefinidos descritos acima. Para se certificar de que a função devolve o valor correto, utilize um ano de quatro dígitos.

Quando qualquer argumento exceder o intervalo aceite para esse argumento, o mesmo será incrementado para a unidade maior seguinte, conforme adequado. Por exemplo, se especificar 35 dias, o mesmo é avaliado como um mês e um número de dias, consoante o local em que o ano é 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 cair fora do intervalo de datas aceitável, ocorrerá um erro.

Nota: Para ano, mêsedia, se a definição da propriedade calendário for Gregoriano, o valor fornecido é assumido como gregoriano. Se a definição da propriedade calendário for Hijri, o valor fornecido é assumido como Hijri.

A parte de data devolvida está 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 de quatro dígitos completo (por exemplo, 1520).

Exemplo de consulta

Expressão

Resultados

Selecione DateSerial (2018; 12; 13) como NewDate a partir de ProductSales;

Devolve a "data" do ano, mês e dia especificados nos argumentos da função e mostra na coluna "NewDate". Resultado: "13/12/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 DataSerial 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.

Nota:  Esta página foi traduzida automaticamente e pode conter erros gramaticais ou imprecisões. O nosso objetivo é que estes conteúdos lhe sejam úteis. Pode indicar-nos se estas informações foram úteis? Eis o artigo em inglês para sua referência.​

Consulte Também

Escolher a função de data correta

Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×