DatePart-Funktion

Wichtig :  Dieser Artikel wurde maschinell übersetzt. Bitte beachten Sie den Haftungsausschluss. Die englische Version des Artikels ist als Referenz hier verfügbar: hier.

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

Syntax

DatePart ( Intervall und Datum ; [ ErsterTagDerWoche] [; ErsteWocheDesJahres] )

Die Syntax der Funktion DatePart weist die folgenden Argumente:

Argument

Beschreibung

interval

Erforderlich. Zeichenfolgenausdruck, der das zurückzugebende Zeitintervall darstellt, die zurückgegeben werden soll.

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.


Festlegen instellungen

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

3500

Verwendet die NLS API-Einstellung.

vbSunday

Sonntag

Sonntag (Standard)

vbMonday

3500

Montag

vbTuesday

4

Dienstag

vbWednesday

3500

Mittwoch

vbThursday

18

Donnerstag

vbFriday

19

Freitag

vbSaturday

7

Samstag


Das Argument firstweekofyear verwendet die folgenden Einstellungen:

Konstante

Wert

Beschreibung

vbUseSystem

3500

Verwendet die NLS API-Einstellung.

vbFirstJan1

Sonntag

Beginnt mit der Woche, in die der 1. Januar fällt (Standard).

vbFirstFourDays

3500

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

vbFirstFullWeek

4

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.

Da Te ist ein Datumsliteral, das angegebene Jahr wird einem permanenten Bestandteil des Datums. Jedoch, wenn das Datum in doppelte Anführungszeichen eingeschlossen ist (""), und Sie das Jahr auslassen, jedes Mal der Datum -Ausdruck ausgewertet wird das aktuelle Jahr in Ihren Code eingefügt. Hierdurch können zum Schreiben von Code, die in unterschiedlichen Jahren verwendet werden können.

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 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 liegt.

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

Hinweis : Haftungsausschluss für maschinelle Übersetzungen: Dieser Artikel wurde mithilfe eines Computersystems und ohne jegliche Bearbeitung durch Personen übersetzt. Microsoft bietet solche maschinellen Übersetzungen als Hilfestellung für Benutzer ohne Englischkenntnisse an, damit Sie von den Informationen zu Produkten, Diensten und Technologien von Microsoft profitieren können. Da es sich bei diesem Artikel um eine maschinelle Übersetzung handelt, enthält er möglicherweise Fehler in Bezug auf (Fach-)Terminologie, Syntax und/oder Grammatik.

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!

×