DateAndTime.DatePart Méthode

Définition

Espace de noms:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Retourne une valeur entière contenant le composant spécifié d’une valeur donnée Date .

Surcharges

Nom	Description
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)	Retourne une valeur entière contenant le composant spécifié d’une valeur donnée `Date` .
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)	Retourne une valeur contenant le composant spécifié d’une valeur donnée `Date` .

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Retourne une valeur entière contenant le composant spécifié d’une valeur donnée Date .

public static int DatePart(Microsoft.VisualBasic.DateInterval Interval, DateTime DateValue, Microsoft.VisualBasic.FirstDayOfWeek FirstDayOfWeekValue = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear FirstWeekOfYearValue = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);

static member DatePart : Microsoft.VisualBasic.DateInterval * DateTime * Microsoft.VisualBasic.FirstDayOfWeek * Microsoft.VisualBasic.FirstWeekOfYear -> int

Public Function DatePart (Interval As DateInterval, DateValue As DateTime, Optional FirstDayOfWeekValue As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Optional FirstWeekOfYearValue As FirstWeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1) As Integer

Paramètres

Interval: DateInterval

Required. Valeur DateInterval d’énumération ou expression de chaîne représentant la partie de la valeur de date/heure à retourner.

DateValue: DateTime

Required. Valeur Date à évaluer.

FirstDayOfWeekValue: FirstDayOfWeek

Optional. Valeur choisie à partir de l’énumération FirstDayOfWeek qui spécifie le premier jour de la semaine. En l'absence de spécification, Sunday est utilisé.

FirstWeekOfYearValue: FirstWeekOfYear

Optional. Valeur choisie dans l’énumération FirstWeekOfYear qui spécifie la première semaine de l’année. En l'absence de spécification, Jan1 est utilisé.

Retours

Int32

Valeur entière contenant le composant spécifié d’une valeur donnée Date .

Exceptions

ArgumentException

Interval n’est pas valide.

InvalidCastException

DateValue n’est pas coercible à Date.

Exemples

Cet exemple prend une date et, à l’aide de la DatePart fonction, affiche le trimestre de l’année dans laquelle il se produit.

Dim DateString, Msg As String
Dim ActualDate As Date
' Enter February 12, 2008, or 2/12/2008.
DateString = InputBox("Enter a date:")
ActualDate = CDate(DateString)

' The first two examples use enumeration values for the interval.
Msg = "Quarter: " & DatePart(DateInterval.Quarter, ActualDate)
' The quarter is 1.
MsgBox(Msg)
Msg = "The day of the month: " & DatePart(DateInterval.Day, ActualDate)
' The day of the month is 12.
MsgBox(Msg)

' The next two examples use string values for the interval parameter.
Msg = "The week of the year: " & DatePart("ww", ActualDate)
' The week of the year is 7.
MsgBox(Msg)
Msg = "The day of the week: " & DatePart("w", ActualDate)
' The day of the week is 3 (Tuesday).
MsgBox(Msg)

Remarques

Vous pouvez utiliser la DatePart fonction pour évaluer une valeur de date/heure et retourner un composant spécifique. Par exemple, vous pouvez utiliser DatePart pour calculer le jour de la semaine ou l’heure actuelle.

Si vous choisissez DateInterval.Weekday l’argument Interval , la valeur retournée est cohérente avec les valeurs de l’énumération FirstDayOfWeek . Si vous choisissez DateInterval.WeekOfYear, DatePart utilise les classes et CultureInfo les Calendar classes de l’espace System.Globalization de noms pour déterminer vos paramètres actuels.

L’argument FirstDayOfWeekValue affecte les calculs qui utilisent les paramètres et DateInterval.WeekOfYearInterval les DateInterval.Weekday paramètres. L’argument FirstWeekOfYearValue affecte les calculs qui spécifient DateInterval.WeekOfYear pour Interval.

Étant donné que chaque Date valeur est prise en charge par une DateTime structure, ses méthodes vous offrent des options supplémentaires pour récupérer des parties de date/heure. Par exemple, vous pouvez obtenir la valeur de date entière d’une Date variable, avec la valeur d’heure définie sur minuit, comme suit :

Dim CurrDatTim As Date = Now   ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date   ' At midnight.

L’argument Interval peut avoir l’un des paramètres suivants.

Valeur d’énumération	String	Partie de la valeur de date/heure à retourner
`DateInterval.Day`	d	Jour du mois (1 à 31)
`DateInterval.DayOfYear`	y	Jour de l’année (1 à 366)
`DateInterval.Hour`	h	Heure
`DateInterval.Minute`	n	Minute
`DateInterval.Month`	m	Mois
`DateInterval.Quarter`	q	Trimestre
`DateInterval.Second`	s	Second
`DateInterval.Weekday`	w	Jour de la semaine (1 à 7)
`DateInterval.WeekOfYear`	ss	Semaine de l’année (1 à 53)
`DateInterval.Year`	yyyy	Year

L’argument FirstDayOfWeekValue peut avoir l’un des paramètres suivants.

Valeur d’énumération	Valeur	Description
`FirstDayOfWeek.System`	0	Premier jour de semaine spécifié dans les paramètres système
`FirstDayOfWeek.Sunday`	1	Dimanche (valeur par défaut)
`FirstDayOfWeek.Monday`	2	Lundi (conforme à la norme ISO 8601, section 3.17)
`FirstDayOfWeek.Tuesday`	3	Mardi
`FirstDayOfWeek.Wednesday`	4	Mercredi
`FirstDayOfWeek.Thursday`	5	Jeudi
`FirstDayOfWeek.Friday`	6	Vendredi
`FirstDayOfWeek.Saturday`	7	Samedi

L’argument FirstWeekOfYearValue peut avoir l’un des paramètres suivants.

Valeur d’énumération	Valeur	Description
`FirstWeekOfYear.System`	0	Première semaine de l’année spécifiée dans les paramètres système
`FirstWeekOfYear.Jan1`	1	Semaine dans laquelle se produit le 1er janvier (valeur par défaut)
`FirstWeekOfYear.FirstFourDays`	2	Semaine qui a au moins quatre jours dans la nouvelle année (conforme à la norme ISO 8601, section 3.17)
`FirstWeekOfYear.FirstFullWeek`	3	Première semaine complète en nouvelle année

Voir aussi

S’applique à

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Retourne une valeur contenant le composant spécifié d’une valeur donnée Date .

public static int DatePart(string Interval, object DateValue, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);

static member DatePart : string * obj * Microsoft.VisualBasic.FirstDayOfWeek * Microsoft.VisualBasic.FirstWeekOfYear -> int

Public Function DatePart (Interval As String, DateValue As Object, Optional DayOfWeek As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Optional WeekOfYear As FirstWeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1) As Integer