DateDiff-Funktion

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

Hier sind einige Beispiele

Syntax

DateDiff ( Intervall, Datum1, Datum2 [, ErsterTagDerWoche] [, ErsteWocheDesJahres] )

Die Syntax der Funktion DateDiff weist die folgenden Argumente auf:

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

Argument

Beschreibung

Intervall

Erforderlich. Zeichenfolgenausdruck, der das Zeitintervall darstellt, das zum Berechnen der Differenz zwischen Datum1 und Datum2 verwendet wird.

Datum1, Datum2

Erforderlich. Variant (Date). Zwei Datumsangaben, die Sie in der Berechnung verwenden möchten.

ErsterTagDerWoche

Optional. Eine Konstante, die den ersten Tag der Woche bezeichnet. Sofern nicht anders angegeben, wird "Sonntag" vorausgesetzt.

ErsteWocheDesJahres

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


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


Seitenanfang

Das ErsterTagDerWoche-Argument weist die folgenden Einstellungen auf:

Konstante

Wert

Beschreibung

vbUseSystem

0

NLS API-Einstellung verwenden.

vbSunday

1

Sonntag (Standard)

vbMonday

2

Montag

vbTuesday

3

Dienstag

vbWednesday

4

Mittwoch

vbThursday

5

Donnerstag

vbFriday

6

Freitag

vbSaturday

7

Samstag


Konstante

Wert

Beschreibung

vbUseSystem

0

NLS API-Einstellung verwenden.

vbFirstJan1

1

Mit der Woche beginnen, in die der 1. Januar fällt (Standard).

vbFirstFourDays

2

Mit der ersten Woche beginnen, die mindestens vier Tage des neuen Jahres enthält.

vbFirstFullWeek

3

Mit der ersten vollen Woche des Jahres beginnen.


Hinweise

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

Um die Anzahl von Tagen zwischen Datum1 und Datum2 zu berechnen, können Sie entweder "Tag des Jahres" ("y") oder "Tag" ("d") verwenden. Wenn Intervall gleich "Wochentag" ("w") ist, gibt DateDiff die Anzahl von Wochen zwischen den beiden Datumsangaben zurück. Wenn Datum1 auf einen Montag fällt, wird mit DateDiff die Anzahl von Montagen bis Datum2 gezählt. Die Funktion zählt Datum2 aber nicht Datum1. Ist Intervall gleich "Woche" ("ww") ist, gibt die DateDiff-Funktion die Anzahl von Kalenderwochen zwischen den beiden Datumsangaben zurück. Die Funktion zählt die Anzahl von Sonntagen zwischen Datum1 und Datum2. DateDiff zählt Datum2, wenn es auf einen Sonntag fällt. Datum1 wird dagegen selbst dann nicht gezählt, wenn es auf einen Sonntag fällt.

Wenn Datum1 auf einen späteren Zeitpunkt als Datum2 verweist, gibt die DateDiff-Funktion eine negative Zahl zurück.

Das ErsterTagDerWoche-Argument beeinflusst Berechnungen, bei denen die Intervallsymbole "w" und "ww" verwendet werden.

Wenn Datum1 oder Datum2 ein Datumsliteral ist, wird das angegebene Jahr zu einem dauerhaften Teil dieses Datums. Wenn Datum1 oder Datum2 jedoch in Anführungszeichen (" ") eingeschlossen ist und Sie das Jahr weglassen, wird immer dann, wenn der Datum1 oder Datum2-Ausdruck ausgewertet wird, das aktuelle Jahr in den Code eingefügt. Dadurch können Sie Code schreiben, der in verschiedenen Jahren verwendet werden kann.

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

Hinweis :  Das für Datum1 oder Datum2 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.

Seitenanfang

Beispiele

Verwenden der DateDiff-Funktion in einem Ausdruck     Sie können die DateDiff-Funktion überall verwenden, wo Ausdrücke zulässig sind. Angenommen, Sie haben ein Formular, das Sie verwenden, um Kundenbestellungen zu erledigen. In der Tabelle für Bestellungen (Orders) haben Sie ein Feld namens "ReceiveBefore", das das Datum enthält, bis zu dem die Bestellung beim Kunden eingetroffen sein muss. Sie können die DateDiff-Funktion mit einem Textfeld auf dem Formular verwenden, um die Anzahl von Tagen anzuzeigen, die verbleiben, bevor die Bestellung geliefert werden muss.

Wenn das Liefern einer Bestellung beispielsweise zehn Tage dauert, legen Sie die Steuerelementinhalt-Eigenschaft des Textfelds wie folgt fest:

=DateDiff("d", Now(), [Orders].[ReceiveBefore])-10

Wenn Sie das Formular in der Formularansicht öffnen, wird im Textfeld die Anzahl von Tagen angezeigt, die verbleiben, bevor die Bestellung geliefert werden muss. Wenn weniger als 10 Tage verbleiben, bevor die Bestellung beim Kunden eingetroffen sein muss, ist die Zahl im Textfeld negativ und gibt an, wie viele Tage die Bestellung später eintrifft, wenn sie sofort geliefert wird.

Verwenden der DatDiff-Funktion in VBA-Code   

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 die DateDiff-Funktion verwendet, um die Anzahl von Tagen anzuzeigen, die zwischen dem jeweils angegebenen Datum und heute liegen.

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date")
Msg = "Days from today: " & DateDiff("d", Now, TheDate)
MsgBox Msg
Ihre Fähigkeiten erweitern
Schulung erkunden
Neue Funktionen als Erster erhalten
An Office Insider teilnehmen

War diese Information hilfreich?

Vielen Dank für Ihr Feedback!

Vielen Dank für Ihr Feedback. Es klingt, als ob es hilfreich sein könnte, Sie mit einem unserer Office-Supportmitarbeiter zu verbinden.

×