Renvoie une donnée de type Variante (Date) contenant une date à laquelle l’intervalle de temps spécifié a été ajouté.
Syntaxe
DateAdd ( interval, number, date )
La syntaxe de la fonction DateAdd contient les arguments suivants :
|
Argument |
Description |
|---|---|
|
intervalle |
Obligatoire. Expression de chaîne qui correspond à l’intervalle de temps que vous souhaitez ajouter. |
|
nombre |
Obligatoire. Expression numérique qui correspond au nombre d’intervalles que vous souhaitez ajouter. Peut être positive (pour obtenir des dates futures) ou négative (pour obtenir des dates passées). |
|
date |
Obligatoire. Variant (Date) ou littéral représentant la date à laquelle l’intervalle est ajouté. |
Paramètres
L’intervalle argument a les paramètres suivants :
|
Paramètre |
Description |
|---|---|
|
aaaa |
Année |
|
q |
Trimestre |
|
m |
Mois |
|
a |
Jour de l’année |
|
j |
Jour |
|
w |
Weekday |
|
ss |
Semaine |
|
h |
Heure |
|
n |
Minute |
|
s |
Seconde |
Remarques
Vous pouvez utiliser la fonction DateAdd pour ajouter ou soustraire un intervalle de temps spécifié à partir d’une date. Par exemple, vous pouvez utiliser DateAdd pour calculer une date de 30 jours à partir d’aujourd’hui ou une heure de 45 minutes à partir de maintenant.
Pour ajouter des jours à la date, vous pouvez utiliser Jour de l’année (« y »), Jour (« d ») ou Jour de la semaine (« w »).
La fonction DateAdd ne retourne pas de date non valide. L’exemple suivant ajoute un mois au 31 janvier :
DateAdd("m", 1, "31-Jan-95")
Dans ce cas, DateAdd renvoie 28-Feb-95, et non 31-Feb-95. Si la date est le 31-Jan-96, elle renvoie le 29-Fév-96, car 1996 est une année bissextile.
Si la date calculée précède l’année 100 (autrement dit, vous soustriez plus d’années que la date), une erreur se produit.
Si nombre n’est pas une valeur de type Long, il est arrondi au nombre entier le plus proche avant d’être évalué.
Remarque : Le format de la valeur de retour pour DateAdd est déterminé par Panneau de configuration paramètres, et non par le format passé dans l’argument date.
Remarque : Pour date, si le paramètre de la propriété Calendar est grégorien, la date fournie doit être grégorienne. Si le calendrier est Hijri, la date fournie doit être Hijri. Si les valeurs de mois sont des noms, le nom doit être cohérent avec le paramètre de propriété Calendar actuel. Pour réduire le risque que les noms de mois entrent en conflit avec le paramètre de propriété Calendrier actuel, entrez les valeurs numériques du mois (format Date courte).
Exemples de requêtes
|
Expression |
Résultats |
|---|---|
|
SELECT DateAdd(« AAAA »,1,[DateofSale]) AS Expr1 FROM ProductSales ; |
Retourne les résultats en ajoutant 1 an aux valeurs de date du champ « DateofSale ». |
|
SELECT DateAdd(« AAAA »,-1,[DateofSale]) AS Expr1 FROM ProductSales ; |
Retourne les résultats en soustrayant 1 an aux valeurs de date du champ « DateofSale ». |
|
SELECT DateAdd(« d »,10,[DateofSale]) AS NewDate FROM ProductSales ; |
Retourne les résultats de la colonne « NewDate » en ajoutant 10 jours aux valeurs de date du champ « DateofSale ». |
|
SELECT DateAdd(« ww »,-1,[DateofSale]) AS NewDate FROM ProductSales ; |
Retourne les résultats de la colonne « NewDate » en soustrayant 1 semaine (7 jours) des valeurs de date du champ « DateofSale ». |
Exemple VBA
Remarque : Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour Applications (VBA). Pour plus d’informations sur l’utilisation de VBA, consultez Référence VBA Access.
Cet exemple prend une date comme entrée et utilise la fonction DateAdd pour afficher une date correspondante d’un nombre de mois spécifié à l’avenir.
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
