BETWEEN (Transact-SQL)

Article
08/20/2013

Définit un intervalle sur lequel la recherche doit porter.

Icône Lien de rubrique Conventions de syntaxe Transact-SQL

Syntaxe

test_expression [ NOT ] BETWEEN begin_expression AND end_expression

Arguments

test_expression
Expression à rechercher dans l'intervalle défini par les paramètres begin_expressionet end_expression. test_expression doit avoir le même type que begin_expression et end_expression.
NOT
Indique la négation du résultat du prédicat.
begin_expression
Toute expression valide. begin_expression doit avoir le même type que test_expression et end_expression.
end_expression
Toute expression valide. end_expression doit avoir le même type que test_expressionet begin_expression.
AND
Espace réservé qui indique que test_expression doit être recherché dans l'intervalle défini par begin_expression et end_expression.

Types de résultats

Boolean

Valeur des résultats

BETWEEN renvoie TRUE si la valeur de test_expression est supérieure ou égale à celle de begin_expression et inférieure ou égale à celle de end_expression.

NOT BETWEEN retourne le résultat TRUE si la valeur de test_expression est inférieure à celle de begin_expression ou supérieure à celle de end_expression.

Notes

Pour spécifier un intervalle exclusif, employez les opérateurs « supérieur à » (>) et « inférieur à » (<). Si l'un des paramètres fournis avec le prédicat BETWEEN ou NOT BETWEEN a la valeur NULL, le résultat est UNKNOWN.

Exemples

A.Utilisation de BETWEEN

L'exemple suivant retourne les employés de Adventure Works Cycles dont le salaire horaire est compris entre 27 et 30.

USE AdventureWorks2012;
GO
SELECT e.FirstName, e.LastName, ep.Rate
FROM HumanResources.vEmployee e 
JOIN HumanResources.EmployeePayHistory ep 
    ON e.BusinessEntityID = ep.BusinessEntityID
WHERE ep.Rate BETWEEN 27 AND 30
ORDER BY ep.Rate;
GO

Voici l'ensemble des résultats.

FirstName LastName Rate

----------- ------------------ ------------------

Paula Barreto de Mattos 27.1394

Karen Berg 27.4038

Ramesh Meyyappan 27.4038

Dan Bacon 27.4038

Janaina Bueno 27.4038

David Bradley 28.7500

Hazem Abolrous 28.8462

Ovidiu Cracium 28.8462

Rob Walters 29.8462

Sheela Word 30.0000

(10 row(s) affected)

B.Utilisation de > et de < à la place de BETWEEN

L'exemple suivant utilise les opérateurs « supérieur à » (>) et « inférieur à » (<) ; ceux-ci n'étant pas inclusifs, il retourne neuf lignes au lieu des dix retournées dans l'exemple précédent.

USE AdventureWorks2012;
GO

SELECT e.FirstName, e.LastName, ep.Rate
FROM HumanResources.vEmployee e 
JOIN HumanResources.EmployeePayHistory ep 
    ON e.BusinessEntityID = ep.BusinessEntityID
WHERE ep.Rate > 27 AND ep.Rate < 30
ORDER BY ep.Rate;
GO

Voici l'ensemble des résultats.

FirstName LastName Rate

--------- ------------------- ---------

Paula Barreto de Mattos 27.1394

Janaina Bueno 27.4038

Dan Bacon 27.4038

Ramesh Meyyappan 27.4038

Karen Berg 27.4038

David Bradley 28.7500

Hazem Abolrous 28.8462

Ovidiu Cracium 28.8462

Rob Walters 29.8462

(9 row(s) affected)

C.Utilisation de NOT BETWEEN

L'exemple suivant recherche toutes les lignes situées en dehors d'une plage spécifiée allant de 27 à 30.

USE AdventureWorks2012;
GO
SELECT e.FirstName, e.LastName, ep.Rate
FROM HumanResources.vEmployee e 
JOIN HumanResources.EmployeePayHistory ep 
    ON e.BusinessEntityID = ep.BusinessEntityID
WHERE ep.Rate NOT BETWEEN 27 AND 30
ORDER BY ep.Rate;
GO

D.Utilisation de BETWEEN avec des valeurs datetime

L'exemple suivant récupère des lignes dans lesquelles les valeurs datetime sont situées entre '20011212' inclus et '20020105' inclus.

USE AdventureWorks2012;
GO
SELECT BusinessEntityID, RateChangeDate
FROM HumanResources.EmployeePayHistory
WHERE RateChangeDate BETWEEN '20011212' AND '20020105';

Voici l'ensemble des résultats.

BusinessEntityID RateChangeDate

----------- -----------------------

3 2001-12-12 00:00:00.000

4 2002-01-05 00:00:00.000

La requête récupère les lignes attendues car les valeurs de date dans la requête et les valeurs datetime stockées dans la colonne RateChangeDate ont été spécifiées sans la partie heure de la date. Lorsque la partie heure n'est pas spécifiée, la valeur par défaut est 12:00 A.M. Notez qu'une ligne qui contient une heure ultérieure à 12h00 le 5 janvier 2002 ne serait pas retournée par cette requête car cette date se situe hors de la plage.