Renvoie la partie spécifiée d'une date donnée.
DatePart(interval, date[, firstdayofweek[, firstweekofyear]])
interval
Expression de chaîne représentant l'intervalle à renvoyer. Reportez-vous à la section Paramètres.
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 Paramètres.
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 Paramètres.
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. |
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