Microsoft® Visual Basic® Scripting Edition DateAdd, fonction |
R�f�rence du langage Version 2 |
Description
Renvoie une date � laquelle un intervalle sp�cifi� a �t� ajout�.
Syntaxe
DateAdd(interval, number, date)La syntaxe de la fonction DateAdd comprend les �l�ments suivants :
�l�ment Description interval Requis. Expression de cha�ne correspondant � l'intervalle � ajouter. Les valeurs sont indiqu�es dans la section Valeurs. number Requis. Expression num�rique pr�cisant le nombre d'intervalles � ajouter. L'expression num�rique peut �tre positive, pour les dates dans le futur, ou n�gative pour les dates dans le pass�. date Requis. Variant ou litt�ral repr�sentant la date � laquelle l'argument interval est ajout�.
Valeurs
L'argument interval peut prendre les valeurs suivantes :
Valeur 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 Seconde
Notes
La fonction DateAdd permet d'additionner � une date un intervalle sp�cifi�, ou de le soustraire. Par exemple, DateAdd permet de calculer une date � 30 jours d'aujourd'hui ou une heure � 45 minutes de maintenant. Pour ajouter des jours � l'argument date, vous pouvez utiliser Jour de l'ann�e ("y"), Jour ("d") ou Jour de la semaine ("w").La fonction DateAdd ne renvoie pas une date incorrecte. L'exemple suivant ajoute un mois au 31 janvier :
Dans ce cas, la fonction DateAdd renvoie 28-F�v-95, et non 31-F�v-95. Si l'argument date a la valeur 31-Jan- 96, la fonction renvoie 29-F�v-96, puisque 1996 est une ann�e bissextile.NouvDate = DateAdd("m", 1, "31-Jan-95")
Si la date calcul�e pr�c�de l'ann�e 100, une erreur se produit.
Si un nombre ne correspond pas � une valeur de type Long, il est arrondi au nombre entier le plus proche avant d'�tre �valu�.