Renvoie une variante (date) qui contient une date avec un intervalle de temps spécifié ajouté.
Syntaxe
DateAdd(interval, number, date)
La DateAdd fonction contient les arguments suivants :
| Argument | Description |
|---|---|
interval |
Obligatoire. Expression de chaîne qui représente l’intervalle de temps que vous souhaitez ajouter. |
number |
Obligatoire. Expression numérique qui représente le nombre d’intervalles à additionner. Il peut être positif d’obtenir des dates dans le futur ou négatif d’obtenir des dates dans le passé. |
date |
Obligatoire. Variante (Date) ou littéral qui représente la date à laquelle l’intervalle est ajouté. |
Paramètres
Les interval paramètres de l’argument sont les 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é d’une date. Par exemple, vous pouvez calculer DateAdd une date située dans 30 jours ou dans 45 minutes.
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 renvoie pas une date non valide. L’exemple suivant ajoute un mois au 31 janvier :
DateAdd("m", 1, "31-Jan-95")
Dans ce cas, DateAdd retourne 28-Feb-95, et non 31-Feb-95. Si date c’est le 31-Jan-96, il retourne le 29-Feb-96 car 1996 est une année bissextile.
Si la date calculée précède l’année 100, ce qui signifie que vous soustrayez plus d’années que date, une erreur se produit.
Si number ce n’est pas une valeur longue, Access l’arrondit au nombre entier le plus proche avant d’évaluer l’expression.
Remarque
Le format de la valeur de retour est DateAdd déterminé par les paramètres du Panneau de configuration, et non par le format passé dans l’argumentdate.
Remarque
Pour date, si le paramètre de Calendar 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 les risques de conflit, entrez les valeurs numériques des mois au format Date courte.
Exemples de requête
| 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 aux valeurs de date incluses 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 renvoie les résultats dans la NewDate colonne. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Soustrait 1 semaine, ou 7 jours, aux valeurs de date dans le DateofSale champ et renvoie les résultats dans la NewDate colonne. |
Exemple de 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 Access VBA.
Cet exemple prend une date comme entrée et utilise la DateAdd fonction pour afficher la date correspondante un certain nombre de mois dans le futur.
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