Datumsbestandteil

Gibt den angegebenen Teil eines bestimmten Datums zurück.

Aufbau

DatePart(Intervall, Datum[, ersterWochentag[, ersteWocheimJahr]])

Parameter

Intervall – erforderlich. Ein String-Ausdruck, der das Zeitintervall angibt, das zurückgegeben werden soll. Die Werte finden Sie im Abschnitt „Einstellungen“.

Datum – erforderlich. Datumsausdruck, den Sie auswerten möchten.

firstdayofweek – optional. Konstante, die den Wochentag angibt. Sofern nicht anders angegeben, wird davon ausgegangen, dass es sich um einen Sonntag handelt. Die Werte finden Sie im Abschnitt „Einstellungen“.

erste Woche des Jahres – optional. Konstante, die die erste Woche des Jahres angibt. Sofern nicht anders angegeben, wird davon ausgegangen, dass die erste Woche die Woche ist, in der der 1. Januar liegt.

Parameterwerte

Das Argument „interval“ kann folgende Werte annehmen:

Einstellungsbeschreibung

yyyy Jahr

q Quartal

m Monat

Tag des Jahres

D-Day

w Wochentag

Woche des Jahres

Stunde

n Minuten

Zweitens

Das Argument „firstdayofweek“ kann folgende Werte annehmen:

Konstante Wert Beschreibung

vbUseSystemDayOfWeek 0 Einstellung zur Verwendung der National Language Support (NLS)-API.

vbSunday 1 Sonntag (Standard)

vbMontag 2 Montag

Dienstag, 3. Dienstag

Mittwoch, 4. Mittwoch

Donnerstag, 5.

Freitag, 6. Freitag

Samstag, 7.

Das Argument „firstweekofyear“ kann folgende Werte annehmen:

Konstante Wert Beschreibung

vbUseSystem 0 Einstellung zur Verwendung der National Language Support (NLS)-API.

vbFirstJan1 1 Beginnt mit der Woche, in der der 1. Januar liegt (Standard).

vbFirstFourDays 2 Beginne mit der Woche, die im neuen Jahr mindestens vier Tage umfasst.

vbFirstFullWeek 3 Beginne mit der ersten vollen Woche des neuen Jahres.

Beschreibung

Mit der Funktion „DatePart“ können Sie ein Datum auswerten und ein bestimmtes Zeitintervall zurückgeben. Sie können beispielsweise „DatePart“ verwenden, um den Wochentag oder die aktuelle Uhrzeit zu berechnen.

Das Argument „firstdayofweek“ wirkt sich auf Berechnungen aus, die die Intervallsymbole „w“ und „ww“ verwenden.

Wenn „date“ ein Datumsliteral ist, wird das angegebene Jahr zu einem festen Bestandteil dieses Datums. Wenn das Datum jedoch in Anführungszeichen (' ') steht und Sie das Jahr weglassen, wird bei jeder Auswertung des Datumsausdrucks das aktuelle Jahr in Ihren Code eingefügt. Dadurch lässt sich Code schreiben, der in verschiedenen Jahren verwendet werden kann.

Beispiel

In diesem Beispiel wird ein Datum verwendet und mithilfe der Funktion „DatePart“ das Quartal des Jahres angezeigt, in dem es liegt.

Funktion GetQuarter(TheDate)

GetQuarter = DatePart("q", TheDate)

End Function. |