Fonction DateAdd
Retourne une valeur de type Variant (Date) contenant une date à laquelle un intervalle de temps spécifié a été ajouté.
Syntaxe
DateAdd(interval, number, date)
La syntaxe de la fonction DateAdd comprend les arguments nommés suivants :
| Élément | Description |
|---|---|
| interval | Obligatoire. Expression de chaîne correspondant à l’intervalle de temps à ajouter. |
| number | Obligatoire. Expression numérique correspondant au nombre d’intervalles à ajouter. Elle peut être positive (pour obtenir des dates futures) ou négative (pour obtenir des dates passées). |
| date | Obligatoire. Variant (Date) ou caractère littéral représentant la date à laquelle l’intervalle est ajouté. |
Paramètres
L’argumentinterval a les paramètres suivants :
| Setting | 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 | Deuxième |
Remarques
Utilisez la fonction DateAdd pour ajouter ou soustraire un intervalle de temps spécifié d’une date. Par exemple, vous pouvez utiliser DateAdd pour calculer une date 30 jours à partir d’aujourd’hui ou une heure 45 minutes à partir de maintenant.
Pour ajouter des jours à la valeur de l’argument date, vous pouvez utiliser les valeurs Jour de l’année (« y »), Jour (« d ») ou Jour de la semaine (« w »).
Remarque
Lorsque vous utilisez l’intervalle « w » (qui comprend tous les jours de la semaine, du dimanche au samedi) pour ajouter des jours à une date, la fonction DateAdd ajoute le nombre total de jours que vous avez spécifié à la date, au lieu d’ajouter uniquement le nombre de jours ouvrables (du lundi au vendredi), comme vous pourriez vous y attendre.
La fonction DateAdd ne renvoie pas une date non valide. L’exemple suivant ajoute un mois à la date du 31 janvier :
DateAdd("m", 1, "31-Jan-95")
Dans ce cas, DateAdd retourne 28-Feb-95, et non 31-Feb-95. Si l’argument date a la valeur 31-Jan-96, elle retourne 29-Feb-96, 1996 étant une année bissextile.
Si la date calculée devait être antérieure à l’année 100 (c’est-à-dire, si vous retirez un nombre d’années supérieur à celui indiqué dans l’argument date), une erreur se produit.
Si l’argument number n’est pas une valeur de type Long, il est arrondi au nombre entier le plus proche avant d’être évalué.
Remarque
Le format de la valeur retournée correspondant à la fonction DateAdd est déterminé par les valeurs du Panneau de configuration, non par le format qui est passé à l’argument date.
Remarque
Pour date, si la valeur de la propriété Calendrier est grégorien, la date fournie doit être grégorienne. Si le calendrier est hégirien, la date fournie doit être de ce type. Si les valeurs de mois sont des noms, le nom doit être cohérent avec la valeur actuelle de la propriété Calendar. Pour réduire le risque de conflit entre les noms de mois et la valeur actuelle de la propriété Calendar, entrez des valeurs de mois numériques (format Date courte).
Exemple
Cet exemple prend une date et, à l’aide de la fonction DateAdd, fournit une nouvelle date à laquelle un nombre de mois donné a été ajouté.
Dim FirstDate As Date ' Declare variables.
Dim IntervalType As String
Dim Number As Integer
Dim Msg As String
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
Voir aussi
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.