DatePart, fonction

Microsoft VBScript

previous page next page
Microsoft® Visual Basic® Scripting Edition DatePart, fonction Référence du langage 
Version 2 

Voir aussi

Description
Renvoie la partie spécifiée d'une date donnée.
Syntaxe
DatePart(interval, date[, firstdayofweek[, firstweekofyear]])

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

élément Description
interval Expression de chaîne représentant l'intervalle à renvoyer. Reportez-vous à la section Valeurs.
date Expression de date à évaluer.
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 DatePart permet d'évaluer une date et de renvoyer un intervalle spécifique. Vous pouvez notamment l'utiliser pour calculer le jour de la semaine ou l'heure courante.

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

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

Cet exemple prend une date et, à l'aide de la fonction DatePart, affiche le trimestre concerné. 

Function GetQuarter(TheDate)
  GetQuarter = DatePart("q", TheDate)
End Function

previous page start next page