Office: DatePart-Funktion

DatePart-Funktion
Gibt einen Wert des Typs Variant (Integer) zurück, der den angegebenen Teil eines bestimmten Datums enthält.

Warnung    Bei der Verwendung dieser Funktion ist ein Problem aufgetreten. Der letzte Montag in einigen Kalenderjahren kann als Woche 53 zurückgegeben werden, wenn es sich um eine Woche 1 handeln sollte. Weitere Informationen und eine Problemumgehung finden Sie unter Funktionen für Format oder datepart 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 in der ersten Woche die Woche angenommen, in der der 1. Januar eintritt.

Einstellungen

Das Interval -Argument weist die folgenden Einstellungen auf:

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.

Ist date ein Datumsliteral, wird das angegebene Jahr zu einem dauerhaften Teil dieses Datums. Wenn Datum jedoch in doppelten Anführungszeichen ("") eingeschlossen ist und Sie das Jahr nicht angeben, wird das aktuelle Jahr jedes Mal in Ihren Code eingefügt, wenn der Datums Ausdruck ausgewertet wird. 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
Wählen Sie DatePart ("JJJJ"; [DateofSale]) als Datum aus productsales;	Gibt das "Jahr" der Datumswerte des Felds "DateofSale" zurück.
Wählen Sie DatePart ("q", [DateofSale]) als "Datum" aus productsales;	Gibt das "Quartal" (basierend auf dem Kalenderjahr) der Datumswerte des Felds "DateofSale" zurück.
Wählen Sie DatePart ("y"; [DateofSale]) als Datum aus productsales;	Gibt den Tag des Jahres (1 bis 365) der Datumswerte des Felds "DateofSale" zurück.
Wählen Sie DatePart ("d"; [DateofSale]) als Datum aus productsales;	Gibt den "Tag" der Datumswerte des Felds "DateofSale" zurück.
Wählen Sie DatePart ("w"; [DateofSale]) als Datum aus productsales;	Gibt den "Wochentag" zurück (von 1 bis 7, wobei 1 für Sunday steht) der Datumswerte des Felds "DateofSale".
Wählen Sie DatePart ("ww", [DateofSale]) als Datum aus productsales;	Gibt die "Wochennummer" (von 1 bis 52) der Datumswerte des Felds "DateofSale" zurück.
Wählen Sie DatePart ("h"; [DateTime]) als "Datum" in productsales aus.	Gibt die ' Stunde ' der Datumswerte des Felds "DateTime" zurück.
Wählen Sie DatePart ("n", [DateTime]) als "Datum" aus productsales;	Gibt die "Minuten" der Datumswerte des Felds "DateTime" zurück.
Wählen Sie DatePart ("s", [DateTime]) als "neuerdatum" in productsales aus.	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.

Siehe auch
Auswählen der richtigen Datumsfunktion

:)