DateAdd, fonction

Important :  Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

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

Syntaxe

DateAdd ( intervalle, nombre, date )

La syntaxe de la fonction DateAdd comprend les arguments suivants :

Argument

Description

intervalle

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

nombre

Obligatoire. Expression numérique qui est le nombre d’intervalles à ajouter. Il peut être positif (pour obtenir des dates futures) ou négatif (pour obtenir des dates dans le passé).

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’Expression contient IntelliSense, afin que vous puissiez voir quels arguments votre expression requiert.

Paramètres

L' intervalleargument contient ces paramètres :

Paramètre

Description

aaaa

Année

t

Trimestre

m

Mois

d

Jour de l’année

j

Jour

js

Jour de la semaine

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é à une date. Par exemple, vous pouvez utiliser DateAdd pour calculer une date de 30 jours du jour ou une heure 45 minutes à partir de maintenant.

Pour ajouter des jours à ce jour, vous pouvez utiliser le jour de l’année (« y »), jour (« d ») ou jour de la semaine (« m »).

La fonction DateAdd renvoie pas une date non valide. L’exemple suivant ajoute un mois et le 31 janvier :

DateAdd("m", 1, "31-Jan-95")

Dans ce cas, DateAdd renvoie 28-fév-95, non 31-fév-95. Si la date est 31-Jan-96, elle renvoie 29-fév-96, car 1996 est une année bissextile.

Si la date calculée est antérieure à l’année 100 (autrement dit, si vous soustrayez plus d’années que l’argument date), une erreur se produit.

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

Remarque : Le format de la valeur renvoyée pour DateAdd est déterminé par les paramètres du Panneau de configuration et non par le format passé dans l’argument date .

Remarque : Pour afficher la date, si le paramètre de propriété calendrier est grégorien, la date fournie doit être grégorien. Si le calendrier islamique (Hijri), la date fournie doit être islamique. Si les valeurs de mois sont des noms, le nom doit être cohérent avec le paramètre de propriété calendrier en cours. Pour éviter que les noms de mois en conflit avec le paramètre de propriété calendrier actif, entrez les valeurs de mois numériques (format de Date courte).

Exemple

Remarque : Exemples suivants illustrent l’utilisation de cette fonction dans une Visual Basic pour le module d’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 recherche et entrez un ou plusieurs termes dans la zone de recherche.

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

Remarque : Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Développez vos compétences
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.

×