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 -> 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 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.WeekOfYear
Interval
verwenden. Das FirstWeekOfYearValue
Argument wirkt sich auf Berechnungen aus, die für Interval
angebenDateInterval.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 -> 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 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.WeekOfYear
Interval
verwenden. Das FirstWeekOfYearValue
Argument wirkt sich auf Berechnungen aus, die für Interval
angebenDateInterval.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
https://aka.ms/ContentUserFeedback.
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 unterFeedback senden und anzeigen für