DateAndTime.DatePart Methode

Definition

Gibt einen ganzzahligen Wert zurück, der die angegebene Komponente eines angegebenen Date Werts enthält.

Überlädt

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Gibt einen ganzzahligen Wert zurück, der die angegebene Komponente eines angegebenen Date Werts enthält.

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Gibt einen Wert zurück, der die angegebene Komponente eines angegebenen Date Werts enthält.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Quelle:
DateAndTime.vb
Quelle:
DateAndTime.vb
Quelle:
DateAndTime.vb

Gibt einen ganzzahligen Wert zurück, der die angegebene Komponente eines angegebenen Date Werts enthält.

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

Interval
DateInterval

Erforderlich. Ein DateInterval Enumerationswert oder ein Zeichenfolgenausdruck, der den Teil des Zurückzugebenden Datums-/Uhrzeitwerts darstellt.

DateValue
DateTime

Erforderlich. Der Date Wert, den Sie auswerten möchten.

FirstDayOfWeekValue
FirstDayOfWeek

Wahlfrei. Ein wert, der aus der FirstDayOfWeek-Aufzählung ausgewählt wird, die den ersten Tag der Woche angibt. Wenn nicht angegeben, wird Sunday verwendet.

FirstWeekOfYearValue
FirstWeekOfYear

Wahlfrei. Ein Wert, der aus der FirstWeekOfYear-Aufzählung ausgewählt wird, die die erste Woche des Jahres angibt. Wenn nicht angegeben, wird Jan1 verwendet.

Gibt zurück

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

Ausnahmen

Interval ist ungültig.

DateValue kann nicht Date.

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.

Enumerationswert Schnur Teil des zurückzugebenden Datums-/Uhrzeitwerts
DateInterval.Day d Monatstag (1 bis 31)
DateInterval.DayOfYear y Tag des Jahres (1 bis 366)
DateInterval.Hour h Stunde
DateInterval.Minute n Minute
DateInterval.Month m Monat
DateInterval.Quarter q Viertel
DateInterval.Second s Sekunde
DateInterval.Weekday w Wochentag (1 bis 7)
DateInterval.WeekOfYear Ww Woche des Jahres (1 bis 53)
DateInterval.Year yyyy Jahr

Das argument FirstDayOfWeekValue kann eine der folgenden Einstellungen haben.

Enumerationswert Wert Beschreibung
FirstDayOfWeek.System 0 Erster Wochentag, der in den Systemeinstellungen angegeben ist
FirstDayOfWeek.Sunday 1 Sonntag (Standard)
FirstDayOfWeek.Monday 2 Montag (entspricht dem ISO-Standard 8601, Abschnitt 3.17)
FirstDayOfWeek.Tuesday 3 Dienstag
FirstDayOfWeek.Wednesday 4 Mittwoch
FirstDayOfWeek.Thursday 5 Donnerstag
FirstDayOfWeek.Friday 6 Freitag
FirstDayOfWeek.Saturday 7 Samstag

Das argument FirstWeekOfYearValue kann eine der folgenden Einstellungen haben.

Enumerationswert Wert Beschreibung
FirstWeekOfYear.System 0 Erste Woche des Jahres, die in den Systemeinstellungen angegeben ist
FirstWeekOfYear.Jan1 1 Woche, in der der 1. Januar eintritt (Standard)
FirstWeekOfYear.FirstFourDays 2 Woche mit mindestens vier Tagen im neuen Jahr (entspricht dem ISO-Standard 8601, Abschnitt 3.17)
FirstWeekOfYear.FirstFullWeek 3 Erste volle Woche im neuen Jahr

Weitere Informationen

Gilt für:

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Quelle:
DateAndTime.vb
Quelle:
DateAndTime.vb
Quelle:
DateAndTime.vb

Gibt einen Wert zurück, der die angegebene Komponente eines angegebenen Date Werts enthält.

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

Interval
String

Erforderlich. Ein DateInterval Enumerationswert oder ein Zeichenfolgenausdruck, der den Teil des Zurückzugebenden Datums-/Uhrzeitwerts darstellt.

DateValue
Object

Erforderlich. Ein Date Wert, den Sie auswerten möchten.

DayOfWeek
FirstDayOfWeek

Wahlfrei. Ein wert, der aus der FirstDayOfWeek-Aufzählung ausgewählt wird, die den ersten Tag der Woche angibt. Wenn nicht angegeben, wird Sunday verwendet.

WeekOfYear
FirstWeekOfYear

Wahlfrei. Ein Wert, der aus der FirstWeekOfYear-Aufzählung ausgewählt wird, die die erste Woche des Jahres angibt. Wenn nicht angegeben, wird Jan1 verwendet.

Gibt zurück

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

Ausnahmen

Interval ist ungültig.

DateValue kann nicht Date.

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.

Enumerationswert Schnur Teil des zurückzugebenden Datums-/Uhrzeitwerts
DateInterval.Day d Monatstag (1 bis 31)
DateInterval.DayOfYear y Tag des Jahres (1 bis 366)
DateInterval.Hour h Stunde
DateInterval.Minute n Minute
DateInterval.Month m Monat
DateInterval.Quarter q Viertel
DateInterval.Second s Sekunde
DateInterval.Weekday w Wochentag (1 bis 7)
DateInterval.WeekOfYear Ww Woche des Jahres (1 bis 53)
DateInterval.Year yyyy Jahr

Das argument FirstDayOfWeekValue kann eine der folgenden Einstellungen haben.

Enumerationswert Wert Beschreibung
FirstDayOfWeek.System 0 Erster Wochentag, der in den Systemeinstellungen angegeben ist
FirstDayOfWeek.Sunday 1 Sonntag (Standard)
FirstDayOfWeek.Monday 2 Montag (entspricht dem ISO-Standard 8601, Abschnitt 3.17)
FirstDayOfWeek.Tuesday 3 Dienstag
FirstDayOfWeek.Wednesday 4 Mittwoch
FirstDayOfWeek.Thursday 5 Donnerstag
FirstDayOfWeek.Friday 6 Freitag
FirstDayOfWeek.Saturday 7 Samstag

Das argument FirstWeekOfYearValue kann eine der folgenden Einstellungen haben.

Enumerationswert Wert Beschreibung
FirstWeekOfYear.System 0 Erste Woche des Jahres, die in den Systemeinstellungen angegeben ist
FirstWeekOfYear.Jan1 1 Woche, in der der 1. Januar eintritt (Standard)
FirstWeekOfYear.FirstFourDays 2 Woche mit mindestens vier Tagen im neuen Jahr (entspricht dem ISO-Standard 8601, Abschnitt 3.17)
FirstWeekOfYear.FirstFullWeek 3 Erste volle Woche im neuen Jahr

Weitere Informationen

Gilt für: