Renvoie une donnée de type Variante (Entier) contenant la partie spécifiée d’une date donnée.
| Avertissement Il y a 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 obtenir plus d’informations et une solution de contournement, voir Les fonctions Format ou PartDate peuvent renvoyer un numéro de semaine incorrect pour le dernier lundi de l’année. |
|---|
Syntaxe
PartDate(intervalle, date [, firstdayofweek] [, firstweekofyear] )
La syntaxe de la fonction PartDate contient les arguments suivants :
| Argument | Description |
|---|---|
| intervalle | Obligatoire. Expression de chaîne qui représente l’intervalle de temps que vous souhaitez retourner. |
| date | Obligatoire. Valeur Variant (Date) que vous souhaitez évaluer. |
| premierjoursem | Facultatif. Constante spécifiant 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ètres | 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 a les paramètres suivants :
| Constante | Valeur | Description |
|---|---|---|
| vbUseSystem | 0 | Utilisez le paramètre d’API NLS. |
| vbSunday | 1 | Dimanche (par défaut) |
| vbMonday | 2 | Lundi |
| vbTuesday | 3 | Mardi |
| vbWednesday | 4 | Mercredi |
| vbThursday | 5 | Jeudi |
| vbFriday | 6 | Vendredi |
| vbSamedi | 7 | Samedi |
L’argument firstweekofyear a les paramètres suivants :
| Constante | Valeur | Description |
|---|---|---|
| vbUseSystem | 0 | Utilisez le paramètre d’API NLS. |
| vbFirstJan1 | 1 | Commence par la semaine du 1er janvier (par défaut). |
| vbFirstFourDays | 2 | Commencez par la première semaine qui compte 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 PartDate pour évaluer une date et renvoyer un intervalle de temps spécifique. Par exemple, vous pouvez utiliser PartDate 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 littéral de 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 la 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 de date renvoyée est indiquée dans les unités de période du calendrier arabe actuel. Par exemple, si le calendrier en cours est de l’Hégiri et que la partie de date à renvoyer est l’année, la valeur de l’année est une année de l’Hégire.
Exemples de requête
| Expression | Résultats |
|---|---|
| SELECT DatePart(« yyyy »,[DateofSale]) AS NewDate FROM ProductSales ; | Renvoie l'« Année » des valeurs de date du champ « DateofSale ». |
| SELECT PartDate(« t »,[DateofSale]) AS NewDate FROM ProductSales ; | Renvoie le « Trimestre » (en fonction de l’année du calendrier) des valeurs de date du champ « DateofSale ». |
| SELECT PartDate(« 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 ; | Renvoie le « Jour » des valeurs de date du champ « DateofSale ». |
| SELECT DatePart(« w »,[DateofSale]) AS NewDate FROM ProductSales ; | Renvoie le nombre de jours de la semaine (de 1 à 7, où 1 représente le dimanche) des valeurs de date du champ « DateofSale ». |
| SELECT PartDate(« ss »,[DatedeVente]) AS NewDate FROM ProductSales ; | Renvoie le « Numéro de semaine » (de 1 à 52) des valeurs de date du champ « DateofSale ». |
| SELECT PartDate(« h »,[DateTime]) AS NewDate FROM ProductSales ; | Renvoie l’heure des valeurs de date du champ DateTime. |
| SELECT PartDate(« n »,[DateTime]) AS NewDate FROM ProductSales ; | Renvoie les minutes des valeurs de date du champ DateTime. |
| SELECT DatePart(« s »,[DateTime]) AS NewDate FROM ProductSales ; | Renvoie les « secondes » des valeurs de date du champ « DateTime ». |
Exemple de 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 développeur dans la liste déroulante en regard de Rechercher , puis entrez un ou plusieurs termes dans la zone de recherche.
Cet exemple prend une date et, à l’aide de la fonction PartDate, 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