Renvoie une donnée de type Variante (Entier) contenant la partie spécifiée d’une date donnée.
|
Avertissement Il existe un problème avec l’utilisation de cette fonction. Le dernier lundi de certaines années civiles peut être retourné en tant que semaine 53 alors qu’il devrait être la semaine 1. Pour plus d’informations et une solution de contournement, consultez Les fonctions Format ou DatePart peuvent retourner un numéro de semaine incorrect pour le dernier lundi de l’année. |
Syntaxe
DatePart ( interval, date [, firstdayofweek] [, firstweekofyear] )
La syntaxe de la fonction DatePart contient les arguments suivants :
|
Argument |
Description |
|
intervalle |
Obligatoire. Expression de chaîne qui correspond à l’intervalle de temps que vous souhaitez retourner. |
|
date |
Obligatoire. Valeur de variante (Date) que vous souhaitez évaluer. |
|
premierjoursem |
Facultatif. constante qui spécifie le premier jour de la semaine. Dimanche est le jour par défaut. |
|
premièresem |
Facultatif. Constante qui spécifie la première semaine de l’année. Si celle-ci n’est pas spécifiée, la semaine où intervient le 1er janvier sera utilisée par défaut. |
Paramètres
L’argument interval a les paramètres suivants :
|
Paramètre |
Description |
|
aaaa |
Année |
|
q |
Trimestre |
|
m |
Mois |
|
a |
Jour de l’année |
|
j |
Jour |
|
w |
Weekday |
|
ss |
Semaine |
|
h |
Heure |
|
n |
Minute |
|
s |
Seconde |
L’argument firstdayofweek contient les paramètres suivants :
|
Constante |
Valeur |
Description |
|
vbUseSystem |
0 |
Utilisez le paramètre d’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 a les paramètres suivants :
|
Constante |
Valeur |
Description |
|
vbUseSystem |
0 |
Utilisez le paramètre d’API NLS. |
|
vbFirstJan1 |
1 |
Commencez par la semaine au cours de laquelle le 1er janvier se produit (valeur par défaut). |
|
vbFirstFourDays |
2 |
Commencez par la première semaine qui a 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 DatePart pour évaluer une date et retourner 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 affecte les calculs qui utilisent les symboles d’intervalle « w » et « ww ».
Si date est un symbole littéral représentant une date, l’année spécifiée devient une partie permanente de cette date. Toutefois, si la date est placée entre guillemets doubles (« »), 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 qui peut être utilisé dans différentes années.
Remarque : Pour date, si le paramètre de la propriété Calendar est grégorien, la date fournie doit être grégorienne. Si le calendrier est Hijri, la date fournie doit être Hijri.
La partie date retournée se trouve dans les unités de période du calendrier arabe actuel. Par exemple, si le calendrier actuel est Hijri et que la partie date à retourner est l’année, la valeur de l’année est une année Hijri.
Exemples de requêtes
|
Expression |
Résultats |
|
SELECT DatePart(« yyyyy »,[DateofSale]) AS NewDate FROM ProductSales ; |
Renvoie la valeur « Year » des valeurs de date du champ « DateofSale ». |
|
SELECT DatePart(« q »,[DateofSale]) AS NewDate FROM ProductSales ; |
Renvoie la valeur « Quarter » (basée sur l’année calender) des valeurs de date du champ « DateofSale ». |
|
SELECT DatePart(« y »,[DateofSale]) AS NewDate FROM ProductSales ; |
Renvoie le « Jour de l’année » (1 à 365) des valeurs de date du champ « DateofSale ». |
|
SELECT DatePart(« d »,[DateofSale]) AS NewDate FROM ProductSales ; |
Retourne le 'Day' des valeurs de date du champ « DateofSale ». |
|
SELECT DatePart(« w »,[DateofSale]) AS NewDate FROM ProductSales ; |
Renvoie la valeur « Weekday » (comprise entre 1 et 7 où 1 représente dimanche) des valeurs de date du champ « DateofSale ». |
|
SELECT DatePart(« ww »,[DateofSale]) AS NewDate FROM ProductSales ; |
Retourne le « Numéro de semaine » (de 1 à 52) des valeurs de date du champ « DateofSale ». |
|
SELECT DatePart(« h »,[DateTime]) AS NewDate FROM ProductSales ; |
Retourne l’heure des valeurs de date du champ « DateTime ». |
|
SELECT DatePart(« n »,[DateTime]) AS NewDate FROM ProductSales ; |
Retourne les « Minutes » des valeurs de date du champ « DateTime ». |
|
SELECT DatePart(« s »,[DateTime]) AS NewDate FROM ProductSales ; |
Retourne les « secondes » des valeurs de date du champ « DateTime ». |
Exemple VBA
Remarque : Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour 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 Rechercher et entrez un ou plusieurs termes dans la zone de recherche.
Cet exemple prend une date et, à l’aide de la fonction DatePart , affiche le trimestre de l’année dans lequel elle se produit.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg
