BETWEEN (Transact-SQL)

S’applique à : ouiSQL Server (toutes les versions prises en charge) OuiAzure SQL Database OuiAzure SQL Managed Instance ouiAzure Synapse Analytics ouiParallel Data Warehouse

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

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

Syntaxe

test_expression [ NOT ] BETWEEN begin_expression AND end_expression  

Notes

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 et versions antérieures, consultez Versions antérieures de la documentation.

Arguments

test_expression
Correspond à l’expression à tester dans la plage définie par begin_expression et end_expression. test_expression doit être du même type de données que begin_expression et end_expression.

NOT
Indique la négation du résultat du prédicat.

begin_expression
Peut être toute expression valide. begin_expression doit être du même type de données que test_expression et end_expression.

end_expression
Peut être toute expression valide. end_expression doit être du même type de données que test_expression et begin_expression.

AND
Agit en tant qu’espace réservé qui indique que test_expression doit se trouver dans la plage indiquée par begin_expression et end_expression.

Types des résultats

Booléen

Valeur des résultats

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

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

Remarques

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

R. Utilisation de BETWEEN

L’exemple suivant retourne des informations sur les rôles de base de données dans une base de données. La première requête retourne tous les rôles. Le deuxième exemple utilise la clause BETWEEN pour limiter les rôles aux valeurs database_id spécifiées.

SELECT principal_id, name 
FROM sys.database_principals
WHERE type = 'R';

SELECT principal_id, name 
FROM sys.database_principals
WHERE type = 'R'
AND principal_id BETWEEN 16385 AND 16390;
GO  

Voici le jeu de résultats obtenu.

principal_id    name
------------  ---- 
0               public
16384           db_owner
16385           db_accessadmin
16386           db_securityadmin
16387           db_ddladmin
16389           db_backupoperator
16390           db_datareader
16391           db_datawriter
16392           db_denydatareader
16393           db_denydatawriter
principal_id    name
------------  ---- 
16385           db_accessadmin
16386           db_securityadmin
16387           db_ddladmin
16389           db_backupoperator
16390           db_datareader

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.

-- Uses AdventureWorks  
  
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 le jeu de résultats obtenu.

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  

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.

-- Uses AdventureWorks  
  
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 les lignes dans lesquelles les valeurs datetime sont situées entre '20011212' et '20020105' incluses.

-- Uses AdventureWorks  
  
SELECT BusinessEntityID, RateChangeDate  
FROM HumanResources.EmployeePayHistory  
WHERE RateChangeDate BETWEEN '20011212' AND '20020105';  

Voici le jeu de résultats obtenu.

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.

Voir aussi

> (Supérieur à) (Transact-SQL)
< (Inférieur à) (Transact-SQL)
Expressions (Transact-SQL)
Fonctions intégrées (Transact-SQL)
Opérateurs (Transact-SQL)
SELECT (Transact-SQL)
WHERE (Transact-SQL)