BETWEEN (Transact-SQL)

  • Article

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL analytics endpoint in Microsoft Fabric Warehouse in Microsoft Fabric

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

Conventions de la syntaxe Transact-SQL

Syntaxe

test_expression [ NOT ] BETWEEN begin_expression AND end_expression

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.

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.

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.

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 temps n’est pas spécifiée, la valeur par défaut est 12:00. Notez qu’une ligne qui contient une partie temps ultérieure au 05-01-2002 12:00 ne sera pas retournée par cette requête, car elle se trouve en dehors 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)