DATEADD, fonction
La fonction DATEADD effectue des calculs d’heure et de date pour les propriétés correspondantes ayant des types de date. Utilisez la fonction DATEADD pour obtenir des dates et des heures dans une durée spécifiée avant le présent.
Syntaxe
DATEADD (DateTimeUnits, OffsetValue, DateTime)
Arguments
DateTimeUnits
Spécifie les unités du paramètre DateTime : YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE ou SECOND. Cette valeur respecte la casse et les guillemets ne sont pas requis autour du paramètre.
OffsetValue
Spécifie le décalage d’heure, 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 être GETGMTDATE ou le résultat d’une autre fonction DATEADD.
Remarques
La fonction DATEADD peut être utilisée uniquement dans les comparaisons de valeurs littérales et uniquement sur le côté droit de l’opérateur de comparaison.
La fonction GETGMTDATE retourne la date et l’heure actuelles dans l’heure moyenne de Greenwich (GMT). N’oubliez pas que cette valeur peut ne pas être identique à 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 entraînent des résultats de correspondance inattendus.
Vous pouvez utiliser plusieurs fonctions DATEADD pour combiner des unités de décalage.
Exemples
L’exemple de clause WHERE suivant correspond aux documents qui ont été modifiés au cours des cinq derniers jours :
...WHERE System.DateModified <=DATEADD (DAY, -5, GETGMTDATE())
L’exemple de clause WHERE suivant correspond aux 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()))
Rubriques connexes
-
de référence
-
conceptuelle