DateDiff, fonction

---

Description

Renvoie le nombre d'intervalles entre deux dates.

Syntaxe

DateDiff(interval, date1, date2 [,firstdayofweek[, firstweekofyear]])

La syntaxe de la fonction DateDiff comprend les éléments suivants :

élément	Description
interval	Expression de chaîne correspondant à l'intervalle à utiliser pour calculer la différence entre date1 et date2. Reportez-vous à la section Valeurs.
date1, date2	Expressions de date. Deux dates à utiliser dans le calcul.
firstdayofweek	Facultatif. Constante qui spécifie le jour de la semaine. Si elle n'est pas spécifiée, dimanche est pris par défaut. Reportez-vous à la section Valeurs.
firstweekofyear	Facultatif. Constante spécifiant la première semaine de l'année. Si elle n'est pas spécifiée, la première semaine sera celle incluant le 1er janvier. Reportez-vous à la section Valeurs.

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

L'argument firstdayofweek peut prendre les valeurs suivantes :

Constante	Valeur	Description
vbUseSystem	0	Utilise la valeur API NLS.
vbSunday	1	Dimanche (valeur par défaut)
vbMonday	2	Lundi
vbTuesday	3	Mardi
vbWednesday	4	Mercredi
vbThursday	5	Jeudi
vbFriday	6	Vendredi
vbSaturday	7	Samedi

L'argument firstweekofyear peut prendre les valeurs suivantes :

Constante	Valeur	Description
vbUseSystem	0	Utilise la valeur API NLS.
vbFirstJan1	1	Commence par la semaine incluant le 1er janvier (valeur par défaut).
vbFirstFourDays	2	Commence par la semaine comportant au moins quatre jours dans la nouvelle année.
vbFirstFullWeek	3	Commence par la première semaine complète de la nouvelle année.

Notes

La fonction DateDiff permet de déterminer combien d'intervalles spécifiés sont compris entre deux dates. Par exemple, elle peut 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 Jour de l'année ("y") ou Jour ("d"). Lorsque l'argument interval a la valeur Jour de la 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. Cependant, si l'argument interval a la valeur Semaine ("ww"), la fonction DateDiff renvoie le nombre de semaines de calendrier entre les deux dates. Elle compte le nombre de dimanches entre date1 et date2. La fonction DateDiff compte date2 si elle tombe un dimanche, mais ne compte pas date1, même si elle tombe un dimanche.

Si date1 se réfère à un moment ultérieur à date2, la fonction DateDiff renvoie un nombre négatif.

L'argument firstdayofweek a une incidence sur le calcul utilisant les symboles d'intervale "w" et "ww".

Si date1 ou date2 correspond à un littéral de date, l'année spécifiée devient partie permanente de cette date. Cependant, si date1 ou date2 est placé entre guillemets (" "), et si vous omettez l'année, l'année courante est insérée dans votre code lors de chaque évaluation de l'expression date1 ou date2. Il est ainsi possible d'écrire du code utilisable pendant plusieurs années.

Lors du calcul d'intervalle entre le 31 décembre de l'année précédente et le 1er janvier, la fonction DateDiff renvoie 1 pour Année ("yyyy"), même si un seul jour s'est écoulé.

L'exemple ci-dessous 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

---