DATEADD-Funktion
Die FUNKTION DATEADD führt Zeit- und Datumsberechnungen für übereinstimmende Eigenschaften mit Datumstypen aus. Verwenden Sie die DATEADD-Funktion, um Datums- und Uhrzeitangaben in einer bestimmten Zeitspanne vor der Gegenwart abzurufen.
Syntax
DATEADD (DateTimeUnits, OffsetValue, DateTime)
Argumente
DateTimeUnits-
Gibt die Einheiten des parameters DateTime an: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE oder SECOND. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet, und Anführungszeichen sind für den Parameter nicht erforderlich.
OffsetValue-
Gibt den Zeitoffset in den einheiten an, die durch den DateTimeUnits Parameter angegeben werden. OffsetValue- muss eine negative ganze Zahl sein. Positive Werte werden nicht unterstützt.
DateTime-
Gibt einen Zeitstempel an, aus dem der Offset berechnet werden soll. Dies kann kein Datumsliteral sein. Es muss entweder GETGMTDATE oder das Ergebnis einer anderen DATEADD-Funktion sein.
Bemerkungen
Die DATEADD-Funktion kann nur in Literalwertvergleichen und nur auf der rechten Seite des Vergleichsoperators verwendet werden.
Die GETGMTDATE-Funktion gibt das aktuelle Datum und die aktuelle Uhrzeit in Greenwich Mean Time (GMT) zurück. Denken Sie daran, dass dieser Wert möglicherweise nicht mit der lokalen Uhrzeit Ihres Computers übereinstimmt.
Verwenden Sie nicht den Gleichheitsvergleichsoperator (=), da die interne Zeitdarstellung Rundungsfehler erzeugen kann, die zu unerwarteten Übereinstimmungsergebnissen führen.
Sie können mehrere DATEADD-Funktionen verwenden, um Offseteinheiten zu kombinieren.
Beispiele
Im folgenden Beispiel für eine WHERE-Klausel werden Dokumente gefunden, die innerhalb der letzten fünf Tage geändert wurden:
...WHERE System.DateModified <=DATEADD (DAY, -5, GETGMTDATE())
Im folgenden Beispiel für eine WHERE-Klausel werden Dokumente gefunden, die innerhalb der letzten zwei Tage und vier Stunden geändert wurden:
...WHERE System.DateModified <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))
Verwandte Themen
-
Referenz-
-
Konzeptionelle