Função DateAdd

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Retorna uma Variante (Data) que contém a data à qual o intervalo de tempo especificado foi adicionado.

Sintaxe

DateAdd ( intervalo, número, data )

A sintaxe da função DateAdd possui os seguintes argumentos:

Argumento

Descrição

intervalo

Necessário. Expressão de cadeia de caracteres que é o intervalo de tempo que você deseja adicionar.

número

Necessário. Expressão numérica que é o número de intervalos que você deseja adicionar. Pode ser positivo (para obter datas no futuro) ou negativo (para obter datas no passado).

Data

Necessário. Variant (Data) ou literal representando a data à qual o intervalo é adicionado.


Dica : No Access 2010, o construtor de expressões tem IntelliSense, assim você pode ver quais argumentos requer sua expressão.

Configurações

O intervaloargument possui estas configurações:

Configuração

Descrição

aaaa

Ano

/t

Trimestre

m

Mês

a

Dia do ano

d

Dia

/s

Dia da semana

ss

Semana

Exemplo de número de telefone do Lync que mostra um formato internacional de discagem

Hora

Ativar ou desativar caracteres não imprimíveis

Minuto

s

Segundo


Comentários

Você pode usar a função DateAdd para adicionar ou subtrair um intervalo de tempo especificado de uma data. Por exemplo, você pode usar DateAdd para calcular uma data 30 dias de hoje ou um tempo 45 minutos a partir de agora.

Para adicionar dias a Data, você pode usar dia do ano ("y"), dia ("d") ou dia da semana ("w").

A função DateAdd não retornará uma data inválida. O exemplo a seguir adiciona um mês a 31 de janeiro:

DateAdd("m", 1, "31-Jan-95")

Nesse caso, DateAdd retorna 28-Fev-95, não 31-Fev-95. Se a Data for 31-Jan-96, ela retornará 29-fev-96 porque 1996 é um ano de salto.

Se a data calculada preceder o ano 100 (isto é, se você subtrair mais anos do que estão na Data), ocorre um erro.

Se número não for um valor Long, ele será arredondado para o número inteiro mais próximo antes de ser avaliado.

Observação : O formato do valor de retorno para DateAdd é determinado por configurações do Painel de controle , não pelo formato passado no argumento date .

Observação : Para Data, se a configuração de propriedade de calendário for Gregoriano, a data fornecida deverá ser gregoriano. Se o calendário for Islâmico, a data fornecida deverá ser islâmico. Se os valores de mês nomes, o nome deve ser consistente com a configuração de propriedade atual do calendário . Para minimizar a possibilidade de nomes de meses em conflito com a configuração de propriedade atual do calendário , insira valores de meses numéricos (formato de data abreviada).

Exemplo

Observação : Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa e insira um ou mais termos na caixa de pesquisa.

Este exemplo usa uma data como entrada e usa a função DateAdd para exibir uma data correspondente um número especificado de meses no futuro.

Dim FirstDate As Date    ' Declare variables.
Dim IntervalType As String
Dim Number As Integer
Dim Msg
IntervalType = "m" ' "m" specifies months as interval.
FirstDate = InputBox("Enter a date")
Number = InputBox("Enter number of months to add")
Msg = "New date: " & _
DateAdd(IntervalType, Number, FirstDate)
MsgBox Msg

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×