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 bestimmten Date-Werts enthält.
Überlädt
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Gibt einen ganzzahligen Wert zurück, der die angegebene Komponente eines bestimmten |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Gibt einen Wert zurück, der eine angegebene Komponente eines bestimmten |
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 bestimmten 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 Datums-/Zeitwerts darstellt, der zurückgegeben werden soll.
- DateValue
- DateTime
Erforderlich. Der auszuwertende Date-Wert.
- FirstDayOfWeekValue
- FirstDayOfWeek
Dies ist optional. Ein Wert aus der FirstDayOfWeek-Enumeration, der den ersten Tag der Woche angibt. Wenn dieser nicht angegeben wurde, wird Sunday verwendet.
- FirstWeekOfYearValue
- FirstWeekOfYear
Dies ist optional. Ein Wert aus der FirstWeekOfYear-Enumeration, der die erste Woche des Jahres angibt. Wenn dieser nicht angegeben wurde, wird Jan1 verwendet.
Gibt zurück
Ein ganzzahliger Wert, der eine angegebene Komponente eines bestimmten Date-Werts enthält.
Ausnahmen
Interval ist nicht gültig.
DateValue kann nicht in Date umgewandelt werden.
Beispiele
In diesem Beispiel wird ein Datum verwendet und mithilfe der DatePart -Funktion 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 DatePart Funktion verwenden, um einen Datums-/Uhrzeitwert auszuwerten und eine bestimmte Komponente zurückzugeben. Sie können DatePart beispielsweise verwenden, um den Wochentag oder die aktuelle Stunde zu berechnen.
Wenn Sie das Interval Argument auswählenDateInterval.Weekday, ist der zurückgegebene Wert mit den Werten der FirstDayOfWeek Enumeration konsistent. Wenn Sie auswählen DateInterval.WeekOfYear, DatePart verwenden Sie die Calendar Klassen und CultureInfo des System.Globalization Namespaces, um Ihre aktuellen Einstellungen zu bestimmen.
Das FirstDayOfWeekValue Argument wirkt sich auf Berechnungen aus, die die DateInterval.Weekday Einstellungen und DateInterval.WeekOfYearInterval verwenden. Das FirstWeekOfYearValue Argument wirkt sich auf Berechnungen aus, die für IntervalangebenDateInterval.WeekOfYear.
Da jeder Date Wert von einer DateTime Struktur unterstützt wird, bieten die zugehörigen Methoden zusätzliche Optionen zum Abrufen von Datums-/Uhrzeitteilen. Sie können z. B. den gesamten Datumswert einer Date Variablen abrufen, wobei der Zeitwert auf Mitternacht festgelegt ist, wie folgt:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Das Interval Argument kann über eine der folgenden Einstellungen verfügen.
| Enumerationswert | String | Zurückzugebende Teil des Zurückzugebenden Datums-/Uhrzeitwerts |
|---|---|---|
DateInterval.Day |
T | Tag des Monats (1 bis 31) |
DateInterval.DayOfYear |
j | Tag des Jahres (1 bis 366) |
DateInterval.Hour |
h | Stunde |
DateInterval.Minute |
n | Minute |
DateInterval.Month |
m | Month (Monat) |
DateInterval.Quarter |
q | Quarter |
DateInterval.Second |
s | Second |
DateInterval.Weekday |
w | Tag der Woche (1 bis 7) |
DateInterval.WeekOfYear |
ww | Woche des Jahres (1 bis 53) |
DateInterval.Year |
yyyy | Year |
Das FirstDayOfWeekValue Argument kann über eine der folgenden Einstellungen verfügen.
| Enumerationswert | Wert | BESCHREIBUNG |
|---|---|---|
FirstDayOfWeek.System |
0 | Erster Wochentag, der in den Systemeinstellungen angegeben ist |
FirstDayOfWeek.Sunday |
1 | Sonntag (Standard) |
FirstDayOfWeek.Monday |
2 | Montag (entspricht ISO-Norm 8601, Abschnitt 3.17) |
FirstDayOfWeek.Tuesday |
3 | Tuesday |
FirstDayOfWeek.Wednesday |
4 | Wednesday |
FirstDayOfWeek.Thursday |
5 | Thursday |
FirstDayOfWeek.Friday |
6 | Freitag |
FirstDayOfWeek.Saturday |
7 | Samstag |
Das FirstWeekOfYearValue Argument kann über eine der folgenden Einstellungen verfügen.
| 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 auftritt (Standard) |
FirstWeekOfYear.FirstFourDays |
2 | Woche mit mindestens vier Tagen im neuen Jahr (entspricht ISO-Norm 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
- Datentyp: Zusammenfassung (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 eine angegebene Komponente eines bestimmten 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 Datums-/Zeitwerts darstellt, der zurückgegeben werden soll.
- DateValue
- Object
Erforderlich. Ein auszuwertender Date-Wert.
- DayOfWeek
- FirstDayOfWeek
Dies ist optional. Ein Wert aus der FirstDayOfWeek-Enumeration, der den ersten Tag der Woche angibt. Wenn dieser nicht angegeben wurde, wird Sunday verwendet.
- WeekOfYear
- FirstWeekOfYear
Dies ist optional. Ein Wert aus der FirstWeekOfYear-Enumeration, der die erste Woche des Jahres angibt. Wenn dieser nicht angegeben wurde, wird Jan1 verwendet.
Gibt zurück
Ein ganzzahliger Wert, der eine angegebene Komponente eines bestimmten Date-Werts enthält.
Ausnahmen
Interval ist ungültig.
DateValue kann nicht in Date umgewandelt werden.
Beispiele
In diesem Beispiel wird ein Datum verwendet und mithilfe der DatePart -Funktion 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 DatePart -Funktion verwenden, um einen Datums-/Uhrzeitwert auszuwerten und eine bestimmte Komponente zurückzugeben. Sie können beispielsweise verwenden DatePart , um den Wochentag oder die aktuelle Stunde zu berechnen.
Wenn Sie für das Interval Argument auswählenDateInterval.Weekday, ist der zurückgegebene Wert mit den Werten der FirstDayOfWeek Enumeration konsistent. Wenn Sie auswählen DateInterval.WeekOfYear, DatePart verwendet die Calendar Klassen und CultureInfo des System.Globalization Namespaces, um Ihre aktuellen Einstellungen zu bestimmen.
Das FirstDayOfWeekValue Argument wirkt sich auf Berechnungen aus, die die DateInterval.Weekday Einstellungen und DateInterval.WeekOfYearInterval verwenden. Das FirstWeekOfYearValue Argument wirkt sich auf Berechnungen aus, die für IntervalangebenDateInterval.WeekOfYear.
Da jeder Date Wert von einer DateTime -Struktur unterstützt wird, bieten die zugehörigen Methoden zusätzliche Optionen zum Abrufen von Datums-/Uhrzeitteilen. Beispielsweise können Sie den gesamten Datumswert einer Date Variablen abrufen, wobei der Zeitwert auf Mitternacht festgelegt ist, wie folgt:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Das Interval Argument kann über eine der folgenden Einstellungen verfügen.
| Enumerationswert | String | Zurückzugebende Teil des Zurückzugebenden Datums-/Uhrzeitwerts |
|---|---|---|
DateInterval.Day |
T | Tag des Monats (1 bis 31) |
DateInterval.DayOfYear |
j | Tag des Jahres (1 bis 366) |
DateInterval.Hour |
h | Stunde |
DateInterval.Minute |
n | Minute |
DateInterval.Month |
m | Month (Monat) |
DateInterval.Quarter |
q | Quarter |
DateInterval.Second |
s | Second |
DateInterval.Weekday |
w | Tag der Woche (1 bis 7) |
DateInterval.WeekOfYear |
ww | Woche des Jahres (1 bis 53) |
DateInterval.Year |
yyyy | Year |
Das FirstDayOfWeekValue Argument kann über eine der folgenden Einstellungen verfügen.
| Enumerationswert | Wert | BESCHREIBUNG |
|---|---|---|
FirstDayOfWeek.System |
0 | Erster Wochentag, der in den Systemeinstellungen angegeben ist |
FirstDayOfWeek.Sunday |
1 | Sonntag (Standard) |
FirstDayOfWeek.Monday |
2 | Montag (entspricht ISO-Norm 8601, Abschnitt 3.17) |
FirstDayOfWeek.Tuesday |
3 | Tuesday |
FirstDayOfWeek.Wednesday |
4 | Wednesday |
FirstDayOfWeek.Thursday |
5 | Thursday |
FirstDayOfWeek.Friday |
6 | Freitag |
FirstDayOfWeek.Saturday |
7 | Samstag |
Das FirstWeekOfYearValue Argument kann über eine der folgenden Einstellungen verfügen.
| 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 auftritt (Standard) |
FirstWeekOfYear.FirstFourDays |
2 | Woche mit mindestens vier Tagen im neuen Jahr (entspricht ISO-Norm 8601, Abschnitt 3.17) |
FirstWeekOfYear.FirstFullWeek |
3 | Erste vollständige Woche im neuen Jahr |
Weitere Informationen
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Datentyp: Zusammenfassung (Visual Basic)
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für