DATEADD-Funktion
Die DATEADD-Funktion führt Zeit- und Datumsberechnungen für übereinstimmende Eigenschaften mit Datumstypen durch. Verwenden Sie die DATEADD-Funktion, um Datums- und Uhrzeitangaben in einer angegebenen Zeit vor der Gegenwart abzurufen.
Syntax
DATEADD (DateTimeUnits, OffsetValue, DateTime)
Argumente
DateTimeUnits
Gibt die Einheiten des DateTime-Parameters 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 durch den DateTimeUnits-Parameter angegebenen Einheiten an. 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 Ortszeit Ihres Computers identisch ist.
Verwenden Sie nicht den Vergleichsoperator gleich (=), da die interne Zeitdarstellung zu Rundungsfehlern führen kann, die zu unerwarteten Übereinstimmungsergebnissen führen.
Sie können mehrere DATEADD-Funktionen verwenden, um Offseteinheiten zu kombinieren.
Beispiele
Die folgende WHERE-Beispielklausel entspricht Dokumenten, die innerhalb der letzten fünf Tage geändert wurden:
...WHERE System.DateModified <=DATEADD (DAY, -5, GETGMTDATE())
Die folgende WHERE-Beispielklausel entspricht Dokumenten, die innerhalb der letzten zwei Tage und vier Stunden geändert wurden:
...WHERE System.DateModified <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))
Zugehörige Themen
-
Referenz
-
Konzept