DateAndTime.DatePart Méthode
Définition
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 Date donnée.
Surcharges
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Retourne une valeur entière contenant le composant spécifié d’une valeur |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Retourne une valeur contenant le composant spécifié d’une valeur |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
Retourne une valeur entière contenant le composant spécifié d’une valeur Date donnée.
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 -> intPublic 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 IntegerParamètres
- Interval
- DateInterval
Obligatoire. Valeur d’énumération DateInterval ou expression de chaîne représentant la partie de la valeur de date/heure à retourner.
- DateValue
- DateTime
Obligatoire. Valeur Date que vous souhaitez évaluer.
- FirstDayOfWeekValue
- FirstDayOfWeek
Optionnel. Valeur choisie dans l’énumération FirstDayOfWeek qui spécifie le premier jour de la semaine. S’il n’est pas spécifié, Sunday est utilisé.
- FirstWeekOfYearValue
- FirstWeekOfYear
Optionnel. Valeur choisie dans l’énumération FirstWeekOfYear qui spécifie la première semaine de l’année. S’il n’est pas spécifié, Jan1 est utilisé.
Retours
Valeur entière contenant le composant spécifié d’une valeur Date donnée.
Exceptions
Interval n’est pas valide.
DateValue n’est pas coercible pour Date.
Exemples
Cet exemple prend une date et, à l’aide de la fonction DatePart, 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 fonction DatePart 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 pour 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 Calendar et CultureInfo de l’espace de noms System.Globalization pour déterminer vos paramètres actuels.
L’argument FirstDayOfWeekValue affecte les calculs qui utilisent les paramètres DateInterval.Weekday et DateInterval.WeekOfYearInterval. L’argument FirstWeekOfYearValue affecte les calculs qui spécifient DateInterval.WeekOfYear pour Interval.
Étant donné que chaque valeur de Date est prise en charge par une structure DateTime, 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 variable Date, 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 | Corde | 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 | Quartier |
DateInterval.Second |
s | Deuxième |
DateInterval.Weekday |
w | Jour de la semaine (1 à 7) |
DateInterval.WeekOfYear |
Ww | Semaine de l’année (1 à 53) |
DateInterval.Year |
aaaa | Année |
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
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- résumé du type de données (Visual Basic)
S’applique à
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
Retourne une valeur contenant le composant spécifié d’une valeur Date donnée.
public static int DatePart (string Interval, object? DateValue, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);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 -> intPublic 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 IntegerParamètres
- Interval
- String
Obligatoire. Valeur d’énumération DateInterval ou expression de chaîne représentant la partie de la valeur de date/heure à retourner.
- DateValue
- Object
Obligatoire. Valeur Date que vous souhaitez évaluer.
- DayOfWeek
- FirstDayOfWeek
Optionnel. Valeur choisie dans l’énumération FirstDayOfWeek qui spécifie le premier jour de la semaine. S’il n’est pas spécifié, Sunday est utilisé.
- WeekOfYear
- FirstWeekOfYear
Optionnel. Valeur choisie dans l’énumération FirstWeekOfYear qui spécifie la première semaine de l’année. S’il n’est pas spécifié, Jan1 est utilisé.
Retours
Valeur entière contenant le composant spécifié d’une valeur Date donnée.
Exceptions
Interval n’est pas valide.
DateValue n’est pas coercible pour Date.
Exemples
Cet exemple prend une date et, à l’aide de la fonction DatePart, 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 fonction DatePart 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 pour 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 Calendar et CultureInfo de l’espace de noms System.Globalization pour déterminer vos paramètres actuels.
L’argument FirstDayOfWeekValue affecte les calculs qui utilisent les paramètres DateInterval.Weekday et DateInterval.WeekOfYearInterval. L’argument FirstWeekOfYearValue affecte les calculs qui spécifient DateInterval.WeekOfYear pour Interval.
Étant donné que chaque valeur de Date est prise en charge par une structure DateTime, 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 variable Date, 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 | Corde | 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 | Quartier |
DateInterval.Second |
s | Deuxième |
DateInterval.Weekday |
w | Jour de la semaine (1 à 7) |
DateInterval.WeekOfYear |
Ww | Semaine de l’année (1 à 53) |
DateInterval.Year |
aaaa | Année |
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
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- résumé du type de données (Visual Basic)
