DATEDIFF |
Date de différence |
|---|---|
| Visual Basic | |
Syntaxe
| Function DateDiff(interval,date1,date2, [firstdayofweek], [firstweekofyear]) |
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 | ||
| date1 | Ce paramètre permet d'indiquer la première date sur laquelle il faut effectuer le calcul | ||
| date2 | Ce paramètre permet d'indiquer la deuxième date sur laquelle il faut effectuer le calcul | ||
| firstdayofweek | Ce paramètre optionnel permet d'indiquer le premier jour de la semaine. Les valeurs possibles sont : | ||
| Valeur | Constante | Description | |
| 0 | vbUseSystemDayOfWeek | Cette valeur permet d'indiquer qu'il faut utiliser le NLS (National Language Support) | |
| 1 | vbSunday | Cette valeur permet d'indiquer qu'il faut utiliser le Dimanche. C'est la valeur par défaut. | |
| 2 | vbMonday | Cette valeur permet d'indiquer qu'il faut utiliser le Lundi. | |
| 3 | vbTuesday | Cette valeur permet d'indiquer qu'il faut utiliser le Mardi. | |
| 4 | vbWednesday | Cette valeur permet d'indiquer qu'il faut utiliser le Mercredi. | |
| 5 | vbThursday | Cette valeur permet d'indiquer qu'il faut utiliser le Jeudi. | |
| 6 | vbFriday | Cette valeur permet d'indiquer qu'il faut utiliser le Vendredi. | |
| 7 | vbSaturday | Cette valeur permet d'indiquer qu'il faut utiliser le Samedi. | |
| firstweekofyear | Ce paramètre optionnel permet d'indiquer le premier jour de l'année. Les valeurs possibles sont : | ||
| Valeur | Constante | Description | |
| 0 | vbUseSystem | Cette valeur permet d'indiquer qu'il faut utiliser le NLS (National Language Support) | |
| 1 | vbFirstJan1 | Cette valeur permet d'indiquer qu'il faut commencer avec la semaine du premier 1 janvier. C'est la valeur par défaut. | |
| 2 | vbFirstFourDays | Cette valeur permet d'indiquer qu'il faut commencer dans les 4 derniers jours de la semaine de la nouvelle année. | |
| 3 | vbFirstFullWeek | Cette valeur permet d'indiquer qu'il faut commencer dans la premier semaine complète de la nouvelle année. | |
Description
Cette fonction permet de demander l'intervalle de temps entre deux dates.
Remarques
- Vous pouvez utiliser la fonction DateDiff pour déterminer le nombre d'intervalles de temps spécifiés entre deux dates. Par exemple, vous pouvez utiliser DateDiff pour calculer le nombre de jours entre deux dates ou le nombre de semaines entre aujourd'hui et la fin de l'année.
- Pour calculer le nombre de jours entre date1 et date2, vous pouvez utiliser le jour de l'année ("y") ou le jour ("d"). Lorsque l'intervalle est une semaine ("w"), la fonction DateDiff renvoie le nombre de semaines entre les deux dates. Si date1 tombe un lundi, la fonction DateDiff compte le nombre de lundis jusqu'à date2. Il compte date2 mais pas date1. Si l'intervalle est la semaine ("ww"), cependant, la fonction DateDiff renvoie le nombre de semaines calendaires entre les deux dates. Il compte le nombre de dimanches entre date1 et date2. La fonction DateDiff compte la date2 si elle tombe un dimanche; mais il ne compte pas la date1, même si elle tombe un dimanche.
- Si date1 fait référence à une date ultérieure à date2, la fonction DateDiff renvoie un nombre négatif.
- Le paramètre firstweekofyear affecte les calculs utilisant les symboles d'intervalle «w» et «ww».
- Si date1 ou date2 est un littéral de date, l'année spécifiée devient une partie permanente de cette date. Toutefois, si date1 ou date2 est entre guillemets ("") et que vous omettez l'année, l'année en cours est insérée dans votre code chaque fois que l'expression date1 ou date2 est évaluée. Cela permet d'écrire du code pouvant être utilisé dans différentes années.
- Lorsque vous comparez le 31 décembre au 1er janvier de l'année suivant immédiatement, la fonction DateDiff pour l'année ("yyyy") renvoie 1 même si un seul jour s'est écoulé.
- L'exemple suivant utilise la fonction DateDiff pour afficher le nombre de jours entre une date donnée et aujourd'hui :
Function DiffADate(theDate)
DiffADate = "Jours à partir d'aujourd'hui : " & DateDiff("d", Now, theDate)
End Function
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- Sub Main()
- MsgBox "d=" & DateDiff("d","2010-01-09","2011-01-09") & vbCrLf & _
- "h=" & DateDiff("h","2010-01-09 00:30:00","2011-01-09 23:30:00") & vbCrLf & _
- "m=" & DateDiff("m","2010-01-09","2011-01-09") & vbCrLf & _
- "n=" & DateDiff("n","2010-01-09 00:30:00","2011-01-09") & vbCrLf & _
- "q=" & DateDiff("q","2010-01-09","2011-01-09") & vbCrLf & _
- "s=" & DateDiff("s","2010-01-09 00:30:00","2011-01-09 23:30:00") & vbCrLf & _
- "w=" & DateDiff("w","2010-01-09","2011-01-09") & vbCrLf & _
- "ww=" & DateDiff("ww","2010-01-09","2011-01-09") & vbCrLf & _
- "y=" & DateDiff("y","2010-01-09","2011-01-09") & vbCrLf & _
- "yyyy=" & DateDiff("yyyy","2010-01-09","2011-01-09")
- End Sub
on obtiendra le résultat suivant :
d=365h=8783
m=12
n=525570
q=4
s=31618800
w=52
ww=53
y=365
yyyy=1
Dernière mise à jour : Lundi, le 19 novembre 2012