BETWEEN (Transact-SQL)

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)SQL analytics endpoint in Microsoft FabricWarehouse in Microsoft Fabric

Specifica un intervallo da testare.

Convenzioni di sintassi Transact-SQL

Sintassi

test_expression [ NOT ] BETWEEN begin_expression AND end_expression  

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

test_expression
Espressione da testare nell'intervallo definito da begin_expression e end_expression. test_expression deve essere dello stesso tipo di dati di begin_expression e end_expression.

NOT
Specifica che il risultato del predicato viene negato.

begin_expression
Qualsiasi espressione valida. begin_expression deve essere dello stesso tipo di dati di test_expression e end_expression.

end_expression
Qualsiasi espressione valida. end_expression deve essere dello stesso tipo di dati di test_expression e begin_expression.

E
Fa da segnaposto e indica che test_expression deve essere compreso nell'intervallo delimitato da begin_expression e end_expression.

Tipi restituiti

Boolean

Valore restituito

BETWEEN restituisce TRUE se il valore di test_expression è maggiore o uguale al valore di begin_expression e minore o uguale al valore di end_expression.

NOT BETWEEN restituisce TRUE se il valore di test_expression è minore del valore di begin_expression o maggiore del valore di end_expression.

Osservazioni:

Per specificare un intervallo esclusivo, usare gli operatori Maggiore di (>) e Minore di (<). Se l'input per il predicato BETWEEN o NOT BETWEEN è NULL, il risultato è UNKNOWN.

Esempi

R. Utilizzo di BETWEEN

Nell'esempio seguente vengono restituite informazioni sui ruoli di database in un database. La prima query restituisce tutti i ruoli. Il secondo esempio usa la clausola BETWEEN per limitare i ruoli ai valori database_id specificati.

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  

Questo è il set di risultati.

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. Utilizzo di > e < al posto di BETWEEN

Nell'esempio seguente vengono utilizzati gli operatori maggiore di (>) e minore di (<) e, poiché non sono operatori inclusivi, vengono restituite nove righe anziché le dieci restituite nell'esempio precedente.

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

Questo è il set di risultati.

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. Utilizzo di NOT BETWEEN

Nell'esempio seguente vengono trovate tutte le righe che non rientrano nell'intervallo da 27 a 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. Utilizzo di BETWEEN tra valori datetime

Nell'esempio seguente vengono recuperate le righe con valori datetime compresi tra '20011212' e '20020105', entrambi inclusi.

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

Questo è il set di risultati.

BusinessEntityID RateChangeDate  
----------- -----------------------  
3           2001-12-12 00:00:00.000  
4           2002-01-05 00:00:00.000  

La query recupera le righe previste poiché i valori di data nella query e i valori datetime archiviati nella colonna RateChangeDate sono stati specificati senza la parte della data relativa all'ora. Quando la parte relativa all'ora viene omessa, il valore predefinito corrisponde a 00.00. Si noti che una riga contenente una parte dell'ora successiva alle 00.00 del 5 gennaio 2002 non verrà restituita dalla query, poiché non inclusa nell'intervallo.

Vedi anche

>(maggiore di) (Transact-SQL)
< (minore di) (Transact-SQL)
Espressioni (Transact-SQL)
Funzioni predefinite (Transact-SQL)
Operatori (Transact-SQL)
SELECT (Transact-SQL)
WHERE (Transact-SQL)