DatePart

Renvoie la partie spécifiée d'une date donnée.

Structure

DatePart(intervalle, date[, premier jour de la semaine[, première semaine de l'année]])

Paramètres

intervalle - obligatoire. Expression sous forme de chaîne correspondant à l'intervalle de temps que vous souhaitez renvoyer. Consultez la section « Paramètres » pour connaître les valeurs.

date - obligatoire. Expression de date que vous souhaitez évaluer.

premierjourdelasemaine - facultatif. Constante qui spécifie le jour de la semaine. Si aucune indication n'est fournie, on considère qu'il s'agit du dimanche. Consultez la section « Paramètres » pour connaître les valeurs.

première semaine de l'année - facultatif. Constante indiquant la première semaine de l'année. Si aucune précision n'est donnée, on considère que la première semaine est celle qui comprend le 1er janvier.

Valeurs des paramètres

L'argument « interval » peut prendre les valeurs suivantes :

Description du paramètre

aaaa Année

q Trimestre

m Mois

Jour de l'année

le jour J

w Jour de la semaine

Semaine de l'année

h Heure

une minute

le deuxième

L'argument « firstdayofweek » peut prendre les valeurs suivantes :

Description de la valeur constante

vbUseSystemDayOfWeek 0 Utiliser le paramètre de l'API NLS (National Language Support).

vbDimanche 1 Dimanche (par défaut)

Lundi 2

mardi 3

Mercredi 4

Jeudi 5

vbVendredi 6 Vendredi

Samedi 7

L'argument « firstweekofyear » peut prendre les valeurs suivantes :

Description de la valeur constante

vbUseSystem 0 Utiliser le paramètre de l'API NLS (National Language Support).

vbFirstJan1 1 Commencer par la semaine dans laquelle tombe le 1er janvier (par défaut).

vbFirstFourDays 2 Commencer par la semaine qui compte au moins quatre jours dans la nouvelle année.

vbFirstFullWeek 3 Commençons par la première semaine complète de la nouvelle année.

Description

Vous pouvez utiliser la fonction DatePart pour analyser une date et renvoyer un intervalle de temps spécifique. Par exemple, vous pouvez utiliser DatePart pour calculer le jour de la semaine ou l'heure actuelle.

L'argument « firstdayofweek » influe sur les calculs qui utilisent les symboles d'intervalle « w » et « ww ».

Si « date » est une valeur littérale de date, l'année indiquée devient une partie intégrante de cette date. Toutefois, si la date est placée 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 de date est évaluée. Cela permet d'écrire du code réutilisable d'une année à l'autre.

Exemple

Cet exemple prend une date et, à l'aide de la fonction DatePart, affiche le trimestre de l'année auquel elle correspond.

Fonction GetQuarter(TheDate)

GetQuarter = DatePart("q", TheDate)

End Function. |