Delen via


DATEADD, functie

De functie DATEADD voert tijd- en datumberekeningen uit voor overeenkomende eigenschappen met datumtypen. Gebruik de functie DATEADD om datums en tijden in een opgegeven tijdsduur te verkrijgen vóór het huidige tijdstip.

Syntaxis

DATEADD (DateTimeUnits, OffsetValue, DateTime)

Argumenten

DateTimeUnits-

Hiermee geeft u de eenheden van de parameter DateTime: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE of SECOND. Deze waarde is hoofdlettergevoelig en aanhalingstekens zijn niet vereist rond de parameter.

OffsetValue-

Hiermee geeft u de tijd offset, in de eenheden die zijn opgegeven door de DateTimeUnits parameter. OffsetValue- moet een negatief geheel getal zijn. Positieve waarden worden niet ondersteund.

DateTime-

Hiermee geeft u een tijdstempel van waaruit de offset moet worden berekend. Dit kan geen letterlijke datum zijn. Het moet GETGMTDATE of het resultaat van een andere DATUMADD-functie zijn.

Opmerkingen

De functie DATEADD kan alleen worden gebruikt in letterlijke waardevergelijkingen en alleen aan de rechterkant van de vergelijkingsoperator.

De functie GETGMTDATE retourneert de huidige datum en tijd in Greenwich Mean Time (GMT). Houd er rekening mee dat deze waarde mogelijk niet hetzelfde is als de lokale tijd van uw computer.

Gebruik de vergelijkingsoperator (=) niet, omdat de interne tijdweergave afrondingsfouten kan opleveren die resulteren in onverwachte overeenkomende resultaten.

U kunt meerdere DATEADD-functies gebruiken om offseteenheden te combineren.

Voorbeelden

Het volgende voorbeeld van de WHERE-component komt overeen met documenten die zijn gewijzigd in de afgelopen vijf dagen:

...WHERE System.DateModified <=DATEADD (DAY, -5, GETGMTDATE())

Het volgende voorbeeld van de WHERE-component komt overeen met documenten die zijn gewijzigd binnen de afgelopen twee dagen en vier uur:

...WHERE System.DateModified <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))

vergelijking van letterlijke waarden

vergelijkingen met meerdere waarden (MATRIX)

conceptuele

Full-Text predicaten

Niet-Full-Text Predicaten