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.

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

Siehe auch

Auswählen der richtigen Datumsfunktion

Ihre Office-Fähigkeiten erweitern
Schulungen erkunden
Neue Funktionen als Erster erhalten
Office Insider werden

War diese Information hilfreich?

Vielen Dank für Ihr Feedback!

Vielen Dank für Ihr Feedback. Es klingt, als ob es hilfreich sein könnte, Sie mit einem unserer Office-Supportmitarbeiter zu verbinden.

×