Share via


DatePart-Funktion

Warnung

Bei der Verwendung dieser Funktion liegt ein Problem vor. Der letzte Montag in einigen Kalenderjahren kann als Woche 53 zurückgegeben werden, wenn es Woche 1 sein sollte. Weitere Informationen und eine Problemumgehung finden Sie unter Format oder DatePart-Funktionen können eine falsche Wochennummer für den letzten Montag im Jahr zurückgeben. Gibt eine Variant (ganze Zahl) zurück, die den angegebenen Teil eines bestimmten Datums enthält.

Syntax

DatePart(interval, date, [ firstdayofweek, [ firstweekofyear ]])

Die Syntax der DatePart-Funktion verfügt über die folgenden benannten Argumente:

Teil Beschreibung
Intervall Erforderlich. Zeichenfolgenausdruck, bei dem es sich um das Zeitintervall handelt, das zurückgegeben werden soll.
date Erforderlich. Variant (Date) Wert, den Sie auswerten möchten.
firstdayofweek Optional. Eine Konstante, die den ersten Tag der Woche angibt. Falls nicht angegeben, wird Sonntag angenommen.
firstweekofyear Optional. Eine Konstante, die die erste Woche des Jahres angibt. Wenn nicht angegeben, wird angenommen, dass die erste Woche die Woche um den 1. Januar ist.

Einstellungen

Das Interval-Argument verfügt über die folgenden Einstellungen:

Einstellung Beschreibung
yyyy Jahr
q Quartal
m Monat
y Tag des Jahres
d Tag
w Wochentag
ww Woche
h Stunde
n Minute
s Zweiter

Das Argument firstdayofweek hat die folgenden Einstellungen:

Konstante Wert Beschreibung
vbUseSystem 0 NLS-API-Einstellung wird verwendet.
vbSunday 1 Sonntag (Standardeinstellung)
vbMonday 2 Montag
vbTuesday 3 Dienstag
vbWednesday 4 Mittwoch
vbThursday 5 Donnerstag
vbFriday 6 Freitag
vbSaturday 7 Samstag

Das Argument firstweekofyear hat die folgenden Einstellungen:

Konstante Wert Beschreibung
vbUseSystem 0 NLS-API-Einstellung wird verwendet.
vbFirstJan1 1 Beginnt mit der Woche, in der der 1. Januar enthalten ist (Standardeinstellung).
vbFirstFourDays 2 Beginnt mit der ersten Woche, bei der mindestens vier Tage im neuen Jahr liegen.
vbFirstFullWeek 3 Beginnt mit der ersten vollen Woche des Jahrs.

Hinweise

Verwenden Sie die DatePart-Funktion , um ein Datum auszuwerten und ein bestimmtes Zeitintervall zurückzugeben. Sie können DatePart beispielsweise verwenden, um den Wochentag oder die aktuelle Uhrzeit zu berechnen.

Das Argument firstdayofweek wirkt sich auf Berechnungen aus, in denen die Intervallsymbole "w" und "ww" verwendet werden.

Wenn Date ein Datumsliteral ist, wird das angegebene Jahr zu einem dauerhaften Bestandteil dieses Datums. Wenn Date aber in doppelte Anführungszeichen eingeschlossen ist ("") und Sie das Jahr weglassen, wird jedes Mal, wenn das aktuelle Jahr in den Code eingefügt wird, der Date-Ausdruck ausgewertet. Auf diese Weise können Sie Code schreiben, der in unterschiedlichen Jahren verwendet werden kann.

Hinweis

Das für date angegebene Datum muss ein gregorianisches Datum sein, wenn die Einstellung der Calendar-Eigenschaft dem gregorianischen Kalender entspricht. Wenn es sich um einen Hijri-Kalender handelt, muss das angegebene Datum ein Hijri-Datum sein.

Der zurückgegebene Datumsbestandteil ist in Zeitraumeinheiten des aktuellen arabischen Kalenders angegeben. Wenn beispielsweise der aktuelle Kalender ein Hijri-Kalender ist und der zurückzugebende Datumsbestandteil das Jahr ist, ist der Jahreswert ein Hijri-Jahr.

Beispiel

In diesem Beispiel wird ein Datum verwendet und mithilfe der DatePart-Funktion das Quartal des Jahres angezeigt, in diesem Datum auftritt.

Dim TheDate As Date    ' Declare variables.
Dim Msg    
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Format- oder DatePart-Funktionen können eine falsche Wochennummer für den letzten Montag im Jahr zurückgeben.