DateAdd-Funktion
Gibt eine Variante ( Date ) zurück, die ein Datum enthält, zu dem ein bestimmtes Zeitintervall hinzugefügt wurde.
Syntax
DateAdd ( Intervall, Zahl, Datum )
Die Syntax der DateAdd- Funktion hat die folgenden Argumente:
Streit | Beschreibung |
Intervall | Erforderlich. Zeichenfolgenausdruck, der das Zeitintervall darstellt, das Sie hinzufügen möchten. |
Anzahl | Erforderlich. Numerischer Ausdruck, der die Anzahl der Intervalle darstellt, die Sie hinzufügen möchten. Es kann positiv (um Daten in der Zukunft zu erhalten) oder negativ (um Daten in der Vergangenheit zu erhalten) sein. |
Datum | Erforderlich. Variant ( Date ) oder Literal, das das Datum darstellt, zu dem das Intervall hinzugefügt wird. |
Tipp: In Access 2010 verfügt der Ausdrucks-Generator über IntelliSense, sodass Sie sehen können, welche Argumente Ihr Ausdruck erfordert.
Einstellungen
Das Intervallargument hat diese Einstellungen:
Einstellung | Beschreibung |
jjjj | Jahr |
q | Quartal |
m | Monat |
j | Tag des Jahres |
d | Tag |
w | Wochentag |
ww | Woche |
h | Stunde |
n | Minute |
s | Zweite |
Bemerkungen
Sie können die DateAdd- Funktion verwenden, um ein bestimmtes Zeitintervall zu einem Datum hinzuzufügen oder davon abzuziehen. Beispielsweise können Sie DateAdd verwenden, um ein Datum in 30 Tagen ab heute oder eine Zeit in 45 Minuten ab jetzt zu berechnen.
Um Tage zu Datum hinzuzufügen, können Sie Day of Year ("y"), Day ("d") oder Weekday ("w") verwenden.
Die DateAdd- Funktion gibt kein ungültiges Datum zurück. Das folgende Beispiel fügt dem 31. Januar einen Monat hinzu:
DateAdd("m", 1, "31-Jan-95")
In diesem Fall gibt DateAdd den 28. Februar 1995 und nicht den 31. Februar 1995 zurück. Wenn das Datum der 31. Januar 1996 ist, wird der 29. Februar 1996 zurückgegeben, da 1996 ein Schaltjahr ist.
Wenn das berechnete Datum vor dem Jahr 100 liegen würde (d. h. Sie subtrahieren mehr Jahre als Datum enthält), tritt ein Fehler auf.
Wenn Zahl kein Long-Wert ist, wird sie vor der Auswertung auf die nächste ganze Zahl gerundet.
Hinweis: Das Format des Rückgabewerts für DateAdd wird durch die Einstellungen der Systemsteuerung bestimmt, nicht durch das Format, das im Datumsargument übergeben wird.
Hinweis: Wenn für date die Eigenschaft Calendar auf gregorianischen Wert eingestellt ist, muss das angegebene Datum gregorianische sein. Wenn der Kalender Hijri ist, muss das angegebene Datum Hijri sein. Wenn Monatswerte Namen sind, muss der Name mit der aktuellen Kalendereigenschaftseinstellung übereinstimmen. Geben Sie numerische Monatswerte (kurzes Datumsformat) ein, um die Wahrscheinlichkeit zu minimieren, dass Monatsnamen mit der aktuellen Kalendereigenschaftseinstellung in Konflikt stehen.
Abfragebeispiele
Ausdruck | Ergebnisse |
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; | Gibt die Ergebnisse zurück, indem 1 Jahr zu den Datumswerten des Felds "DateofSale" hinzugefügt wird. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; | Gibt die Ergebnisse zurück, indem 1 Jahr von den Datumswerten des Felds "DateofSale" abgezogen wird. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; | Gibt die Ergebnisse in Spalte „NewDate" zurück, indem 10 Tage zu den Datumswerten des Felds „DateofSale" addiert werden. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; | Gibt die Ergebnisse in Spalte „NewDate" zurück, indem 1 Woche (7 Tage) von den Datumswerten des Felds „DateofSale" abgezogen wird. |
VBA-Beispiel
Hinweis: Die folgenden Beispiele veranschaulichen die Verwendung dieser Funktion in einem Visual Basic for Applications (VBA)-Modul. Um weitere Informationen zum Arbeiten mit VBA zu erhalten, wählen Sie Entwicklerreferenz in der Dropdown-Liste neben Suchen aus und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.
Dieses Beispiel nimmt ein Datum als Eingabe und verwendet die DateAdd- Funktion, um ein entsprechendes Datum eine bestimmte 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
No comments:
Post a Comment