Renvoie une date à laquelle un intervalle spécifique a été ajouté.
DateAdd(interval, number, date)
interval
Requis. Expression de chaîne correspondant à l'intervalle à ajouter. Les valeurs sont indiquées dans la section Paramètres.
number
Requis. Expression numérique précisant le nombre d'intervalles à ajouter. L'expression numérique peut être positive, pour les dates dans le futur, ou négative pour les dates dans le passé.
date
Requis. Variant ou littéral représentant la date à laquelle l'argument interval est ajouté.
L'argument interval peut prendre les valeurs suivantes :
| Valeur | Description |
|---|---|
| yyyy | Année |
| q | Trimestre |
| m | Mois |
| y | Jour de l'année |
| d | Jour |
| w | Jour de la semaine |
| ww | Semaine |
| h | Heure |
| n | Minute |
| s | Seconde |
La fonction DateAdd permet d'additionner à une date un intervalle spécifique, ou de le soustraire. Par exemple, DateAdd permet de calculer une date à 30 jours d'aujourd'hui ou une heure à 45 minutes de maintenant. Pour ajouter des jours à l'argument date, vous pouvez utiliser Jour de l'année ("y"), Jour ("d") ou Jour de la semaine ("w").
La fonction DateAdd ne renvoie pas une date incorrecte. L'exemple suivant ajoute un mois au 31 janvier :
NouvDate = DateAdd("m", 1, "31-Jan-95")Dans ce cas, la fonction DateAdd renvoie 28-Fév-95, et non 31-Fév-95. Si l'argument date a la valeur 31-Jan- 96, la fonction renvoie 29-Fév-96, puisque 1996 est une année bissextile.
Si la date calculée précède l'année 100, une erreur se produit.
Si un nombre ne correspond pas à une valeur de type Long, il est arrondi au nombre entier le plus proche avant d'être évalué.