Gibt eine Variant (Datum) zurück, die 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, das das Zeitintervall angibt, das Sie addieren möchten. |
number |
Erforderlich. Numerischer Ausdruck, der die Anzahl der Intervalle angibt, die Sie addieren möchten. Es kann positiv sein, Daten in der Zukunft zu erhalten, oder negativ, Daten in der Vergangenheit zu erhalten. |
date |
Erforderlich. Variante (Datum) oder Literal, das das Datum darstellt, zu dem das Intervall addiert wird. |
Einstellungen
Das interval Argument hat 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 zu einem Datum zu addieren oder davon zu subtrahieren. Sie können z. B. ein Datum berechnen DateAdd , das in 30 Tagen von heute liegt, oder eine Uhrzeit, die 45 Minuten in der Zukunft liegt.
Um Tage hinzuzufügen date, kö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 dem 31. Januar ein Monat hinzugefügt:
DateAdd("m", 1, "31-Jan-95")
Gibt in diesem Fall DateAdd den 28. Februar 95 zurück, nicht den 31. Februar 95. Wenn date der 31. Januar 96 ist, wird der 29. Februar 96 zurückgegeben, da 1996 ein Schaltjahr ist.
Wenn das berechnete Datum vor dem Jahr 100 liegen würde, was bedeutet, dass Sie mehr Jahre subtrahieren, als in datesind, tritt ein Fehler auf.
Wenn number dieser Wert nicht 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 die Einstellungen der Systemsteuerung bestimmt, nicht durch das im Argument übergebene date Format.
Hinweis
Für date, wenn die Calendar Eigenschaftseinstellung 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; |
Addiert 1 Jahr zu den Datumswerten im DateofSale Feld. |
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; |
Addiert 10 Tage zu den Datumswerten im DateofSale Feld 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 Access VBA-Referenz.
In diesem Beispiel wird ein Datum als Eingabe verwendet, und mithilfe der DateAdd Funktion wird das übereinstimmende Datum eine bestimmte Anzahl von Monaten in der Zukunft angezeigt.
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