DateAdd-Funktion

Gibt einen Wert vom Typ Variant (Date) mit einem Datum zurück, dem ein angegebenes Zeitintervall hinzugefügt wurde.

Syntax

DateAdd(interval, number, date)

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

Argument

Beschreibung

interval

Erforderlich. Zeichenfolgenausdruck, der das hinzuzufügende Zeitintervall darstellt.

number

Erforderlich. Numerischer Ausdruck, der die Anzahl der hinzuzufügenden Intervalle darstellt. Er kann positiv (zum Abrufen von Datumsangaben in der Zukunft) oder negativ (zum Abrufen von Datumsangaben in der Vergangenheit) sein.

date

Erforderlich. Variant (Date) oder Literal, die bzw. das das Datum darstellt, dem das Intervall hinzugefügt wird.


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


Hinweise

Sie können die DateAdd-Funktion verwenden, um ein angegebenes Zeitintervall einem Datum hinzuzufügen oder von einem Datum zu subtrahieren. Sie können DateAdd beispielsweise verwenden, um ein Datum 30 Tage ab heute oder eine Uhrzeit 45 Minuten ab jetzt zu berechnen.

Sie können den Tag des Jahres (y), den Tag (d) oder den Wochentag (w) verwenden, um Tage zu date hinzuzufügen.

Die DateAdd-Funktion gibt kein ungültiges Datum zurück. Im folgenden Beispiel wird dem 31. Januar ein Monat hinzugefügt:

DateAdd("m", 1, "31-Jan-95")

In diesem Fall gibt DateAdd den 28. Februar 95 zurück (nicht den 31. Februar 95). Wenn als Wert für date der 31. Januar 96 festgelegt ist, wird der 29. Februar 96 zurückgegeben, da 1996 ein Schaltjahr ist.

Wenn das berechnete Datum vor dem Jahr 100 liegen würde (d. h., wenn Sie mehr Jahre subtrahieren als für date angegeben sind), tritt ein Fehler auf.

Wenn es sich bei number nicht um einen Wert des Typs Long-Datentyp handelt, wird der Wert vor der Auswertung auf die nächste ganze Zahl gerundet.

Hinweis :  Das Format des Rückgabewerts für DateAdd wird durch Einstellungen in der Systemsteuerung bestimmt, und nicht durch das Format, das im Argument date übergeben wird.

Hinweis :  Wenn als Einstellung für die Calendar-Eigenschaft der gregorianische Kalender festgelegt ist, muss das Datum für date im gregorianischen Format angegeben sein. Wenn es sich um einen Hijri-Kalender handelt, muss ein Datum im Hijri-Format angegeben sein. Wenn Monatswerte aus Namen bestehen, muss der Name mit der aktuellen Einstellung der Calendar-Eigenschaft konsistent sein. Geben Sie numerische Monatswerte (kurzes Datumsformat) ein, um mögliche Konflikte zwischen Monatsnamen und der aktuellen Einstellung für die Calendar-Eigenschaft zu minimieren.

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 als Eingabe verwendet, und mithilfe der DateAdd-Funktion wird ein entsprechendes Datum angezeigt, das um die angegebene Anzahl der Monate in der Zukunft liegt.

Dim FirstDate As Date    ' Declare variables.
Dim IntervalType As String
Dim Number As Integer
Dim Msg
IntervalType = "m" ' "m" specifies months as interval.
FirstDate = InputBox("Enter a date")
Number = InputBox("Enter number of months to add")
Msg = "New date: " & _
DateAdd(IntervalType, Number, FirstDate)
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!

×