Função DateAdd

Adiciona um intervalo de data ou hora a uma data determinada um determinado número de vezes e devolve a data resultante.

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:

intervalo - Uma expressão de cadeia de caracteres da tabela seguinte, que especifica o intervalo de data ou hora.

intervalo (valor de cadeia de caracteres)	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

número - Uma expressão numérica que especifica quantas vezes o valor do intervalo será somado, se for positivo, ou subtraído, se for negativo.

data - Uma data específica ou o nome de uma variável Variant que contenha uma data. O valor intervalo será adicionado número vezes a esta data.

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