DateAdd, fonction

Microsoft VBScript

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 :

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

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.

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�.