DATEADD, fonction dans la syntaxe SQL de recherche SharePoint
Dernière modification : mercredi 21 avril 2010
S’applique à : SharePoint Server 2010
Effectue des calculs de date et d'heure pour assortir les propriétés ayant des types date.
DATEADD (DateTimeUnits, OffsetValue, DateTime)
Paramètres
Utilisez la fonction DATEADD pour obtenir des dates et des heures dans une période de temps donnée antérieure au présent.
DateTimeUnits spécifie les unités du paramètre DateTimeValue. Ce peut être « ANNÉE », « TRIMESTRE », « MOIS », « SEMAINE », « JOUR », « HEURE », « MINUTE », ou « SECONDE ». Cette valeur respecte la casse. Le paramètre n'a pas à être mis entre guillemets.
OffsetValue spécifie le décalage temporel, 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 est un horodatage à partir duquel il faut calculer le décalage. Ce ne peut pas être un littéral de date. Il doit être GETGMTDATE ou le résultat d'une autre fonction DATEADD.
Remarques
La fonction DATEADD ne peut être utilisée que dans les comparaisons de valeur littérales et uniquement du côté droit de l'opérateur de comparaison.
La fonction GETGMTDATE retourne la date et l'heure actuelles en heure de Greenwich (GMT). N'oubliez pas que cette valeur ne peut pas être le même que l'heure locale de votre ordinateur.
Vous pouvez utiliser plusieurs fonctions DATEADD pour combiner les unités de décalage.
Notes
N'utilisez pas l'opérateur de comparaison égal (=), car la représentation de l'heure interne peut générer des erreurs d'arrondi qui entraînent des résultats inattendus correspondants.
Exemples
L'exemple de clause WHERE suivant correspond aux documents qui ont été modifiés lors des cinq derniers jours :
...WHERE LastModifiedTime <=DATEADD (DAY, -5, GETGMTDATE())
L'exemple de clause WHERE suivant correspond aux documents qui ont été modifiés dans les deux jours et quatre heures qui précèdent :
...WHERE LastModifiedTime <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))
Voir aussi
Référence
Prédicats qui ne sont pas en texte intégral dans la syntaxe SQL de la recherche SharePoint
Comparaison de valeurs littérales dans la syntaxe SQL de recherche SharePoint