DateAndTime.DatePart DateAndTime.DatePart DateAndTime.DatePart Method

Definizione

Restituisce un intero contenente il componente specificato di un determinato valore Date.Returns an integer value containing the specified component of a given Date value.

Overload

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Restituisce un intero contenente il componente specificato di un determinato valore Date.Returns an integer value containing the specified component of a given Date value.

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Restituisce un valore contenente il componente specificato di un determinato valore Date.Returns an value containing the specified component of a given Date value.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Restituisce un intero contenente il componente specificato di un determinato valore Date.Returns an integer value containing the specified component of a given Date value.

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

Parametri

Interval
DateInterval DateInterval DateInterval

Obbligatorio.Required. Valore dell'enumerazione DateInterval o espressione String che rappresenta la parte del valore di data/ora da restituire.A DateInterval enumeration value or a string expression representing the part of the date/time value you want to return.

DateValue
DateTime DateTime DateTime

Obbligatorio.Required. Valore Date da valutare.The Date value that you want to evaluate.

FirstDayOfWeekValue
FirstDayOfWeek FirstDayOfWeek FirstDayOfWeek

Opzionale.Optional. Valore scelto dall'enumerazione FirstDayOfWeek che specifica il primo giorno della settimana.A value chosen from the FirstDayOfWeek enumeration that specifies the first day of the week. Se omesso, viene utilizzato Sunday.If not specified, Sunday is used.

FirstWeekOfYearValue
FirstWeekOfYear FirstWeekOfYear FirstWeekOfYear

Opzionale.Optional. Valore scelto dall'enumerazione FirstWeekOfYear che specifica il primo giorno dell'anno.A value chosen from the FirstWeekOfYear enumeration that specifies the first week of the year. Se omesso, viene utilizzato Jan1.If not specified, Jan1 is used.

Restituisce

Intero contenente il componente specificato di un determinato valore Date.An integer value containing the specified component of a given Date value.

Eccezioni

Interval non è valido.Interval is not valid.

DateValue non può essere assegnato forzatamente a un valore Date.DateValue is not coercible to Date.

Esempi

L'esempio seguente accetta una data e, utilizzando il DatePart di funzione, viene visualizzato il trimestre dell'anno in cui si verifica.This example takes a date and, using the DatePart function, displays the quarter of the year in which it occurs.

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)

Commenti

È possibile usare il DatePart funzione da valutare un valore data/ora e restituire un componente specifico.You can use the DatePart function to evaluate a date/time value and return a specific component. Ad esempio, potrebbe usare DatePart per calcolare il giorno della settimana o l'ora corrente.For example, you might use DatePart to calculate the day of the week or the current hour.

Se si sceglie DateInterval.Weekday per il Interval argomento, il valore restituito è coerenza con i valori del FirstDayOfWeek enumerazione.If you choose DateInterval.Weekday for the Interval argument, the returned value is consistent with the values of the FirstDayOfWeek enumeration. Se si sceglie DateInterval.WeekOfYear, DatePart Usa le Calendar e CultureInfo classi del System.Globalization dello spazio dei nomi per determinare le impostazioni correnti.If you choose DateInterval.WeekOfYear, DatePart uses the Calendar and CultureInfo classes of the System.Globalization namespace to determine your current settings.

Il FirstDayOfWeekValue argomento influisce sui calcoli che utilizzano il DateInterval.Weekday e DateInterval.WeekOfYear Interval impostazioni.The FirstDayOfWeekValue argument affects calculations that use the DateInterval.Weekday and DateInterval.WeekOfYear Interval settings. Il FirstWeekOfYearValue argomento influisce sui calcoli che specificano DateInterval.WeekOfYear per Interval.The FirstWeekOfYearValue argument affects calculations that specify DateInterval.WeekOfYear for Interval.

Poiché ogni Date valore è supportato da un DateTime struttura, i relativi metodi offrono ulteriori opzioni per il recupero di parti di data/ora.Since every Date value is supported by a DateTime structure, its methods give you additional options in retrieving date/time parts. Ad esempio, è possibile ottenere l'intero valore della data una Date variabile, con il valore di ora impostate su mezzanotte, come indicato di seguito:For example, you can obtain the entire date value of a Date variable, with the time value set to midnight, as follows:

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

Il Interval argomento può avere uno delle seguenti impostazioni.The Interval argument can have one of the following settings.

Valore di enumerazioneEnumeration value StringaString Parte del valore di data/ora da restituirePart of date/time value to return
DateInterval.Day dd Giorno del mese (da 1 a 31).Day of month (1 through 31)
DateInterval.DayOfYear yy Giorno dell'anno (da 1 a 366).Day of year (1 through 366)
DateInterval.Hour hh HourHour
DateInterval.Minute nn MinuteMinute
DateInterval.Month mm MeseMonth
DateInterval.Quarter qq TrimestreQuarter
DateInterval.Second ss SecondSecond
DateInterval.Weekday ww Giorno della settimana (da 1 a 7).Day of week (1 through 7)
DateInterval.WeekOfYear wwww Settimana dell'anno (da 1 a 53).Week of year (1 through 53)
DateInterval.Year aaaayyyy AnnoYear

Il FirstDayOfWeekValue argomento può avere uno delle seguenti impostazioni.The FirstDayOfWeekValue argument can have one of the following settings.

Valore di enumerazioneEnumeration value ValueValue DescrizioneDescription
FirstDayOfWeek.System 00 Primo giorno della settimana specificato nelle impostazioni di sistemaFirst day of week specified in system settings
FirstDayOfWeek.Sunday 11 Domenica (predefinito)Sunday (default)
FirstDayOfWeek.Monday 22 Lunedì (conforme allo standard ISO 8601, 3.17 sezione)Monday (complies with ISO standard 8601, section 3.17)
FirstDayOfWeek.Tuesday 33 MartedìTuesday
FirstDayOfWeek.Wednesday 44 MercoledìWednesday
FirstDayOfWeek.Thursday 55 GiovedìThursday
FirstDayOfWeek.Friday 66 VenerdìFriday
FirstDayOfWeek.Saturday 77 SaturdaySaturday

Il FirstWeekOfYearValue argomento può avere uno delle seguenti impostazioni.The FirstWeekOfYearValue argument can have one of the following settings.

Valore di enumerazioneEnumeration value ValueValue DescrizioneDescription
FirstWeekOfYear.System 00 Prima settimana dell'anno specificato nelle impostazioni di sistemaFirst week of year specified in system settings
FirstWeekOfYear.Jan1 11 Settimana in cui è presente 1 gennaio (impostazione predefinita)Week in which January 1 occurs (default)
FirstWeekOfYear.FirstFourDays 22 Settimana in cui il nuovo anno (conforme allo standard ISO 8601, sezione 3.17) include almeno quattro giorniWeek that has at least four days in the new year (complies with ISO standard 8601, section 3.17)
FirstWeekOfYear.FirstFullWeek 33 Prima settimana completa nel nuovo annoFirst full week in new year
Vedi anche

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Restituisce un valore contenente il componente specificato di un determinato valore Date.Returns an value containing the specified component of a given Date value.

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

Parametri

Interval
String String String

Obbligatorio.Required. Valore dell'enumerazione DateInterval o espressione String che rappresenta la parte del valore di data/ora da restituire.A DateInterval enumeration value or a string expression representing the part of the date/time value you want to return.

DateValue
Object Object Object

Obbligatorio.Required. Valore Date da valutare.A Date value that you want to evaluate.

DayOfWeek
FirstDayOfWeek FirstDayOfWeek FirstDayOfWeek

Opzionale.Optional. Valore scelto dall'enumerazione FirstDayOfWeek che specifica il primo giorno della settimana.A value chosen from the FirstDayOfWeek enumeration that specifies the first day of the week. Se omesso, viene utilizzato Sunday.If not specified, Sunday is used.

WeekOfYear
FirstWeekOfYear FirstWeekOfYear FirstWeekOfYear

Opzionale.Optional. Valore scelto dall'enumerazione FirstWeekOfYear che specifica il primo giorno dell'anno.A value chosen from the FirstWeekOfYear enumeration that specifies the first week of the year. Se omesso, viene utilizzato Jan1.If not specified, Jan1 is used.

Restituisce

Intero contenente il componente specificato di un determinato valore Date.An integer value containing the specified component of a given Date value.

Eccezioni

Interval non è valido.Interval is invalid.

DateValue non può essere assegnato forzatamente a un valore Date.DateValue is not coercible to Date.

Esempi

L'esempio seguente accetta una data e, utilizzando il DatePart di funzione, viene visualizzato il trimestre dell'anno in cui si verifica.This example takes a date and, using the DatePart function, displays the quarter of the year in which it occurs.

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)

Commenti

È possibile usare il DatePart funzione da valutare un valore data/ora e restituire un componente specifico.You can use the DatePart function to evaluate a date/time value and return a specific component. Ad esempio, potrebbe usare DatePart per calcolare il giorno della settimana o l'ora corrente.For example, you might use DatePart to calculate the day of the week or the current hour.

Se si sceglie DateInterval.Weekday per il Interval argomento, il valore restituito è coerenza con i valori del FirstDayOfWeek enumerazione.If you choose DateInterval.Weekday for the Interval argument, the returned value is consistent with the values of the FirstDayOfWeek enumeration. Se si sceglie DateInterval.WeekOfYear, DatePart Usa le Calendar e CultureInfo classi del System.Globalization dello spazio dei nomi per determinare le impostazioni correnti.If you choose DateInterval.WeekOfYear, DatePart uses the Calendar and CultureInfo classes of the System.Globalization namespace to determine your current settings.

Il FirstDayOfWeekValue argomento influisce sui calcoli che utilizzano il DateInterval.Weekday e DateInterval.WeekOfYear Interval impostazioni.The FirstDayOfWeekValue argument affects calculations that use the DateInterval.Weekday and DateInterval.WeekOfYear Interval settings. Il FirstWeekOfYearValue argomento influisce sui calcoli che specificano DateInterval.WeekOfYear per Interval.The FirstWeekOfYearValue argument affects calculations that specify DateInterval.WeekOfYear for Interval.

Poiché ogni Date valore è supportato da un DateTime struttura, i relativi metodi offrono ulteriori opzioni per il recupero di parti di data/ora.Since every Date value is supported by a DateTime structure, its methods give you additional options in retrieving date/time parts. Ad esempio, è possibile ottenere l'intero valore della data una Date variabile, con il valore di ora impostate su mezzanotte, come indicato di seguito:For example, you can obtain the entire date value of a Date variable, with the time value set to midnight, as follows:

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

Il Interval argomento può avere uno delle seguenti impostazioni.The Interval argument can have one of the following settings.

Valore di enumerazioneEnumeration value StringaString Parte del valore di data/ora da restituirePart of date/time value to return
DateInterval.Day dd Giorno del mese (da 1 a 31).Day of month (1 through 31)
DateInterval.DayOfYear yy Giorno dell'anno (da 1 a 366).Day of year (1 through 366)
DateInterval.Hour hh HourHour
DateInterval.Minute nn MinuteMinute
DateInterval.Month mm MeseMonth
DateInterval.Quarter qq TrimestreQuarter
DateInterval.Second ss SecondSecond
DateInterval.Weekday ww Giorno della settimana (da 1 a 7).Day of week (1 through 7)
DateInterval.WeekOfYear wwww Settimana dell'anno (da 1 a 53).Week of year (1 through 53)
DateInterval.Year aaaayyyy AnnoYear

Il FirstDayOfWeekValue argomento può avere uno delle seguenti impostazioni.The FirstDayOfWeekValue argument can have one of the following settings.

Valore di enumerazioneEnumeration value ValueValue DescrizioneDescription
FirstDayOfWeek.System 00 Primo giorno della settimana specificato nelle impostazioni di sistemaFirst day of week specified in system settings
FirstDayOfWeek.Sunday 11 Domenica (predefinito)Sunday (default)
FirstDayOfWeek.Monday 22 Lunedì (conforme allo standard ISO 8601, 3.17 sezione)Monday (complies with ISO standard 8601, section 3.17)
FirstDayOfWeek.Tuesday 33 MartedìTuesday
FirstDayOfWeek.Wednesday 44 MercoledìWednesday
FirstDayOfWeek.Thursday 55 GiovedìThursday
FirstDayOfWeek.Friday 66 VenerdìFriday
FirstDayOfWeek.Saturday 77 SaturdaySaturday

Il FirstWeekOfYearValue argomento può avere uno delle seguenti impostazioni.The FirstWeekOfYearValue argument can have one of the following settings.

Valore di enumerazioneEnumeration value ValueValue DescrizioneDescription
FirstWeekOfYear.System 00 Prima settimana dell'anno specificato nelle impostazioni di sistemaFirst week of year specified in system settings
FirstWeekOfYear.Jan1 11 Settimana in cui è presente 1 gennaio (impostazione predefinita)Week in which January 1 occurs (default)
FirstWeekOfYear.FirstFourDays 22 Settimana in cui il nuovo anno (conforme allo standard ISO 8601, sezione 3.17) include almeno quattro giorniWeek that has at least four days in the new year (complies with ISO standard 8601, section 3.17)
FirstWeekOfYear.FirstFullWeek 33 Prima settimana completa nel nuovo annoFirst full week in new year
Vedi anche

Si applica a