Devuelve un tipo de datos Variant (Date) que contiene una fecha con un intervalo de tiempo especificado agregado.
Sintaxis
DateAdd(interval, number, date)
La DateAdd función tiene estos argumentos:
| argumento | Descripción |
|---|---|
interval |
Obligatorio. Expresión de cadena que es el intervalo de tiempo que desea agregar. |
number |
Obligatorio. Expresión numérica que es el número de intervalos que desea agregar. Puede ser positivo obtener fechas en el futuro o negativas para obtener fechas en el pasado. |
date |
Obligatorio. Variant (Date) o literal que representa la fecha a la que se agrega el intervalo. |
Configuración
El interval argumento tiene esta configuración:
| Configuración | Descripción |
|---|---|
yyyy |
Año |
q |
Trimestre |
m |
Mes |
y |
Día del año |
d |
Día |
w |
Weekday |
ww |
Semana |
h |
Hora |
n |
Minuto |
s |
Segundo |
Observaciones
Puede usar la DateAdd función para sumar o restar un intervalo de tiempo especificado a una fecha. Por ejemplo, puede usar DateAdd para calcular una fecha 30 días a partir de hoy o una hora a 45 minutos de ahora.
Para agregar días a date, puede usar Día del año ("y"), Día ("d") o Día laborable ("w").
La DateAdd función no devolverá una fecha no válida. En el ejemplo siguiente se suma un mes al 31 de enero:
DateAdd("m", 1, "31-Jan-95")
En este caso, DateAdd devuelve 28-feb-95, no 31-feb-95. Si date es 31 ene-96, devuelve 29-feb-96 porque 1996 es un año bisiesto.
Si la fecha calculada precede al año 100, lo que significa que resta más años de los que hay en date, se produce un error.
Si number no es un valor Long, Access lo redondea al número entero más cercano antes de evaluar la expresión.
Nota
El formato del valor devuelto para DateAdd está determinado por Panel de control configuración, no por el formato pasado en el date argumento.
Nota
Para date, si el valor de la Calendar propiedad es Gregoriano, la fecha proporcionada debe ser gregoriana. Si el calendario es Hijri, la fecha suministrada debe ser Hijri. Si los valores del mes son nombres, el nombre debe coincidir con el valor de la propiedad actual Calendar . Para reducir la posibilidad de conflictos, escriba los valores numéricos del mes en formato Fecha corta.
Ejemplos de consulta
| Expresión | Resultados |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Suma 1 año a los valores de fecha del DateofSale campo. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Resta 1 año de los valores de fecha del DateofSale campo. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Suma 10 días a los valores de fecha del DateofSale campo y devuelve los resultados de la NewDate columna. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Resta 1 semana o 7 días a los valores de fecha del DateofSale campo y devuelve los resultados de la NewDate columna. |
Ejemplo VBA:
Nota
Los ejemplos siguientes muestran el uso de esta función en un módulo de Visual Basic para Aplicaciones (VBA). Para obtener más información sobre cómo trabajar con VBA, vea Referencia de VBA de Access.
Este ejemplo toma una fecha como entrada y usa la DateAdd función para mostrar la fecha coincidente un número especificado de meses en el 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