DateAndTime.DatePart Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Gibt einen Wert zurück, der die angegebene Komponente eines angegebenen |
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 -> 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 IntegerParameter
- 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
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Zusammenfassung des Datentyps (Visual Basic)
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 -> 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 IntegerParameter
- 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
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Zusammenfassung des Datentyps (Visual Basic)
