DATEADD (Transact-SQL)

Mis à jour : 14 avril 2006

Retourne une nouvelle valeur datetime calculée en ajoutant un intervalle à la date spécifiée.

Conventions de la syntaxe de Transact-SQL

Syntaxe

DATEADD (datepart , number, date )

Arguments

• datepart
  Paramètre qui indique la partie de date à retourner modifiée. Le tableau suivant décrit les parties de date et les abréviations reconnues par Microsoft SQL Server 2005.

  Partie de date	Abréviations
  year	yy, yyyy
  quarter	qq, q
  month	mm, m
  dayofyear	dy, y
  day	dd, d
  week	wk, ww
  weekday	dw, w
  hour	hh
  minute	mi, n
  second	ss, s
  millisecond	ms

• number
  Valeur utilisée pour incrémenter datepart. Si vous indiquez une valeur non entière, sa fraction est rejetée. Par exemple, si vous spécifiez day pour datepart et 1,75 pour number, la valeur de date est incrémentée de 1.

• date
  expression qui retourne une valeur datetime ou smalldatetime, ou une chaîne de caractères dans un format de date. Pour plus d'informations sur la spécification des dates, consultez Date et Time (Transact-SQL).

  Si vous précisez seulement les deux derniers chiffres de l'année, les valeurs inférieures ou égales aux deux derniers chiffres de la valeur de l'option de configuration two digit year cutoff appartiennent au même siècle que l'année de coupure. Les valeurs supérieures aux deux derniers chiffres de la valeur de cette option appartiennent au siècle qui précède l'année de coupure. Par exemple, si l'option two-digit year cutoff a pour valeur 2049 (valeur par défaut), 49 est interprété comme 2049 et 50 est interprété comme 1950. Pour éviter toute ambiguïté, écrivez les années à l'aide de quatre chiffres.

Notes

Lorsque datepart est un mois, le nombre de jours dans le mois affecte le résultat. Par exemple, le mois d'août comporte 31 jours, tandis que le mois de septembre n'en comporte que 30. Les deux instructions suivantes retournent 2006-09-30 00:00:00.000.

SELECT DATEADD(month, 1, '08/30/2006')
SELECT DATEADD(month, 1, '08/31/2006')

Autrement dit, l'ajout d'un mois à la fin du mois d'août retourne le dernier jour de septembre.

Types des valeurs renvoyées

Retourne datetime, mais smalldatetime si l'argument date a pour valeur smalldatetime.

Exemple

L'exemple suivant dresse la liste des délais pour les commandes de la base de données AdventureWorks. Ces délais sont calculés en ajoutant 21 jours aux dates des commandes existantes.

USE AdventureWorks;
GO
SELECT DATEADD(day, 21, OrderDate)AS TimeFrame 
FROM Sales.SalesOrderHeader;
GO

Voir aussi

Référence

CAST et CONVERT (Transact-SQL)
Types de données (Transact-SQL)
Fonctions de date et d'heure (Transact-SQL)

Autres ressources

Format ISO 8601
Format de date alphabétique
Format de date numérique
Format de date et d'heure ODBC
Formats d'heure
Format de chaîne non séparée

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications