DateDiff-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 des Typs Variant (Long) zurück, der die Anzahl der Zeitintervalle zwischen zwei angegebenen Datumswerten angibt.

Finden Sie einige Beispiele für

Syntax

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

Die Syntax der Funktion DateDiff weist die folgenden Argumente:

Tipp : In Access 2010 ist IntelliSense in den Ausdrucks-Generator integriert, sodass Sie sehen können, welche Argumente der Ausdruck erfordert. 

Argument

Beschreibung

Intervall

Erforderlich. Zeichenfolgenausdruck, der das zurückzugebende Zeitintervall darstellt, die Sie zum Berechnen der Differenz zwischen Datum1 und Datum2verwenden.

Datum1, Datum2

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

ErsterTagDerWoche

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

ErsteWocheDesJahres

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


Seitenanfang

Das Argument firstdayofweek verwendet die folgenden Einstellungen:

Konstante

Wert

Beschreibung

vbUseSystem

3500

Verwendet die NLS API-Einstellung.

vbSunday

Sonntag

Sonntag (Standard)

vbMonday

3500

Montag

vbTuesday

4

Dienstag

vbWednesday

3500

Mittwoch

vbThursday

18

Donnerstag

vbFriday

19

Freitag

vbSaturday

7

Samstag


Konstante

Wert

Beschreibung

vbUseSystem

3500

Verwendet die NLS API-Einstellung.

vbFirstJan1

Sonntag

Beginnt mit der Woche, in die der 1. Januar fällt (Standard).

Liegen

3500

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

vbFirstFullWeek

4

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.

Seitenanfang

Beispiele

Verwenden Sie die DateDiff-Funktion in einem Ausdruck     Sie können die DateDiff -Funktion verwenden, wo Ausdrücke verwendet werden. Angenommen Sie, Sie haben ein Formular, das Sie verwenden, um Kundenaufträge durchführen zu können. In der Tabelle Orders müssen Sie ein Feld mit dem Namen ReceiveBefore mit dem Datum, an dem der Kunde die Bestellung erhalten muss. Können die DateDiff -Funktion mit einem Textfeld im Formular angezeigt werden die Anzahl der Tage nach links, 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(), [Orders].[ ReceiveBefore])-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 Sie die DateDiff-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 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

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!

×