Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo DateAndTime.DatePart (String, Object, FirstDayOfWeek, FirstWeekOfYear)

 

Data di pubblicazione: ottobre 2016

Restituisce un Integer contenente il componente specificato di un determinato Date valore.

Spazio dei nomi:   Microsoft.VisualBasic
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

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

Parametri

Interval
Type: System.String

Obbligatorio. DateInterval valore di enumerazione o String espressione che rappresenta la parte del valore data/ora si desidera restituire.

DateValue
Type: System.Object

Obbligatorio. Date valore che si desidera valutare.

DayOfWeek
Type: Microsoft.VisualBasic.FirstDayOfWeek

Parametro facoltativo. Valore scelto dal FirstDayOfWeek enumerazione che specifica il primo giorno della settimana. Se omesso, viene utilizzato FirstDayOfWeek.Sunday.

WeekOfYear
Type: Microsoft.VisualBasic.FirstWeekOfYear

Parametro facoltativo. Valore scelto dal FirstWeekOfYear enumerazione che specifica la prima settimana dell'anno. Se omesso, viene utilizzato FirstWeekOfYear.Jan1.

Valore restituito

Type: System.Int32

Restituisce un Integer contenente il componente specificato di un determinato Date valore.

Exception Condition
ArgumentException

Interval non è valido.

InvalidCastException

DateValue non è assegnato forzatamente al Date.

È possibile utilizzare il DatePart funzione per valutare un valore data/ora e restituire un componente specifico. Ad esempio, è possibile utilizzare DatePart per calcolare il giorno della settimana o l'ora corrente.

Se si sceglie DateInterval.Weekday per il Interval argomento, il valore restituito è coerenza con i valori di FirstDayOfWeek enumerazione. Se si sceglie DateInterval.WeekOfYear, DatePart utilizza il Calendar e CultureInfo classi del System.Globalization dello spazio dei nomi per determinare le impostazioni correnti.

Il FirstDayOfWeekValue argomento influisce sui calcoli che utilizzano il DateInterval.Weekday e DateInterval.WeekOfYear Interval le impostazioni.  Il FirstWeekOfYearValue argomento influisce sui calcoli che specificano DateInterval.WeekOfYear per Interval.

Poiché ogni Date valore è supportato da un DateTime struttura relativi metodi offrono ulteriori opzioni per il recupero di parti di data/ora. Ad esempio, è possibile ottenere il valore di data intero un Date variabile, con il valore di ora impostato sulla mezzanotte, come indicato di seguito:

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

Il Interval argomento può avere una delle seguenti impostazioni.

Valore di enumerazione

String

Parte del valore di data/ora da restituire

DateInterval.Day

g

Giorno del mese (da 1 a 31).

DateInterval.DayOfYear

s

Giorno dell'anno (da 1 a 366).

DateInterval.Hour

h

Hour

DateInterval.Minute

n

Minute

DateInterval.Month

m

Mese

DateInterval.Quarter

q

Trimestre

DateInterval.Second

s

Second

DateInterval.Weekday

w

Giorno della settimana (da 1 a 7).

DateInterval.WeekOfYear

ww

Settimana dell'anno (da 1 a 53).

DateInterval.Year

aaaa

Anno

Il FirstDayOfWeekValue argomento può avere una delle seguenti impostazioni.

Valore di enumerazione

Valore

Descrizione

FirstDayOfWeek.System

0

Primo giorno della settimana specificato nelle impostazioni di sistema

FirstDayOfWeek.Sunday

1

Domenica (predefinito)

FirstDayOfWeek.Monday

2

Lunedì (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

Il FirstWeekOfYearValue argomento può avere una delle seguenti impostazioni.

Valore di enumerazione

Valore

Descrizione

FirstWeekOfYear.System

0

Prima settimana dell'anno specificato nelle impostazioni di sistema

FirstWeekOfYear.Jan1

1

Settimana in cui il 1 ° gennaio (impostazione predefinita)

FirstWeekOfYear.FirstFourDays

2

Settimana che ha almeno quattro giorni nel nuovo anno (conforme allo standard ISO 8601, sezione 3.17)

FirstWeekOfYear.FirstFullWeek

3

Prima settimana completa del nuovo anno

In questo esempio viene specificata una data e l'utilizzo di DatePart di funzione, viene visualizzato 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)

.NET Framework
Disponibile da 1.1
Silverlight
Disponibile da 2.0
Torna all'inizio
Mostra: