DateDiff-Funktion

Gibt einen Wert vom Typ Variant (Long) zurück, der die Anzahl der Zeitintervalle zwischen zwei angegebenen Datumswerten angibt.

Beispiele

Syntax

DateDiff(interval, date1, date2 [, firstdayofweek] [, firstweekofyear] )

Die Syntax der DateDiff-Funktion enthält die folgenden Argument:

Argument

Beschreibung

interval

Erforderlich. Zeichenfolgenausdruck, der das Zeitintervall darstellt, mit dem Sie die Differenz zwischen date1 und date2 berechnen.

date1 , date2

Erforderlich. Variant (Date). Zwei Datumsangaben, die bei der Berechnung verwendet werden sollen.

firstdayofweek

Optional. Eine Konstante, die den ersten Tag der Woche angibt. Wenn kein anderer Wert angegeben ist, wird von Sonntag ausgegangen.

firstweekofyear

Optional. Eine Konstante, die die erste Woche des Jahres angibt. Wenn kein anderer Wert angegeben ist, wird angenommen, dass es sich um die Woche handelt, die den 1. Januar enthält.


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


Das Argument firstdayofweek verwendet die folgenden Einstellungen:

Konstante

Wert

Beschreibung

vbUseSystem

0

Verwendet die NLS API-Einstellung.

vbSunday

1

Sonntag (Standardeinstellung)

vbMonday

2

Montag

vbTuesday

3

Dienstag

vbWednesday

4

Mittwoch

vbThursday

5

Donnerstag

vbFriday

6

Freitag

vbSaturday

7

Samstag

Konstante

Wert

Beschreibung

vbUseSystem

0

Verwendet die NLS API-Einstellung.

vbFirstJan1

1

Beginnt mit der Woche, die den 1. Januar enthält (Standardeinstellung).

vbFirstFourDays

2

Beginnt mit der ersten Woche, die mindestens vier Tage im neuen Jahr enthält.

vbFirstFullWeek

3

Beginnt mit der ersten vollständigen Woche des Jahres.


Hinweise

Sie können die DateDiff-Funktion verwenden, um zu ermitteln, wie viele angegebene Zeitintervalle zwischen zwei Datumsangaben vorhanden sind. Sie können DateDiff beispielsweise verwenden, um die Anzahl von Tagen zwischen zwei Datumsangaben oder die Anzahl von Wochen zwischen dem heutigen Tag und dem Jahresende zu berechnen.

Sie können entweder den Tag des Jahres (y) oder den Tag (d) verwenden, um die Anzahl von Tagen zwischen date1 und date2 zu berechnen. Wenn für interval ein Wochentag (w) angegeben ist, gibt DateDiff die Anzahl der Wochen zwischen den beiden Datumsangaben zurück. Wenn date1 auf einen Montag fällt, zählt DateDiff die Anzahl der Montage bis date2. date2 wird berücksichtigt, date1 hingegen nicht. Wenn für interval jedoch Wochen (ww) festgelegt sind, gibt die DateDiff-Funktion die Anzahl der Kalenderwochen zwischen den beiden Datumsangaben zurück. Es werden die Anzahl der Sonntage zwischen date1 und date2 gezählt. DateDiff berücksichtigt date2, wenn es auf einen Sonntag fällt. date1 hingegen wird nicht berücksichtigt, selbst wenn es auf einen Sonntag fällt.

Wenn sich date1 auf einen späteren Zeitpunkt als date2 bezieht, gibt die DateDiff-Funktion eine negative Zahl zurück.

Das Argument firstdayofweek bezieht sich auf Berechnungen, die die Intervallsymbole w und ww verwenden.

Wenn date1 oder date2 ein Datumsliteral ist, wird das angegebene Jahr zu einem permanenten Bestandteil des Datums. Wenn date1 oder date2 jedoch von Anführungszeichen (" ") umgeben ist und Sie das Jahr auslassen, wird das aktuelle Jahr bei jeder Auswertung des date1- oder date2-Ausdrucks in den Code eingefügt. Auf diese Weise können Sie Code zur Verwendung in verschiedenen Jahren erstellen.

Wenn der 31. Dezember mit dem 1. Januar des unmittelbar folgenden Jahres verglichen wird, gibt DateDiff für das Jahr (yyyy) den Wert 1 zurück, obwohl nur ein Tag vergangen ist.

Hinweis :  Wenn für date1 und date2 als Einstellung für die Calendar-Eigenschaft der gregorianische Kalender festgelegt ist, muss das Datum im gregorianischen Format angegeben sein. Beim Hijri-Kalender muss das Datum im Hijri-Format angegeben werden.

Beispiele

Verwenden der DateDiff-Funktion in einem Ausdruck     Die DateDiff-Funktion kann an Stellen verwendet werden, an denen Ausdrücke verwendet werden. Angenommen, Sie verwenden zum Ausführen von Kundenbestellungen ein Formular. Die Bestellungen-Tabelle enthält das Feld EmpfangenBevor, das das Datum enthält, bis zu dem der Kunde die Bestellung benötigt. Mithilfe der DateDiff-Funktion und einem Textfeld auf dem Formular können Sie die Anzahl der Tage anzeigen, die noch verbleiben, bis die Bestellung ausgeliefert werden muss.

Angenommen, es werden 10 Tage zum Ausliefern von Bestellungen benötigt, legen Sie die ControlSource-Eigenschaft des Textfelds wie folgt fest:

=DateDiff(“d”, Now(), [Bestellungen].[EmpfangenVor])-10

Beim Öffnen des Formulars in der Formularansicht wird im Textfeld die Anzahl der Tage angezeigt, die verbleiben, bis die Bestellung ausgeliefert werden muss. Wenn weniger als 10 Tage verbleiben, bis der Kunde die Bestellung benötigt, ist die Zahl im Textfeld negativ und gibt an, um wie viele Tage die Bestellung zu spät ausgeliefert wird, wenn sie sofort versand wird.

Verwenden der DateDiff-Funktion in VBA-Code    

Hinweis : Die folgenden Beispiele zeigen die Verwendung dieser Funktion in einem VBA-Modul (Visual Basic für Applikationen). Wenn Sie weitere Informationen zum Arbeiten mit VBA wünschen, wählen Sie Entwicklerhilfe in der Dropdownliste neben Suchen, und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.

In diesem Beispiel wird die DateDiff-Funktion verwendet, um die Anzahl der Tage zwischen einem angegebenen Datum und dem heutigen Tag anzuzeigen.

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date")
Msg = "Days from today: " & DateDiff("d", Now, TheDate)
MsgBox Msg
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!

×