DateAdd (Función)

       

Devuelve un valor de tipo Variant (Date) con una fecha a la que se ha agregado un intervalo de tiempo especificado.

Sintaxis

DateAdd(intervalo, número, fecha)

La sintaxis de la función DateAdd consta de los siguientes argumentos con nombre:

Parte	Descripción
intervalo	Requerido. Expresión de cadena que contiene el intervalo de tiempo que se desea agregar.
número	Requerido. Expresión numérica con el número de intervalos que se desea agregar. Puede ser positiva (para obtener fechas futuras) o negativa (para obtener fechas pasadas).
fecha	Requerido. Valor de tipo Variant (Date) o literal que representa la fecha en la que se agregó el intervalo.

Valores

El argumento intervalo tiene los siguientes valores:

Valor	Descripción
yyyy	Año
q	Trimestre
m	Mes
y	Día del año
d	Día
w	Día de la semana
ww	Semana
h	Hora
n	Minuto
s	Segundo

Comentarios

Puede utilizar la función DateAdd para agregar o restar un intervalo de tiempo especificado de una fecha. Por ejemplo, con DateAdd podría calcular una fecha 30 días posterior al día de hoy o una hora 45 minutos posterior a la actual.

Si desea agregar días a fecha, puede utilizar Día del año ("y"), Día ("d") o Día de la semana ("w").

La función DateAdd no devuelve nunca una fecha no válida. En el ejemplo siguiente se agrega un mes al 31 de enero:

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

En este caso, DateAdd devuelve 28-feb-95 y no 31-feb-95. Si fecha es 31-ene-96, devolverá 29-feb-96, ya que 1996 es un año bisiesto.

Si la fecha calculada va a resultar inferior al año 100 (esto es, se restan más años que los que hay en fecha), se produce un error.

Si número no es un valor de tipo Long se redondeará al número entero más cercano antes de ser evaluado.

Nota   El formato del valor devuelto por DateAdd es determinado por la configuración del Panel de control, no por el formato que se pasa en el argumento fecha.

Nota   Para fecha, si la configuración de la propiedad Calendar es gregoriano, la fecha proporcionada debe ser gregoriana. Si el calendario es Hijri, la fecha proporcionada debe ser Hijri. Si los valores de mes son nombres, el nombre debe ser consistente con la cofiguración actual de la propiedad Calenda. Para minimizar la posibilidad de conflictos de los nombres de mes con la configuración actual de Calendar, introduzca valores de mes numéricos (formato de fecha corta).