Gibt einen Wert vom Typ Variant (Date) zurück, der ein Datum mit einem hinzugefügten angegebenen Zeitintervall enthält.
Syntax
DateAdd(interval, number, date)
Die DateAdd Funktion weist die folgenden Argumente auf:
| Argument | Beschreibung |
|---|---|
interval |
Erforderlich. Zeichenfolgenausdruck, der das Zeitintervall darstellt, das Sie hinzufügen möchten. |
number |
Erforderlich. Numerischer Ausdruck, der die Anzahl der hinzuzufügenden Intervalle darstellt. Es kann positiv sein, Datumsangaben in der Zukunft abzurufen, oder negativ, um Datumsangaben in der Vergangenheit abzurufen. |
date |
Erforderlich. Variant (Date) oder Literal, das das Datum darstellt, zu dem das Intervall hinzugefügt wird. |
Einstellungen
Das interval Argument verfügt über die folgenden Einstellungen:
| Einstellung | Beschreibung |
|---|---|
yyyy |
Jahr |
q |
Quartal |
m |
Monat |
y |
Tag des Jahres |
d |
Tag |
w |
Weekday |
ww |
Woche |
h |
Stunde |
n |
Minute |
s |
Sekunde |
Hinweise
Sie können die DateAdd -Funktion verwenden, um ein angegebenes Zeitintervall von einem Datum hinzuzufügen oder zu subtrahieren. Sie können beispielsweise verwenden DateAdd , um ein Datum zu berechnen, das 30 Tage von heute entfernt ist, oder eine Zeit von jetzt 45 Minuten.
Zum Hinzufügen von Tagen zu datekönnen Sie Tag des Jahres ("y"), Tag ("d") oder Wochentag ("w") verwenden.
Die DateAdd Funktion gibt kein ungültiges Datum zurück. Im folgenden Beispiel wird am 31. Januar ein Monat hinzugefügt:
DateAdd("m", 1, "31-Jan-95")
In diesem Fall DateAdd gibt 28-Feb-95 und nicht 31-Feb-95 zurück. Wenn date 31-Jan-96 ist, wird 29-Feb-96 zurückgegeben, da 1996 ein Schaltjahr ist.
Wenn das berechnete Datum dem Jahr 100 vorausgeht, was bedeutet, dass Sie mehr Jahre subtrahieren als in date, tritt ein Fehler auf.
Wenn number kein Long-Wert ist, rundet Access ihn auf die nächste ganze Zahl, bevor der Ausdruck ausgewertet wird.
Hinweis
Das Format des Rückgabewerts für DateAdd wird durch Systemsteuerung Einstellungen bestimmt, nicht durch das im date Argument übergebene Format.
Hinweis
Wenn datedie Eigenschaftseinstellung Calendar für gregorianisch ist, muss das angegebene Datum gregorianisch sein. Wenn es sich um einen Hijri-Kalender handelt, muss das angegebene Datum ein Hijri-Datum sein. Wenn Monatswerte Namen sind, muss der Name mit der aktuellen Calendar Eigenschaftseinstellung übereinstimmen. Um die Wahrscheinlichkeit von Konflikten zu verringern, geben Sie numerische Monatswerte im Format "Kurzes Datum" ein.
Abfragebeispiele
| Ausdruck | Ergebnisse |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Fügt den Datumswerten im DateofSale Feld 1 Jahr hinzu. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Subtrahiert 1 Jahr von den Datumswerten im DateofSale Feld. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Fügt den Datumswerten im DateofSale Feld 10 Tage hinzu und gibt die Ergebnisse in der NewDate Spalte zurück. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Subtrahiert 1 Woche oder 7 Tage von den Datumswerten im DateofSale Feld und gibt die Ergebnisse in der NewDate Spalte zurück. |
VBA-Beispiel
Hinweis
Die folgenden Beispiele zeigen die Verwendung dieser Funktion in einem VBA-Modul (Visual Basic for Applications). Weitere Informationen zum Arbeiten mit VBA finden Sie unter Zugreifen auf VBA-Referenz.
In diesem Beispiel wird ein Datum als Eingabe verwendet und die DateAdd -Funktion verwendet, um das übereinstimmende Datum für eine angegebene Anzahl von Monaten in der Zukunft anzuzeigen.
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