Fonction DATEADD
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 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 : YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE ou SECOND. Cette valeur respecte la casse et les guillemets ne sont pas obligatoires 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 s’agir de GETGMTDATE ou du résultat d’une autre fonction DATEADD.
Notes
La fonction DATEADD peut être utilisée uniquement 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 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 à des 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 à 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()))
Rubriques connexes
-
Informations de référence
-
Conceptuel