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 Argumentinterval hat 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 | Sekunde |
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.