DateAdd-Funktion

Wichtig :  Dieser Artikel wurde maschinell übersetzt. Bitte beachten Sie den Haftungsausschluss. Die englische Version des Artikels ist als Referenz hier verfügbar: hier.

Gibt einen Wert vom Typ 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:

Argument

Beschreibung

Intervall

Erforderlich. Zeichenfolgenausdruck, der das zurückzugebende Zeitintervall darstellt, die Sie hinzufügen möchten.

Zahl

Erforderlich. Numerischer Ausdruck, der die Anzahl der Intervalle, die Sie hinzufügen möchten. Er kann positiv (für Datumsangaben in der Zukunft) oder negativ (für Datumsangaben in der Vergangenheit) sein.

Datum

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


Tipp : Klicken Sie in Access 2010 verfügt über den Ausdrucks-Generator IntelliSense-, damit Sie sehen können, welche Argumente der Ausdruck erfordert.

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 Zahl ein Wert Long nicht, 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 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 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

Hinweis : Haftungsausschluss für maschinelle Übersetzungen: Dieser Artikel wurde mithilfe eines Computersystems und ohne jegliche Bearbeitung durch Personen übersetzt. Microsoft bietet solche maschinellen Übersetzungen als Hilfestellung für Benutzer ohne Englischkenntnisse an, damit Sie von den Informationen zu Produkten, Diensten und Technologien von Microsoft profitieren können. Da es sich bei diesem Artikel um eine maschinelle Übersetzung handelt, enthält er möglicherweise Fehler in Bezug auf (Fach-)Terminologie, Syntax und/oder Grammatik.

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!

×