Função DateAdd

Adds a date or time interval to a given date a number of times and returns the resulting date.

Sintaxe:


DateAdd (interval As String, number As Long, date As Date) As Date

Valor de retorno:

Uma Variante que contém uma data.

Parâmetros:

interval - A string expression from the following table, specifying the date or time interval.

interval (string value)	Explicação
yyyy	Ano
q	Trimestre
m	Mês
y	Dia do ano
w	Dia da semana
ww	Semana do ano
d	Dia
h	Hora
n	Minuto
s	Segundo

number - A numerical expression specifying how many times the interval value will be added when positive or subtracted when negative.

date - A given date or the name of a Variant variable containing a date. The interval value will be added number times to this date.

Os literais de data permitem especificar variáveis de data inequívocas que são independentes do idioma atual. Os literais são colocados entre os símbolos de cerquilha #. Os formatos possíveis são:

#yyyy-mm-dd#
#mm/dd/yyyy#

Exemplo:


Sub example_dateadd
    MsgBox DateAdd("m", 1, #1/31/2004#) &" - "& DateAdd(date:=#2005-01-31#, interval:="m", number:=1)
End Sub