Renvoie un Variant (Date) qui contient une date avec un intervalle de temps spécifié ajouté.
Syntaxe
DateAdd(interval, number, date)
La DateAdd fonction a les arguments suivants :
| Argument | Description |
|---|---|
interval |
Obligatoire. Expression de chaîne qui est l’intervalle de temps que vous souhaitez ajouter. |
number |
Obligatoire. Expression numérique qui correspond au nombre d’intervalles que vous souhaitez ajouter. Il peut être positif d’obtenir des dates dans le futur ou négatif pour obtenir des dates dans le passé. |
date |
Obligatoire. Variant (Date) ou littéral qui représente la date à laquelle l’intervalle est ajouté. |
Paramètres
L’argument interval a les paramètres suivants :
| Paramètre | Description |
|---|---|
yyyy |
Année |
q |
Trimestre |
m |
Mois |
y |
Jour de l’année |
d |
Jour |
w |
Weekday |
ww |
Semaine |
h |
Heure |
n |
Minute |
s |
Seconde |
Remarques
Vous pouvez utiliser la DateAdd fonction 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 à date, vous pouvez utiliser Jour de l’année ("y"), Jour ("d") ou Jour de la semaine ("w").
La DateAdd fonction 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 le 28-fév-95, et non le 31-fév-95. Si date est 31-Jan-96, il retourne 29-Fév-96 parce que 1996 est une année bissextile.
Si la date calculée précède l’année 100, ce qui signifie que vous soustriez plus d’années que ne le sont dans date, une erreur se produit.
Si number n’est pas une valeur de type Long, Access l’arrondit au nombre entier le plus proche avant d’évaluer l’expression.
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’argumentdate.
Remarque
Pour date, si le Calendar paramètre de propriété 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 correspondre au paramètre de propriété actuel Calendar . Pour réduire le risque de conflits, entrez des valeurs numériques de mois au format Date courte.
Exemples de requêtes
| Expression | Résultats |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Ajoute 1 an aux valeurs de date dans le DateofSale champ. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Soustrait 1 an des valeurs de date dans le DateofSale champ. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Ajoute 10 jours aux valeurs de date dans le DateofSale champ et retourne les résultats dans la NewDate colonne . |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Soustrait 1 semaine, ou 7 jours, des valeurs de date dans le DateofSale champ et retourne les résultats dans la NewDate colonne. |
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 DateAdd fonction pour afficher la date correspondante 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