Passer directement au contenu principal

DateAdd, fonction

Renvoie une donnée de type Variante (Date) contenant une date à laquelle l’intervalle de temps spécifié a été ajouté.

Syntaxe

AjDate ( intervalle, nombre, date )

La syntaxe de la fonction DATEADD comporte les arguments suivants :

Argument

Description

intervalle

Obligatoire. Expression de chaîne qui est l’intervalle de temps que vous souhaitez ajouter.

nombre

Obligatoire. Expression numérique qui est le nombre d’intervalles que vous voulez ajouter. Peut être positive (pour obtenir des dates futures) ou négative (pour obtenir des dates passées).

date

Obligatoire. Variant (Date) ou valeur littérale représentant la date à laquelle l’intervalle est ajouté.

Conseil :  Dans Access 2010, le générateur d’expressions utilise la fonctionnalité IntelliSense, qui vous permet d’identifier les arguments dont votre expression a besoin. 

Paramètres

L' intervalleargument comporte 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

Notes

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 après la date du jour ou une heure de 45 minutes.

Pour ajouter des jours à une Date, vous pouvez utiliser le jour de l’année (« y »), le jour ("j") ou le jour de la semaine ("w").

La fonction DATEADD 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, la fonction DATEADD renvoie 28 février-95, et non le 31 février-95. Si la valeur Date est 31-Jan-96, elle renvoie 29-fév-96, car 1996 est une année bissextile.

S’il s’agit de la date calculée précédant l’année 100 (autrement dit, vous soustrayez plus de ans qu’en Date), une erreur se produit.

Si nombre n’est pas une valeur longue, il est arrondi au nombre entier le plus proche avant d’être évalué.

Remarque :  Le format de la valeur de retour pour AjDate dépend des paramètres du panneau de configuration, et non du format transmis dans l’argument Date .

Remarque :  Dans le cas d’une Date, si le paramètre de la propriété calendrier est grégorien, la date fournie doit être grégorienne. Si le calendrier est Hijri, la date fournie doit être Hijri. Si les valeurs mois sont des noms, le nom doit être cohérent avec le paramètre de la propriété calendrier actuel. Pour réduire les risques de conflits entre les noms de mois et le paramètre de la propriété calendrier actuel, entrez les valeurs de mois numériques (format de date courte).

Exemples de requête

Expression

Résultats

Sélectionnez AjDate ("YYYY"; 1 ; [DateofSale]) comme expr1 dans ProductSales ;

Renvoie les résultats en ajoutant 1 an aux valeurs de date du champ « DateofSale ».

Sélectionnez AjDate ("YYYY";-1 ; [DateofSale]) comme expr1 de ProductSales ;

Renvoie les résultats en soustrayant 1 an aux valeurs de date du champ « DateofSale ».

Sélectionnez AjDate ("j", 10, [DateofSale]) en tant que NewDate à partir de ProductSales ;

Renvoie les résultats dans la colonne « NewDate » en ajoutant 10 jours aux valeurs de date du champ « DateofSale ».

Sélectionnez AjDate ("SS",-1, [DateofSale]) en tant que NewDate à partir de ProductSales ;

Renvoie les résultats dans 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, sélectionnez Référence du développeur dans la liste déroulante en regard de Rechercher , puis entrez une ou plusieurs conditions dans la zone de recherche.

Cet exemple prend une date en entrée et utilise la fonction AjDate pour afficher une date correspondante en nombre de mois spécifié 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

Remarque :  Cette page a été traduite automatiquement et peut donc contenir des erreurs grammaticales ou des imprécisions. Notre objectif est de faire en sorte que ce contenu vous soit utile. Pouvez vous nous dire si les informations vous ont été utiles ? Voici l’article en anglais pour référence.

Voir aussi

Choisir la fonction de date correcte

Développez vos compétences dans Office
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×