DATEADD |
Ajout de date |
|---|---|
| Visual Basic | |
Syntaxe
| Function DateAdd(interval,number,date) |
Paramètres
| Nom | Description | |
|---|---|---|
| interval | Ce paramètre permet d'indiquer le type d'intervalle de temps à ajouter : | |
| Valeur | Description | |
| "yyyy" | Cette valeur permet d'indiquer une année | |
| "q" | Cette valeur permet d'indiquer un trimestre | |
| "m" | Cette valeur permet d'indiquer un mois | |
| "y" | Cette valeur permet d'indiquer des jours dans l'année | |
| "d" | Cette valeur permet d'indiquer un jour | |
| "w" | Cette valeur permet d'indiquer un jour de semaine | |
| "ww" | Cette valeur permet d'indiquer une semaine de l'année | |
| "h" | Cette valeur permet d'indiquer l'heure | |
| "n" | Cette valeur permet d'indiquer les minutes | |
| "s" | Cette valeur permet d'indiquer les secondes | |
| number | Ce paramètre permet d'indiquer la quantité à appliquer à l'intervalle | |
| date | Ce paramètre permet d'indiquer la date sur laquelle il faut effectuer le calcul | |
Description
Cette fonction retourne une date avec une expression de temps ajouté.
Remarques
- 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 dans 30 jours à partir d'aujourd'hui ou dans 45 minutes à partir de maintenant. Pour ajouter des jours à ce jour, vous pouvez utiliser le jour de l'année ("y"), le jour ("d") ou le jour de la semaine ("w").
- La fonction DateAdd ne retournera pas de date non valide. L'exemple suivant ajoute un mois au 31 janvier :
- Si nombre n'est pas une valeur Long, il est arrondi au nombre entier le plus proche avant d'être évalué.
NewDate = DateAdd("m", 1, "31-Jan-83")
Dans ce cas, DateAdd renvoie 28-Feb-83, pas 31-Feb-83. Si la date est le 31 janvier 84, elle renvoie 29 février 86 car 1984 est une année bissextile. Si la date calculée précède l'année 100, une erreur se produit.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- Sub Main()
- MsgBox "d=" & DateAdd("d",1,"2010-01-09") & vbCrLf & _
- "h=" & DateAdd("h",1,"2010-01-09 05:30:00") & vbCrLf & _
- "m=" & DateAdd("m",1,"2010-01-09") & vbCrLf & _
- "n=" & DateAdd("n",1,"2010-01-09 05:30:00") & vbCrLf & _
- "q=" & DateAdd("q",1,"2010-01-09") & vbCrLf & _
- "s=" & DateAdd("s",1,"2010-01-09 05:30:00") & vbCrLf & _
- "w=" & DateAdd("w",1,"2010-01-09") & vbCrLf & _
- "ww=" & DateAdd("ww",1,"2010-01-09") & vbCrLf & _
- "y=" & DateAdd("y",1,"2010-01-09") & vbCrLf & _
- "yyyy=" & DateAdd("yyyy",1,"2010-01-09")
- End Sub
on obtiendra le résultat suivant :
d=10/01/2010h=09/01/2010 06:30:00
m=09/02/2010
n=09/01/2010 05:31:00
q=09/04/2010
s=09/01/2010 05:30:01
w=10/01/2010
ww=16/01/2010
y=10/01/2010
yyyy=09/01/2011
Dernière mise à jour : Lundi, le 19 novembre 2012