DatePart, fonction

Important :  Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

Renvoie une donnée de type Variante (Entier) contenant la partie spécifiée d’une date donnée.

Syntaxe

DatePart ( intervalle, date [, premierjoursem] [, premièresem] )

La syntaxe de la fonction DatePart comprend les arguments suivants :

Argument

Description

intervalle

Obligatoire. Expression de chaîne qui est l’intervalle de temps que vous souhaitez revenir.

date

Obligatoire. Variant Valeur (date) que vous souhaitez évaluer.

premierjoursem

Facultatif. constante qui spécifie le premier jour de la semaine. Le cas contraire, dimanche est utilisé.

premièresem

Facultatif. Constante spécifiant la première semaine de l’année. Le cas contraire, la première semaine est supposé égal à la semaine du 1er janvier.


Sett paramètres

L' intervalleargument contient ces paramètres :

Paramètre

Description

aaaa

Année

t

Trimestre

m

Mois

d

Jour de l’année

j

Jour

js

Jour de la semaine

ss

Semaine

h

Heure

n

Minute

s

Seconde


L’argument premierjoursem comporte ces paramètres :

Constante

Valeur

Description

vbUseSystem

0

Utiliser le paramètre NLS API.

vbSunday

1

Dimanche (par défaut)

vbMonday

2

Lundi

vbTuesday

3

Mardi

vbWednesday

4

Mercredi

vbThursday

5

Jeudi

vbFriday

6

Vendredi

vbSaturday

7

Samedi


L’argument premièresem comporte ces paramètres :

Constante

Valeur

Description

vbUseSystem

0

Utiliser le paramètre NLS API.

vbFirstJan1

1

Commencez par semaine du 1er janvier (par défaut).

vbFirstFourDays

2

Précédez la première semaine comportant au moins quatre jours dans la nouvelle année.

vbFirstFullWeek

3

Commencez par la première semaine complète de l’année.


Notes

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

L’argument premierjoursem affecte les calculs qui utilisent les symboles d’intervalle « w » et « SS ».

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 date est placée entre guillemets doubles ( » «) et si vous omettez l’année, l’année en cours est insérée dans votre code chaque fois que l’expression date est évaluée. Cela permet d’écrire du code pouvant être utilisées pour des années différentes.

Remarque : Pour afficher la date, si le paramètre de propriété calendrier est grégorien, la date fournie doit être grégorien. Si le calendrier islamique (Hijri), la date fournie doit être islamique.

La partie date retournée est dans l’unité de temps du calendrier arabe. Par exemple, si le calendrier actuel est islamique (Hijri) et la partie de date à renvoyer est l’année, la valeur de l’année est une année Hijri.

Exemple

Remarque : Exemples suivants illustrent l’utilisation de cette fonction dans une Visual Basic pour le module d’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 recherche 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 il se produit.

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg

Remarque : Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Développez vos compétences
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×