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 -> 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
Obligatoire. Valeur d’énumération DateInterval ou expression de chaîne représentant la partie de la valeur de date/heure que vous souhaitez 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. En l'absence de spécification, Sunday est utilisé.
- FirstWeekOfYearValue
- FirstWeekOfYear
Optionnel. 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
Valeur entière contenant le composant spécifié d’une valeur Date
donnée.
Exceptions
Interval
n'est pas valide.
DateValue
ne peut pas être converti en Date
.
Exemples
Cet exemple prend une date et, à l’aide de la DatePart
fonction, affiche le trimestre de l’année au cours duquel elle 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 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 Calendar classes et CultureInfo de l’espace System.Globalization de noms pour déterminer vos paramètres actuels.
L’argument FirstDayOfWeekValue
affecte les calculs qui utilisent les DateInterval.Weekday
paramètres et DateInterval.WeekOfYear
Interval
. 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 les parties 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 date/heure à retourner |
---|---|---|
DateInterval.Day |
d | Jour du mois (1 à 31) |
DateInterval.DayOfYear |
o | Jour de l’année (1 à 366) |
DateInterval.Hour |
h | Heure |
DateInterval.Minute |
n | Minute |
DateInterval.Month |
m | Month |
DateInterval.Quarter |
q | Quarter (Trimestre) |
DateInterval.Second |
s | Seconde |
DateInterval.Weekday |
w | Jour de la semaine (1 à 7) |
DateInterval.WeekOfYear |
ww | Semaine de l’année (1 à 53) |
DateInterval.Year |
aaaa | Year |
L’argument FirstDayOfWeekValue
peut avoir l’un des paramètres suivants.
Valeur d'énumération | Valeur | Description |
---|---|---|
FirstDayOfWeek.System |
0 | Premier jour de la 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 au cours de laquelle le 1er janvier se produit (par défaut) |
FirstWeekOfYear.FirstFourDays |
2 | Semaine ayant 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 de l’année nouvelle |
Voir aussi
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Liste des types 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 -> 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
Paramètres
- Interval
- String
Obligatoire. Valeur d’énumération DateInterval ou expression de chaîne représentant la partie de la valeur de date/heure que vous souhaitez 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. En l'absence de spécification, Sunday est utilisé.
- WeekOfYear
- FirstWeekOfYear
Optionnel. 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
Valeur entière contenant le composant spécifié d’une valeur Date
donnée.
Exceptions
Interval
n'est pas valide.
DateValue
ne peut pas être converti en Date
.
Exemples
Cet exemple prend une date et, à l’aide de la DatePart
fonction, affiche le trimestre de l’année au cours duquel elle 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 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 Calendar classes et CultureInfo de l’espace System.Globalization de noms pour déterminer vos paramètres actuels.
L’argument FirstDayOfWeekValue
affecte les calculs qui utilisent les DateInterval.Weekday
paramètres et DateInterval.WeekOfYear
Interval
. 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 les parties 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 date/heure à retourner |
---|---|---|
DateInterval.Day |
d | Jour du mois (1 à 31) |
DateInterval.DayOfYear |
o | Jour de l’année (1 à 366) |
DateInterval.Hour |
h | Heure |
DateInterval.Minute |
n | Minute |
DateInterval.Month |
m | Month |
DateInterval.Quarter |
q | Quarter (Trimestre) |
DateInterval.Second |
s | Seconde |
DateInterval.Weekday |
w | Jour de la semaine (1 à 7) |
DateInterval.WeekOfYear |
ww | Semaine de l’année (1 à 53) |
DateInterval.Year |
aaaa | Year |
L’argument FirstDayOfWeekValue
peut avoir l’un des paramètres suivants.
Valeur d'énumération | Valeur | Description |
---|---|---|
FirstDayOfWeek.System |
0 | Premier jour de la 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 au cours de laquelle le 1er janvier se produit (par défaut) |
FirstWeekOfYear.FirstFourDays |
2 | Semaine ayant 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 de l’année nouvelle |
Voir aussi
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Liste des types de données (Visual Basic)
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour