DatePart-FunktionDatePart function

Gibt eine Variant (ganze Zahl) zurück, die den angegebenen Teil eines bestimmten Datums enthält.Returns a Variant (Integer) containing the specified part of a given date.

SyntaxSyntax

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


Die Syntax der DatePart-Funktion verfügt über die folgenden benannten Argumente:The DatePart function syntax has these named arguments:

TeilPart BeschreibungDescription
Intervallinterval Erforderlich.Required. Zeichenfolgenausdruck, bei dem es sich um das Zeitintervall handelt, das zurückgegeben werden soll.String expression that is the interval of time you want to return.
datedate Erforderlich.Required. Variant (Date) Wert, den Sie auswerten möchten.Variant (Date) value that you want to evaluate.
firstdayofweekfirstdayofweek Optional.Optional. Eine Konstante, die den ersten Tag der Woche angibt.A constant that specifies the first day of the week. Wenn keine Angabe vorhanden ist, wird vorausgesetzt, dass es sich um den Sonntag handelt.If not specified, Sunday is assumed.
firstweekofyearfirstweekofyear Optional.Optional. Eine Konstante, die die erste Woche des Jahres angibt.A constant that specifies the first week of the year. Wenn nicht angegeben, wird angenommen, dass die erste Woche die Woche um den 1. Januar ist.If not specified, the first week is assumed to be the week in which January 1 occurs.

EinstellungenSettings

Das Argumentinterval hat die folgenden Einstellungen:The interval argument has these settings:

EinstellungSetting BeschreibungDescription
yyyyyyyy JahrYear
qq QuartalQuarter
mm MonatMonth
yy Tag des JahresDay of year
dd TagDay
ww WochentagWeekday
wwww WocheWeek
hh StundeHour
nn MinuteMinute
ss ZweiterSecond

Das Argument firstdayofweek hat die folgenden Einstellungen:The firstdayofweek argument has these settings:

KonstanteConstant WertValue BeschreibungDescription
vbUseSystemvbUseSystem 00 Verwendet die NLS API-Einstellung.Use the NLS API setting.
vbSundayvbSunday 11 Sonntag (Standardeinstellung)Sunday (default)
vbMondayvbMonday 22 MontagMonday
vbTuesdayvbTuesday 33 DienstagTuesday
vbWednesdayvbWednesday 44 MittwochWednesday
vbThursdayvbThursday 55 DonnerstagThursday
vbFridayvbFriday 66 FreitagFriday
vbSaturdayvbSaturday 77 SamstagSaturday

Das Argument firstweekofyear hat die folgenden Einstellungen:The firstweekofyear argument has these settings:

KonstanteConstant WertValue BeschreibungDescription
vbUseSystemvbUseSystem 00 Verwendet die NLS API-Einstellung.Use the NLS API setting.
vbFirstJan1vbFirstJan1 11 Beginnt mit der Woche, in der der 1. Januar enthalten ist (Standardeinstellung).Start with week in which January 1 occurs (default).
vbFirstFourDaysvbFirstFourDays 22 Beginnt mit der ersten Woche, in der mindestens vier Tage im neuen Jahr liegen.Start with the first week that has at least four days in the new year.
vbFirstFullWeekvbFirstFullWeek 33 Beginnt mit der ersten vollen Woche des Jahrs.Start with first full week of the year.

HinweiseRemarks

Sie können die DatePart-Funktion verwenden, um ein Datum auszuwerten und ein bestimmtes Zeitintervall zurückzugeben.You can use the DatePart function to evaluate a date and return a specific interval of time. Sie können DatePart beispielsweise verwenden, um den Wochentag oder die aktuelle Uhrzeit zu berechnen.For example, you might use DatePart to calculate the day of the week or the current hour.

Das Argument firstdayofweek wirkt sich auf Berechnungen aus, in denen die Intervallsymbole "w" und "ww" verwendet werden.The firstdayofweek argument affects calculations that use the "w" and "ww" interval symbols.

Wenn Date ein Datumsliteral ist, wird das angegebene Jahr zu einem dauerhaften Bestandteil dieses Datums.If date is a date literal, the specified year becomes a permanent part of that date. Wenn Date aber in doppelte Anführungszeichen eingeschlossen ist ("") und Sie das Jahr weglassen, wird jedes Mal, wenn das aktuelle Jahr in den Code eingefügt wird, der Date-Ausdruck ausgewertet.However, if date is enclosed in double quotation marks (" "), and you omit the year, the current year is inserted in your code each time the date expression is evaluated. Auf diese Weise können Sie Code schreiben, der in unterschiedlichen Jahren verwendet werden kann.This makes it possible to write code that can be used in different years.

Hinweis

Das für date angegebene Datum muss ein gregorianisches Datum sein, wenn die Einstellung der Calendar-Eigenschaft dem gregorianischen Kalender entspricht.For date, if the Calendar property setting is Gregorian, the supplied date must be Gregorian. Wenn es sich um einen Hijri-Kalender handelt, muss das angegebene Datum ein Hijri-Datum sein.If the calendar is Hijri, the supplied date must be Hijri.

Der zurückgegebene Datumsbestandteil ist in Zeitraumeinheiten des aktuellen arabischen Kalenders angegeben.The returned date part is in the time period units of the current Arabic calendar. Wenn beispielsweise der aktuelle Kalender ein Hijri-Kalender ist und der zurückzugebende Datumsbestandteil das Jahr ist, ist der Jahreswert ein Hijri-Jahr.For example, if the current calendar is Hijri and the date part to be returned is the year, the year value is a Hijri year.

BeispielExample

In diesem Beispiel wird ein Datum verwendet und mithilfe der DatePart-Funktion das Quartal des Jahres angezeigt, in diesem Datum auftritt.This example takes a date and, using the DatePart function, displays the quarter of the year in which it occurs.

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

Siehe auchSee also

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.