DateAndTime.DatePart Methode

Quelle:

DateAndTime.vb

Quelle:

DateAndTime.vb

Quelle:

DateAndTime.vb

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

Parameter

Gibt zurück

Ein ganzzahliger Wert, der die angegebene Komponente eines bestimmten Date Werts enthält.

Ausnahmen

Beispiele

In diesem Beispiel wird ein Datum verwendet, und mithilfe der DatePart-Funktion wird das Quartal des Jahres angezeigt, in dem es auftritt.

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)

Hinweise

Sie können die funktion DatePart verwenden, um einen Datums-/Uhrzeitwert auszuwerten und eine bestimmte Komponente zurückzugeben. Sie können z. B. DatePart verwenden, um den Wochentag oder die aktuelle Stunde zu berechnen.

Wenn Sie DateInterval.Weekday für das argument Interval auswählen, entspricht der zurückgegebene Wert den Werten der FirstDayOfWeek Enumeration. Wenn Sie DateInterval.WeekOfYearauswählen, verwendet DatePart die Calendar und CultureInfo Klassen des System.Globalization Namespace, um Ihre aktuellen Einstellungen zu bestimmen.

Das argument FirstDayOfWeekValue wirkt sich auf Berechnungen aus, die die Einstellungen DateInterval.Weekday und DateInterval.WeekOfYearInterval verwenden. Das argument FirstWeekOfYearValue wirkt sich auf Berechnungen aus, die DateInterval.WeekOfYear für Intervalangeben.

Da jeder Date Wert von einer DateTime-Struktur unterstützt wird, bieten Ihnen die Methoden zusätzliche Optionen zum Abrufen von Datums-/Uhrzeitteilen. Sie können z. B. den gesamten Datumswert einer Date Variablen abrufen, wobei der Zeitwert wie folgt auf Mitternacht festgelegt ist:

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

Das argument Interval kann eine der folgenden Einstellungen haben.

Das argument FirstDayOfWeekValue kann eine der folgenden Einstellungen haben.

Das argument FirstWeekOfYearValue kann eine der folgenden Einstellungen haben.

Weitere Informationen

• DateAdd
• DateDiff
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• System
• Zusammenfassung des Datentyps (Visual Basic)

Quelle:

DateAndTime.vb

Quelle:

DateAndTime.vb

Quelle:

DateAndTime.vb

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

Parameter

Gibt zurück

Ein ganzzahliger Wert, der die angegebene Komponente eines bestimmten Date Werts enthält.

Ausnahmen

Beispiele

In diesem Beispiel wird ein Datum verwendet, und mithilfe der DatePart-Funktion wird das Quartal des Jahres angezeigt, in dem es auftritt.

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)

Hinweise

Sie können die funktion DatePart verwenden, um einen Datums-/Uhrzeitwert auszuwerten und eine bestimmte Komponente zurückzugeben. Sie können z. B. DatePart verwenden, um den Wochentag oder die aktuelle Stunde zu berechnen.

Wenn Sie DateInterval.Weekday für das argument Interval auswählen, entspricht der zurückgegebene Wert den Werten der FirstDayOfWeek Enumeration. Wenn Sie DateInterval.WeekOfYearauswählen, verwendet DatePart die Calendar und CultureInfo Klassen des System.Globalization Namespace, um Ihre aktuellen Einstellungen zu bestimmen.

Das argument FirstDayOfWeekValue wirkt sich auf Berechnungen aus, die die Einstellungen DateInterval.Weekday und DateInterval.WeekOfYearInterval verwenden. Das argument FirstWeekOfYearValue wirkt sich auf Berechnungen aus, die DateInterval.WeekOfYear für Intervalangeben.

Da jeder Date Wert von einer DateTime-Struktur unterstützt wird, bieten Ihnen die Methoden zusätzliche Optionen zum Abrufen von Datums-/Uhrzeitteilen. Sie können z. B. den gesamten Datumswert einer Date Variablen abrufen, wobei der Zeitwert wie folgt auf Mitternacht festgelegt ist:

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

Das argument Interval kann eine der folgenden Einstellungen haben.

Das argument FirstDayOfWeekValue kann eine der folgenden Einstellungen haben.

Das argument FirstWeekOfYearValue kann eine der folgenden Einstellungen haben.

Weitere Informationen

• DateAdd
• DateDiff
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• System
• Zusammenfassung des Datentyps (Visual Basic)