DatePart-Funktion

Gibt einen Wert vom Typ Variant (Integer) zurück, der den angegebenen Teil eines bestimmten Datums enthält.

Syntax

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

Die Syntax der DatePart-Funktion enthält die folgenden Argument:

Argument

Beschreibung

interval

Erforderlich. Zeichenfolgenausdruck, der das zurückzugebende Zeitintervall darstellt.

date

Erforderlich. Auszuwertender Wert für Variant (Date).

firstdayofweek

Optional. Eine Konstante, die den ersten Tag der Woche angibt. Wenn kein anderer Wert angegeben ist, wird von Sonntag ausgegangen.

firstweekofyear

Optional. Eine Konstante, die die erste Woche des Jahres angibt. Wenn kein anderer Wert angegeben ist, wird angenommen, dass es sich um die Woche handelt, die den 1. Januar enthält.


Einstellungen

Das interval-Argument verwendet 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 verwendet die folgenden Einstellungen:

Konstante

Wert

Beschreibung

vbUseSystem

0

Verwendet die NLS API-Einstellung.

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 verwendet die folgenden Einstellungen:

Konstante

Wert

Beschreibung

vbUseSystem

0

Verwendet die NLS API-Einstellung.

vbFirstJan1

1

Beginnt mit der Woche, die den 1. Januar enthält (Standardeinstellung).

vbFirstFourDays

2

Beginnt mit der ersten Woche, die mindestens vier Tage im neuen Jahr enthält.

vbFirstFullWeek

3

Beginnt mit der ersten vollständigen Woche des Jahres.


Hinweise

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

Das Argument firstdayofweek bezieht sich auf Berechnungen, die die Intervallsymbole w und ww verwenden.

Wenn date ein Datumsliteral ist, wird das angegebene Jahr zu einem permanenten Bestandteil des Datums. Wenn date jedoch von Anführungszeichen (" ") umgeben ist und Sie das Jahr auslassen, wird das aktuelle Jahr bei jeder Auswertung des date-Ausdrucks in den Code eingefügt. Auf diese Weise können Sie Code zur Verwendung in verschiedenen Jahren erstellen.

Hinweis : Wenn für date als Einstellung für die Calendar-Eigenschaft der gregorianische Kalender festgelegt ist, muss das Datum im gregorianischen Format angegeben sein. Beim Hijri-Kalender muss das Datum im Hijri-Format angegeben werden.

Der zurückgegebene Datumsteil entspricht den Zeitraumeinheiten des aktuellen arabischen Kalenders. Wenn es sich beim aktuellen Kalender um einen Hijri-Kalender handelt und das Jahr als Datumsteil zurückgegeben werden soll, entspricht der Jahreswert einem Hijri-Jahr.

Beispiel

Hinweis : Die folgenden Beispiele zeigen die Verwendung dieser Funktion in einem VBA-Modul (Visual Basic für Applikationen). Wenn Sie weitere Informationen zum Arbeiten mit VBA wünschen, wählen Sie Entwicklerhilfe in der Dropdownliste neben Suchen, 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 liegt.

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

War diese Information hilfreich?

Sehr gut. Noch anderes Feedback?

Was können wir verbessern?

Vielen Dank für Ihr Feedback!

×