Adapter une formule dans une macro

DatePart, fonction


Renvoie une valeur de type Variant (Integer) contenant l'élément spécifié d'une date donnée.

Syntaxe

DatePart(interval, date[,firstdayofweek, firstweekofyear]])

La syntaxe de la fonction DatePart comprend les arguments nommés suivants :

Élément Description
interval Expression de chaîne correspondant à l'intervalle de temps à renvoyer.
date Valeur Variant (Date) à évaluer.
firstdayofweek Facultatif. Constante précisant le premier jour de la semaine. Si aucune valeur n'est précisée, la valeur par défaut est dimanche.
firstweekofyear Facultatif. Constante précisant la première semaine de l'année. Si aucune valeur n'est précisée, la première semaine est par défaut celle du 1er janvier.



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 les paramètres de l'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 firtweekofyear peut prendre les valeurs suivantes :

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



Remarques

Utilisez la fonction DatePart pour évaluer une date et renvoyer un intervalle de temps spécifique. Par exemple, utilisez la fonction DatePart pour calculer le jour de la semaine ou l'heure en cours.

L'argument firstdayofweek a une incidence sur les calculs qui utilisent les symboles d'intervalles "w" et "ww".

Si date est un littéral date, l'année précisée devient un élément permanent de cette date. Toutefois, si date apparaît entre guillemets (" "), et si vous n'indiquez pas l'année, l'année en cours est insérée automatiquement chaque fois que l'expression date est évaluée. Vous pouvez ainsi écrire du code qui sera réutilisable au fil des années.

Note Pour date, si la valeur de la propriété Calendar est Grégorien, la date fournie par l'utilisateur doit être du même type. S'il s'agit d'un calendrier Hijri, la date doit prendre la valeur Hijri.

La partie de la date renvoyée est exprimée en unités périodiques du calendrier arabe actuel. Si, par exemple, le calendrier actuel est du type Hijri et que la partie de la date à renvoyer est l'année, la valeur obtenue correspond à une année Hijri.

Cliquez pour agrandir...