DateAndTime.DatePart Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce un valore intero contenente il componente specificato di un determinato valore Date.
Overload
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Restituisce un valore intero contenente il componente specificato di un determinato valore |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Restituisce un valore contenente il componente specificato di un determinato valore |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- Origine:
- DateAndTime.vb
- Origine:
- DateAndTime.vb
- Origine:
- DateAndTime.vb
Restituisce un valore intero contenente il componente specificato di un determinato valore 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 -> 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 IntegerParametri
- Interval
- DateInterval
Obbligatorio. Valore di enumerazione DateInterval o espressione stringa che rappresenta la parte del valore di data/ora da restituire.
- DateValue
- DateTime
Obbligatorio. Valore Date da valutare.
- FirstDayOfWeekValue
- FirstDayOfWeek
Opzionale. Valore scelto dall'enumerazione FirstDayOfWeek che specifica il primo giorno della settimana. Se non specificato, viene utilizzato Sunday.
- FirstWeekOfYearValue
- FirstWeekOfYear
Opzionale. Valore scelto dall'enumerazione FirstWeekOfYear che specifica la prima settimana dell'anno. Se non specificato, viene utilizzato Jan1.
Restituisce
Valore intero contenente il componente specificato di un determinato valore Date.
Eccezioni
Interval non è valido.
DateValue non è coercibile per Date.
Esempio
Questo esempio accetta una data e, usando la funzione DatePart, visualizza il trimestre dell'anno in cui si verifica.
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 la funzione DatePart per valutare un valore di data/ora e restituire un componente specifico. Ad esempio, è possibile usare DatePart per calcolare il giorno della settimana o l'ora corrente.
Se si sceglie DateInterval.Weekday per l'argomento Interval, il valore restituito è coerente con i valori dell'enumerazione FirstDayOfWeek. Se si sceglie DateInterval.WeekOfYear, DatePart usa le classi Calendar e CultureInfo dello spazio dei nomi System.Globalization per determinare le impostazioni correnti.
L'argomento FirstDayOfWeekValue influisce sui calcoli che usano le impostazioni di DateInterval.Weekday e DateInterval.WeekOfYearInterval. L'argomento FirstWeekOfYearValue influisce sui calcoli che specificano DateInterval.WeekOfYear per Interval.
Poiché ogni valore Date è supportato da una struttura DateTime, i relativi metodi offrono opzioni aggiuntive per il recupero di parti di data/ora. Ad esempio, è possibile ottenere l'intero valore di data di una variabile Date, con il valore di ora impostato su mezzanotte, come indicato di seguito:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
L'argomento Interval può avere una delle impostazioni seguenti.
| Valore di enumerazione | Corda | Parte del valore di data/ora da restituire |
|---|---|---|
DateInterval.Day |
d | Giorno del mese (da 1 a 31) |
DateInterval.DayOfYear |
y | Giorno dell'anno (da 1 a 366) |
DateInterval.Hour |
h | Ora |
DateInterval.Minute |
n | Minuto |
DateInterval.Month |
m | Mese |
DateInterval.Quarter |
q | Quarto |
DateInterval.Second |
s | Secondo |
DateInterval.Weekday |
w | Giorno della settimana (da 1 a 7) |
DateInterval.WeekOfYear |
Ww | Settimana dell'anno (da 1 a 53) |
DateInterval.Year |
yyyy | Anno |
L'argomento FirstDayOfWeekValue può avere una delle impostazioni seguenti.
| Valore di enumerazione | Valore | Descrizione |
|---|---|---|
FirstDayOfWeek.System |
0 | Primo giorno della settimana specificato nelle impostazioni di sistema |
FirstDayOfWeek.Sunday |
1 | Domenica (impostazione predefinita) |
FirstDayOfWeek.Monday |
2 | Monday (conforme allo standard ISO 8601, sezione 3.17) |
FirstDayOfWeek.Tuesday |
3 | Martedì |
FirstDayOfWeek.Wednesday |
4 | Mercoledì |
FirstDayOfWeek.Thursday |
5 | Giovedì |
FirstDayOfWeek.Friday |
6 | Venerdì |
FirstDayOfWeek.Saturday |
7 | Sabato |
L'argomento FirstWeekOfYearValue può avere una delle impostazioni seguenti.
| Valore di enumerazione | Valore | Descrizione |
|---|---|---|
FirstWeekOfYear.System |
0 | Prima settimana dell'anno specificata nelle impostazioni di sistema |
FirstWeekOfYear.Jan1 |
1 | Settimana in cui si verifica il 1° gennaio (impostazione predefinita) |
FirstWeekOfYear.FirstFourDays |
2 | Settimana con almeno quattro giorni nel nuovo anno (conforme allo standard ISO 8601, sezione 3.17) |
FirstWeekOfYear.FirstFullWeek |
3 | Prima settimana intera nel nuovo anno |
Vedi anche
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- riepilogo dei tipi di dati (Visual Basic)
Si applica a
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)
- Origine:
- DateAndTime.vb
- Origine:
- DateAndTime.vb
- Origine:
- DateAndTime.vb
Restituisce un valore contenente il componente specificato di un determinato valore 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);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 IntegerParametri
- Interval
- String
Obbligatorio. Valore di enumerazione DateInterval o espressione stringa che rappresenta la parte del valore di data/ora da restituire.
- DateValue
- Object
Obbligatorio. Valore Date da valutare.
- DayOfWeek
- FirstDayOfWeek
Opzionale. Valore scelto dall'enumerazione FirstDayOfWeek che specifica il primo giorno della settimana. Se non specificato, viene utilizzato Sunday.
- WeekOfYear
- FirstWeekOfYear
Opzionale. Valore scelto dall'enumerazione FirstWeekOfYear che specifica la prima settimana dell'anno. Se non specificato, viene utilizzato Jan1.
Restituisce
Valore intero contenente il componente specificato di un determinato valore Date.
Eccezioni
Interval non è valido.
DateValue non è coercibile per Date.
Esempio
Questo esempio accetta una data e, usando la funzione DatePart, visualizza il trimestre dell'anno in cui si verifica.
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 la funzione DatePart per valutare un valore di data/ora e restituire un componente specifico. Ad esempio, è possibile usare DatePart per calcolare il giorno della settimana o l'ora corrente.
Se si sceglie DateInterval.Weekday per l'argomento Interval, il valore restituito è coerente con i valori dell'enumerazione FirstDayOfWeek. Se si sceglie DateInterval.WeekOfYear, DatePart usa le classi Calendar e CultureInfo dello spazio dei nomi System.Globalization per determinare le impostazioni correnti.
L'argomento FirstDayOfWeekValue influisce sui calcoli che usano le impostazioni di DateInterval.Weekday e DateInterval.WeekOfYearInterval. L'argomento FirstWeekOfYearValue influisce sui calcoli che specificano DateInterval.WeekOfYear per Interval.
Poiché ogni valore Date è supportato da una struttura DateTime, i relativi metodi offrono opzioni aggiuntive per il recupero di parti di data/ora. Ad esempio, è possibile ottenere l'intero valore di data di una variabile Date, con il valore di ora impostato su mezzanotte, come indicato di seguito:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
L'argomento Interval può avere una delle impostazioni seguenti.
| Valore di enumerazione | Corda | Parte del valore di data/ora da restituire |
|---|---|---|
DateInterval.Day |
d | Giorno del mese (da 1 a 31) |
DateInterval.DayOfYear |
y | Giorno dell'anno (da 1 a 366) |
DateInterval.Hour |
h | Ora |
DateInterval.Minute |
n | Minuto |
DateInterval.Month |
m | Mese |
DateInterval.Quarter |
q | Quarto |
DateInterval.Second |
s | Secondo |
DateInterval.Weekday |
w | Giorno della settimana (da 1 a 7) |
DateInterval.WeekOfYear |
Ww | Settimana dell'anno (da 1 a 53) |
DateInterval.Year |
yyyy | Anno |
L'argomento FirstDayOfWeekValue può avere una delle impostazioni seguenti.
| Valore di enumerazione | Valore | Descrizione |
|---|---|---|
FirstDayOfWeek.System |
0 | Primo giorno della settimana specificato nelle impostazioni di sistema |
FirstDayOfWeek.Sunday |
1 | Domenica (impostazione predefinita) |
FirstDayOfWeek.Monday |
2 | Monday (conforme allo standard ISO 8601, sezione 3.17) |
FirstDayOfWeek.Tuesday |
3 | Martedì |
FirstDayOfWeek.Wednesday |
4 | Mercoledì |
FirstDayOfWeek.Thursday |
5 | Giovedì |
FirstDayOfWeek.Friday |
6 | Venerdì |
FirstDayOfWeek.Saturday |
7 | Sabato |
L'argomento FirstWeekOfYearValue può avere una delle impostazioni seguenti.
| Valore di enumerazione | Valore | Descrizione |
|---|---|---|
FirstWeekOfYear.System |
0 | Prima settimana dell'anno specificata nelle impostazioni di sistema |
FirstWeekOfYear.Jan1 |
1 | Settimana in cui si verifica il 1° gennaio (impostazione predefinita) |
FirstWeekOfYear.FirstFourDays |
2 | Settimana con almeno quattro giorni nel nuovo anno (conforme allo standard ISO 8601, sezione 3.17) |
FirstWeekOfYear.FirstFullWeek |
3 | Prima settimana intera nel nuovo anno |
Vedi anche
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- riepilogo dei tipi di dati (Visual Basic)
