Office: DateAdd-Funktion

DateAdd-Funktion
Access für Microsoft 365 Access 2019 Access 2016 Access 2013 Access 2010 Access 2007 Mehr... Weniger Gibt einen Wert des Typs Variant (Date) mit einem Datum zurück, dem ein angegebenes Zeitintervall hinzugefügt wurde.

Syntax

DateAdd ( Intervall, Zahl, Datum )

Die Syntax der Funktion DateAdd weist die folgenden Argumente auf:

Argument	Beschreibung
Intervall	Erforderlich. Zeichenfolgenausdruck, bei dem es sich um das Zeitintervall handelt, das hinzugefügt werden soll.
Zahl	Erforderlich. Numerischer Ausdruck, der die Anzahl der hinzuzufügenden Intervalle darstellt. Er kann positiv (zum Abrufen von Datumswerten in der Zukunft) oder negativ (zum Abrufen von Datumswerten in der Vergangenheit) sein.
Datum	Erforderlich. Wert des Typs Variant (Date) oder ein Literal, der das Datum darstellt, dem das Intervall hinzugefügt wird.

Tipp:  In Access 2010 enthält der Ausdrucks-Generator IntelliSense, sodass Sie sehen können, welche Argumente für den Ausdruck erforderlich sind. 

Einstellungen

Das Intervall-Argument weist die folgenden Einstellungen auf:

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

Mit der DateAdd-Funktion können Sie ein bestimmtes Zeitintervall zu einem Datum hinzufügen oder abziehen. Beispielsweise bietet DateAdd die Möglichkeit, ein Datum zu berechnen, das 30 Tage in der Zukunft liegt, oder eine Uhrzeit, die 45 Minuten in der Zukunft liegt.

Wenn Sie zu date, Tage hinzuaddieren möchten, können Sie den Tag des Jahres ("y"), den Tag ("d") oder den Wochentag ("w") verwenden.

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

In diesem Fall gibt DateAdd 28-Feb-95 und nicht 31-Feb-95 zurück. Wenn Datum 31-Jan-96 ist, wird der Wert 29-Feb-96 zurückgegeben, da 1996 ein Schaltjahr ist.

Liegt das berechnete Datum vor dem Jahr 100 (d. h., Sie subtrahieren mehr Jahre, als in date vorhanden sind), tritt ein Fehler auf.

Wenn Zahl kein Wert vom Typ "Long" ist, wird vor der Auswertung auf die nächste ganze Zahl gerundet.

Hinweis:  Das Format des Rückgabewerts für DateAdd wird durch die Einstellungen der System Steuerung bestimmt, nicht durch das Format, das im Date -Argument übergeben wird.

Hinweis:  Das für Datum angegebene Datum muss ein gregorianisches Datum sein, wenn die Einstellung der Calendar-Eigenschaft dem gregorianischen Kalender entspricht. Wenn es sich um einen Hijri-Kalender handelt, muss das angegebene Datum ein Hijri-Datum sein. Wenn die Monatswerte in Namen angegeben werden, müssen die Namen der aktuellen Einstellung der Calendar-Eigenschaft entsprechen. Um das Risiko zu minimieren, dass die Monatsnamen und die aktuelle Einstellung der Calendar-Eigenschaft kollidieren, geben Sie numerische Monatswerte ein (kurzes Datumsformat).

Abfragebeispiele

Ausdruck	Ergebnisse
Wählen Sie DateAdd ("JJJJ"; 1; [DateofSale]) als expr1 von productsales;	Gibt die Ergebnisse zurück, indem Sie den Datumswerten des Felds "DateofSale" 1 Jahr hinzufügt.
Wählen Sie DateAdd ("yyyy",-1, [DateofSale]) als expr1 von productsales;	Gibt die Ergebnisse zurück, indem ein Jahr auf die Datumswerte des Felds "DateofSale" subtrahiert wird.
Wählen Sie DateAdd ("d", 10, [DateofSale]) als "Datum" aus productsales;	Gibt die Ergebnisse in der Spalte "neudatum" zurück, indem den Datumswerten des Felds "DateofSale" 10 Tage hinzugefügt werden.
Wählen Sie DateAdd ("ww",-1, [DateofSale]) als Datum aus productsales;	Gibt die Ergebnisse in der Spalte "neudatum" zurück, indem eine Woche (7 Tage) von den Datumswerten des Felds "DateofSale" subtrahiert wird.

VBA-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 DateAdd-Funktion ein entsprechendes Datum angezeigt, das eine bestimmte Anzahl von Monaten in der Zukunft liegt.

Hinweis:  Diese Seite wurde automatisiert übersetzt und kann Grammatikfehler oder Ungenauigkeiten enthalten. Unser Ziel ist es, Ihnen hilfreiche Inhalte bereitzustellen. Lassen Sie uns bitte wissen, ob diese Informationen hilfreich für Sie waren. Hier finden Sie den englischen Artikel als Referenz.

Siehe auch
Auswählen der richtigen Datumsfunktion

:)