Gibt einen Wert des Typs Variant (Integer) zurück, der den angegebenen Teil eines bestimmten Datums enthält.
|
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. |
Syntax
DatePart ( Intervall, Datum [, ErsterTagDerWoche] [, ErsteWocheDesJahres] )
Die Syntax der Funktion DatePart weist die folgenden Argumente auf:
|
Argument |
Beschreibung |
|
Intervall |
Erforderlich. Zeichenfolgenausdruck, bei dem es sich um das Zeitintervall handelt, das zurückgegeben werden soll. |
|
Datum |
Erforderlich. Wert des Typs Variant (Datum), der ausgewertet werden soll. |
|
ErsterTagDerWoche |
Optional. Eine Konstante, die den ersten Tag der Woche bezeichnet. Sofern nicht anders angegeben, wird "Sonntag" vorausgesetzt. |
|
ErsteWocheDesJahres |
Optional. Eine Konstante, die die erste Woche des Jahres bezeichnet. Wenn nicht angegeben, wird davon ausgegangen, dass die erste Woche die Woche ist, in der der 1. Januar stattfindet. |
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 |
Sekunde |
Das ErsterTagDerWoche-Argument weist die folgenden Einstellungen auf:
|
Konstante |
Wert |
Beschreibung |
|
vbUseSystem |
0 |
NLS API-Einstellung verwenden. |
|
vbSunday |
1 |
Sonntag (Standard) |
|
vbMonday |
2 |
Montag |
|
vbTuesday |
3 |
Dienstag |
|
vbWednesday |
4 |
Mittwoch |
|
vbThursday |
5 |
Donnerstag |
|
vbFriday |
6 |
Freitag |
|
vbSaturday |
7 |
Samstag |
Das ErsteWocheDesJahres-Argument weist die folgenden Einstellungen auf:
|
Konstante |
Wert |
Beschreibung |
|
vbUseSystem |
0 |
NLS API-Einstellung verwenden. |
|
vbFirstJan1 |
1 |
Mit der Woche beginnen, in die der 1. Januar fällt (Standard). |
|
vbFirstFourDays |
2 |
Mit der ersten Woche beginnen, die mindestens vier Tage des neuen Jahres enthält. |
|
vbFirstFullWeek |
3 |
Mit der ersten vollen Woche des Jahres beginnen. |
Hinweise
Sie können die DatePart-Funktion verwenden, um ein Datum auszuwerten und ein bestimmtes Zeitintervall zurückzugeben. Beispielsweise können Sie mit der DatePart-Funktion den Wochentag oder die aktuelle Uhrzeit berechnen.
Das ErsterTagDerWoche-Argument beeinflusst Berechnungen, bei denen die Intervallsymbole "w" und "ww" verwendet werden.
Wenn date ein Datumsliteral ist, wird das angegebene Jahr zu einem dauerhaften Bestandteil dieses Datums. Wenn das Datum jedoch in doppelte Anführungszeichen (" ") eingeschlossen ist und Sie das Jahr weglassen, wird jedes Mal, wenn der Datumsausdruck ausgewertet wird, das aktuelle Jahr in den Code eingefügt. Dadurch können Sie Code schreiben, der in verschiedenen Jahren verwendet werden kann.
Hinweis: Das für Datum 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.
Abfragebeispiele
|
Ausdruck |
Ergebnisse |
|
SELECT DatePart("jjjj",[DateofSale]) AS NewDate FROM ProductSales; |
Gibt das Jahr der Datumswerte des Felds "DateofSale" zurück. |
|
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; |
Gibt das "Quartal" (basierend auf dem Kalenderjahr) der Datumswerte des Felds "DateofSale" zurück. |
|
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; |
Gibt den "Tag des Jahres" (1 bis 365) der Datumswerte des Felds "DateofSale" zurück. |
|
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; |
Gibt den "Day" der Datumswerte des Felds "DateofSale" zurück. |
|
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; |
Gibt den Wochentag (von 1 bis 7, wobei 1 den Sonntag darstellt) der Datumswerte des Felds "DateofSale" zurück. |
|
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; |
Gibt die "Wochennummer" (von 1 bis 52) der Datumswerte des Felds "DateofSale" zurück. |
|
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; |
Gibt die "Stunde" der Datumswerte des Felds "DateTime" zurück. |
|
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; |
Gibt die Minuten der Datumswerte des Felds "DateTime" zurück. |
|
SELECT DatePart("s";[DateTime]) AS NewDate FROM ProductSales; |
Gibt die Sekunden der Datumswerte des Felds "DateTime" zurück. |
VBA-Beispiel
Hinweis: Die folgenden Beispiele zeigen die Verwendung dieser Funktion in einem VBA-Modul (Visual Basic for Applications). Wenn Sie weitere Informationen zum Arbeiten mit VBA wünschen, wählen Sie Entwicklerreferenz in der Dropdownliste neben Suchen aus, und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.
In diesem Beispiel wird ein Datum verwendet, und mithilfe der DatePart-Funktion wird das Quartal des Jahres angezeigt, in dem das Datum vorkommt.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg
