DATEDIFF (Transact-SQL)

Syntaxe

DATEDIFF (datepart ,startdate ,enddate )

Arguments

• datepart
  Partie de startdate et enddate qui spécifie le type de limite traversée. Le tableau suivant répertorie tous les arguments datepart valides. Les équivalents de variables définis par l'utilisateur ne sont pas valides.

  datepart	Abréviation(s)
  year	yy, yyyy
  quarter	qq, q
  month	mm, m
  dayofyear	dy, y
  day	dd, d
  week	wk, ww
  hour	hh
  minute	mi, n
  second	ss, s
  millisecond	ms
  microsecond	mcs
  nanosecond	ns

• startdate
  Expression qui peut être résolue en une valeur time, date, smalldatetime, datetime, datetime2 ou datetimeoffset. date peut être une expression, une expression de colonne, une variable définie par l'utilisateur ou un littéral de chaîne. startdate est soustrait de enddate.

  Pour éviter toute ambiguïté, représentez les années à l'aide de quatre chiffres. Pour plus d'informations sur les années à deux chiffres, consultez Option two digit year cutoff.

• enddate
  Voir startdate.

Type de retour

int

Valeur de retour

• Chaque datepart et ses abréviations retournent la même valeur.

Si la valeur retournée est hors limites pour int (-2 147 483 648 à +2 147 483 647), une erreur est retournée. Pour millisecond, la différence maximale entre startdate et enddate est de 24 jours, 20 heures, 31 minutes et 23.647 secondes. Pour second, la différence maximale est de 68 ans.

Si une valeur d'heure uniquement est assignée à la fois à startdate et enddate et que la datepart n'est pas une datepart d'heure, 0 est retourné.

Un composant de décalage de fuseau horaire de startdate ou endate n'est pas utilisé pour calculer la valeur retournée.

Dans la mesure où smalldatetime n'offre qu'une précision à la minute, lorsque vous utilisez une valeur smalldatetime pour startdate ou enddate, les secondes et millièmes de seconde ont toujours la valeur 0 dans la valeur retournée.

Si une valeur d'heure uniquement est assignée à une variable d'un type de données date, la valeur de la partie date manquante est égale à la valeur par défaut : 1900-01-01. Si une valeur de date uniquement est assignée à une variable d'un type de données date ou heure, la valeur de la partie heure manquante est égale à la valeur par défaut : 00-00-00. Si startdate ou enddate a uniquement une partie heure et que l'autre a uniquement une partie date, les parties heure et date manquantes sont égales aux valeurs par défaut.

Si startdate et enddate sont de types de données date différents et que l'un a plus de parties heure ou une meilleure précision en fractions de seconde que l'autre, les parties manquantes de l'autre prennent la valeur 0.

Notes

DATEDIFF peut être utilisé dans la liste de sélection et les clauses WHERE, HAVING, GROUP BY et ORDER BY. Dans SQL Server 2008, DATEDIFF convertit des littéraux de chaîne implicitement comme types datetime2. Lorsque vous utilisez DATEDIFF avec DATEADD, évitez des conversions implicites de littéraux de chaîne. Pour plus d'informations, consultez DATEADD (Transact-SQL).

Exemples

Les exemples suivants utilisent différents types d'expressions comme arguments pour les paramètres startdate et enddate.

A. Spécification de colonnes pour les dates de début et de fin

CREATE TABLE dbo.Duration
    (
    startDate datetime2
    ,endDate datetime2
    )
INSERT INTO dbo.Duration(startDate,endDate)
    VALUES('2007-05-06 12:10:09','2007-05-07 12:10:09')
SELECT DATEDIFF(day,startDate,endDate) AS 'Duration'
FROM dbo.Duration;
-- Returns: 1

B. Spécification de variables définies par l'utilisateur pour les dates de début et de fin

DECLARE @startdate datetime2 = '2007-05-05 12:10:09.3312722';
DECLARE @enddate datetime2 = '2007-05-04 12:10:09.3312722'; 
SELECT DATEDIFF(day, @startdate, @enddate);

C. Spécification de fonctions système scalaires pour les dates de début et de fin

SELECT DATEDIFF(millisecond, GETDATE(), SYSDATETIME());

D. Spécification de sous-requêtes scalaires et de fonctions scalaires pour les dates de début et de fin

USE AdventureWorks;
GO
SELECT DATEDIFF(day,(SELECT MIN(OrderDate) FROM Sales.SalesOrderHeader),
    (SELECT MAX(OrderDate) FROM Sales.SalesOrderHeader));

A. Spécification de constantes pour les dates de début et de fin

SELECT DATEDIFF(day, '2007-05-07 09:53:01.0376635'
    , '2007-05-08 09:53:01.0376635');

F. Spécification d'expressions numériques et de fonctions système scalaires pour la date de fin

USE AdventureWorks;
GO
SELECT DATEDIFF(day, '2007-05-07 09:53:01.0376635', GETDATE()+ 1) 
    AS NumberOfDays
FROM Sales.SalesOrderHeader;
GO
USE AdventureWorks;
GO
SELECT DATEDIFF(day, '2007-05-07 09:53:01.0376635', DATEADD(day,1,SYSDATETIME())) AS NumberOfDays
FROM Sales.SalesOrderHeader;
GO

G. Spécification de fonctions de classement pour la date de début

USE AdventureWorks;
GO
SELECT c.FirstName, c.LastName
    ,DATEDIFF(day,ROW_NUMBER() OVER (ORDER BY 
        a.PostalCode),SYSDATETIME()) AS 'Row Number'
FROM Sales.SalesPerson s 
    INNER JOIN Person.Contact c 
        ON s.SalesPersonID = c.ContactID
    INNER JOIN Person.Address a 
        ON a.AddressID = c.ContactID
WHERE TerritoryID IS NOT NULL 
    AND SalesYTD <> 0;

H. Spécification d'une fonction d'agrégation pour la date de début

USE AdventureWorks;
GO
SELECT soh.SalesOrderID, sod.ProductID, sod.OrderQty,soh.OrderDate
    ,DATEDIFF(day,MIN(soh.OrderDate) 
        OVER(PARTITION BY soh.SalesOrderID),SYSDATETIME() ) AS 'Total'
FROM Sales.SalesOrderDetail sod
    INNER JOIN Sales.SalesOrderHeader soh
        ON sod.SalesOrderID = soh.SalesOrderID
WHERE soh.SalesOrderID IN(43659,58918);
GO

Voir aussi

Référence