DateDiff, fonction

Important :  Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

Renvoie une donnée de type Variante (Long) indiquant le nombre d’intervalles de temps entre les deux dates spécifiées.

Voir quelques exemples

Syntaxe

DateDiff ( intervalle, date1, date2 [, premierjoursem] [, premièresem] )

La syntaxe de la fonction DateDiff comprend les arguments suivants :

Conseil : Dans Access 2010, le Générateur d’Expression contient IntelliSense, afin que vous puissiez voir quels arguments votre expression requiert.

Argument

Description

intervalle

Obligatoire. Expression de chaîne qui est l’intervalle de temps que vous utilisez pour calculer la différence entre date1 et date2.

date1, date2

Obligatoire. Variant (Date). Deux dates que vous souhaitez utiliser dans le calcul.

premierjoursem

Facultatif. constante qui spécifie le premier jour de la semaine. Le cas contraire, dimanche est utilisé.

premièresem

Facultatif. Constante spécifiant la première semaine de l’année. Le cas contraire, la première semaine est supposé égal à la semaine du 1er janvier.


Paramètres

L' intervalleargument contient ces paramètres :

Paramètre

Description

aaaa

Année

t

Trimestre

m

Mois

d

Jour de l’année

j

Jour

js

Jour de la semaine

ss

Semaine

h

Heure

n

Minute

s

Seconde


Haut de la Page

L’argument premierjoursem comporte ces paramètres :

Constante

Valeur

Description

vbUseSystem

0

Utiliser le paramètre NLS API.

vbSunday

1

Dimanche (par défaut)

vbMonday

2

Lundi

vbTuesday

3

Mardi

vbWednesday

4

Mercredi

vbThursday

5

Jeudi

vbFriday

6

Vendredi

vbSaturday

7

Samedi


Constante

Valeur

Description

vbUseSystem

0

Utiliser le paramètre NLS API.

vbFirstJan1

1

Commencez par semaine du 1er janvier (par défaut).

vbFirstFourDays

2

Précédez la première semaine comportant au moins quatre jours dans la nouvelle année.

vbFirstFullWeek

3

Commencez par la première semaine complète de l’année.


Remarques

Vous pouvez utiliser la fonction DateDiff pour déterminer le nombre d’intervalles 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 les valeurs jour de l’année (« y ») ou jour (« d »). Lors de l’intervalle correspond à JourSem (« m »), DateDiff renvoie le nombre de semaines entre les deux dates. Si date1 tombe un lundi, DateDiff calcule le nombre de lundi jusqu'à date2. Il compte date2 , mais pas date1. Si l’intervalle est semaine (« ss »), toutefois, la fonction DateDiff renvoie le nombre de semaines du calendrier entre les deux dates. Il compte le nombre de dimanches entre date1 et date2. DateDiff compte date2 si elle se situe un dimanche. mais il ne compte pas date1, même si elle n’est comprise dans un dimanche.

Si date1 est ultérieure à date2, la fonction DateDiff renvoie un nombre négatif.

L’argument premierjoursem affecte les calculs qui utilisent les symboles d’intervalle « w » et « SS ».

Si date1 ou date2 est un symbole littéral représentant une date, l’année spécifiée devient une partie permanente de cette date. Toutefois, si date1 ou date2 est placé entre guillemets doubles ( » «) et si 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ées pour des années différentes.

Lorsque vous comparez le 31 décembre au 1er janvier de l’année suivante, DateDiff pour l’année (« yyyy ») renvoie 1, bien qu’un seul jour écoulé.

Remarque : Pour date1 et date2, si le paramètre de propriété calendrier est grégorien, la date fournie doit être grégorien. Si le calendrier islamique (Hijri), la date fournie doit être islamique.

Haut de la Page

Exemples

Utiliser la fonction DateDiff dans une expression     Vous pouvez utiliser la fonction DateDiff à l’endroit où vous pouvez utiliser des expressions. Par exemple, supposons que vous disposez d’un formulaire qui vous permet de commandes des clients. Dans la table Orders, vous avez un champ intitulé RéceptionAvant qui contient la date à laquelle le client doit recevoir la commande. Vous pouvez utiliser la fonction DateDiff avec une zone de texte sur le formulaire pour afficher le nombre de jours restant avant d’expédition de la commande.

En supposant que nécessaire dix jours pour envoyer n’importe quel ordre, définissez la propriété Source contrôle de la zone de texte comme suit :

= DateDiff("d", Now(), [Orders].[ RéceptionAvant]) -10

Lorsque vous ouvrez le formulaire en mode formulaire, la zone de texte affiche le nombre de jours restant avant d’expédition de la commande. S’il y reste inférieure à 10 jours avant que le client doit recevoir l’ordre, le numéro dans la zone de texte est négatif et indique le nombre de jours au plus tard l’ordre sera si elle n’est fourni immédiatement.

Utilisez la fonction DateDiff dans du code VBA   

Remarque : Exemples suivants illustrent l’utilisation de cette fonction dans une Visual Basic pour le module d’Applications (VBA). Pour plus d’informations sur l’utilisation de VBA, sélectionnez Référence du développeur dans la liste déroulante en regard de recherche et entrez un ou plusieurs termes dans la zone de recherche.

Cet exemple utilise la fonction DateDiff pour afficher le nombre de jours entre une date donnée et aujourd'hui.

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date")
Msg = "Days from today: " & DateDiff("d", Now, TheDate)
MsgBox Msg

Remarque : Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Développez vos compétences
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×