Partage via

BETWEEN (Transact-SQL)

  • Article

S’applique à :SQL ServerBase de données Azure SQLAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Point de terminaison d'analyse SQL dans Microsoft FabricEntrepôt dans Microsoft FabricBase de données SQL dans 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

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

NOT

Spécifie que le résultat du prédicat est supprimé.

begin_expression

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

end_expression

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 de retour

Booléen

Remarques

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.

Pour spécifier un intervalle exclusif, employez les opérateurs « supérieur à » (>) et « inférieur à » (<). Si une entrée au prédicat BETWEEN ou NOT BETWEEN est NULL, le résultat dépend des résultats des parties constituantes.

Dans l’exemple suivant test_expression >= begin_expression AND test_expression <= end_expression, si l’une ou l’autre partie est FALSE, l’expression BETWEEN globale prend la valeur FALSE. Sinon, l’expression prend la valeur UNKNOWN.

Exemples

Les exemples de code de cet article utilisent l’exemple de base de données AdventureWorks2022 ou AdventureWorksDW2022, que vous pouvez télécharger à partir de la page d’accueil Microsoft SQL Server Samples and Community Projects.

R. Utiliser 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';

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

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
------------  ----
16385         db_accessadmin
16386         db_securityadmin
16387         db_ddladmin
16389         db_backupoperator
16390         db_datareader

B. Utilisez > et < au lieu de BETWEEN

L’exemple suivant utilise des opérateurs supérieurs à (>) et inférieurs à (<) et, étant donné que ces opérateurs ne sont pas inclusifs, retourne neuf lignes au lieu de 10 qui ont été retournées dans l’exemple précédent.

SELECT e.FirstName,
       e.LastName,
       ep.Rate
FROM HumanResources.vEmployee AS e
     INNER JOIN HumanResources.EmployeePayHistory AS 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. Utiliser NOT BETWEEN

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

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

D. Utiliser 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.

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 de la requête et le datetime valeurs stockées dans la colonne RateChangeDate sont spécifiées sans la partie heure de la date. Lorsque la partie de temps n’est pas spécifiée, la valeur par défaut est 12:00 A.M. Une ligne qui contient une partie de temps qui se trouve après 12:00 A.M. le 5 janvier 2002, n’est pas retournée par cette requête, car elle se trouve en dehors de la plage.

Contenu connexe