Fonction DATEADD

La fonction DATEADD effectue des calculs de date et d’heure pour les propriétés correspondantes ayant des types de date. Utilisez la fonction DATEADD pour obtenir des dates et des heures dans un laps de temps spécifié avant le présent.

Syntaxe

DATEADD (DateTimeUnits, OffsetValue, DateTime)

Arguments

DateTimeUnits

Spécifie les unités du paramètre DateTime : année, trimestre, mois, semaine, jour, heure, minute ou seconde. Cette valeur respecte la casse et les guillemets ne sont pas requis autour du paramètre.

OffsetValue

Spécifie l’offset de temps, dans les unités spécifiées par le paramètre DateTimeUnits . OffsetValue doit être un entier négatif. Les valeurs positives ne sont pas prises en charge.

DateTime

Spécifie un horodatage à partir duquel calculer le décalage. Il ne peut pas s’agir d’un littéral de date. Il doit s’agir de GETGMTDATE ou du résultat d’une autre fonction DATEADD.

Notes

La fonction DATEADD ne peut être utilisée que dans les comparaisons de valeurs littérales et uniquement à droite de l’opérateur de comparaison.

La fonction GETGMTDATE retourne la date et l’heure actuelles en heure GMT (Greenwich Mean Time). N’oubliez pas que cette valeur peut ne pas être la même que l’heure locale de votre ordinateur.

N’utilisez pas l’opérateur de comparaison égal à (=), car la représentation temporelle interne peut produire des erreurs d’arrondi qui aboutissent à des résultats de correspondance inattendus.

Vous pouvez utiliser plusieurs fonctions DATEADD pour combiner des unités de décalage.

Exemples

L’exemple suivant de clause WHERE correspond à des documents qui ont été modifiés au cours des cinq derniers jours :

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

L’exemple suivant de clause WHERE correspond à des documents qui ont été modifiés au cours des deux derniers jours et quatre heures :

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

Informations de référence

Comparaison de valeurs littérales

Comparaisons à valeurs multiples (tableau)

Méthodologique

Prédicats de texte intégral

Prédicats de texte non intégral