DateAndTime.DatePart Methode

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.dll

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

Name	Beschreibung
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)	Gibt einen ganzzahligen Wert zurück, der die angegebene Komponente eines bestimmten `Date` Werts enthält.
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)	Gibt einen Wert zurück, der die angegebene Komponente eines bestimmten `Date` Werts enthält.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

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

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

DateValue: DateTime

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

FirstDayOfWeekValue: FirstDayOfWeek

Dies ist optional. Ein aus der FirstDayOfWeek Aufzählung ausgewählter Wert, der den ersten Wochentag angibt. Wenn dieser nicht angegeben wurde, wird Sunday verwendet.

FirstWeekOfYearValue: FirstWeekOfYear

Dies ist optional. Ein aus der FirstWeekOfYear Aufzählung ausgewählter Wert, der die erste Woche des Jahres angibt. Wenn dieser nicht angegeben wurde, wird Jan1 verwendet.

Gibt zurück

Int32

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

Ausnahmen

ArgumentException

Interval ist ungültig.

InvalidCastException

DateValue ist nicht koercierbar für 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 DatePart Funktion verwenden, um einen Datums-/Uhrzeitwert auszuwerten und eine bestimmte Komponente zurückzugeben. Beispielsweise können DatePart Sie den Wochentag oder die aktuelle Stunde 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 dies auswählen DateInterval.WeekOfYear, DatePart verwenden Sie die Calendar Klassen CultureInfo und Klassen des System.Globalization Namespace, um Ihre aktuellen Einstellungen zu ermitteln.

Das FirstDayOfWeekValue Argument wirkt sich auf Berechnungen aus, die die DateInterval.Weekday Einstellungen DateInterval.WeekOfYearInterval verwenden. Das FirstWeekOfYearValue Argument wirkt sich auf Berechnungen aus, die für DateInterval.WeekOfYearInterval.

Da jeder Date Wert von einer DateTime Struktur unterstützt wird, bieten 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 Interval Argument kann über eine der folgenden Einstellungen verfügen.

Enumerationswert	String	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	Quartal
`DateInterval.Second`	s	Zweites
`DateInterval.Weekday`	w	Wochentag (1 bis 7)
`DateInterval.WeekOfYear`	ww	Woche des Jahres (1 bis 53)
`DateInterval.Year`	yyyy	Jahr

Das FirstDayOfWeekValue Argument kann über eine der folgenden Einstellungen verfügen.

Enumerationswert	Wert	Description
`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	Saturday

Das FirstWeekOfYearValue Argument kann über eine der folgenden Einstellungen verfügen.

Enumerationswert	Wert	Description
`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)

Gibt einen Wert zurück, der die 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);

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