• Articolo

LEFT (Transact-SQL)

Restituisce la parte iniziale di una stringa di caratteri, di lunghezza pari al numero di caratteri specificato.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

LEFT ( character_expression , integer_expression )

Argomenti

  • character_expression
    Espressione di dati di tipo carattere o binario. character_expression può essere una constante, una variabile o una colonna. Il tipo di dati di character_expression può essere qualsiasi tipo di dati, eccetto text o ntext, convertibile in modo implicito in varchar o nvarchar. In caso contrario, utilizzare la funzione CAST per convertire in modo esplicito character_expression.

  • integer_expression
    Intero positivo che specifica quanti caratteri dell'espressione character_expression verranno restituiti. Se l'argomento integer_expression è negativo, viene restituito un errore. Se integer_expression è di tipo bigint e contiene un valore di grandi dimensioni, character_expression deve essere di un tipo di dati di grandi dimensioni, ad esempio varchar(max).

Tipi restituiti

Restituisce varchar quando character_expression è un tipo di dati carattere non Unicode.

Restituisce nvarchar quando character_expression è un tipo di dati carattere Unicode.

Osservazioni

I livelli di compatibilità possono influire sui valori restituiti. Per ulteriori informazioni sui livelli di compatibilità, vedere sp_dbcmptlevel (Transact-SQL).

Esempi

A. Utilizzo di LEFT con una colonna

Nell'esempio seguente vengono restituiti i primi cinque caratteri di ogni nome di prodotto.

USE AdventureWorks;
GO
SELECT LEFT(Name, 5) 
FROM Production.Product
ORDER BY ProductID;
GO

B. Utilizzo di LEFT con una stringa di caratteri

Nell'esempio seguente viene utilizzata la funzione LEFT per ottenere i primi due caratteri della stringa di caratteri abcdefg.

SELECT LEFT('abcdefg',2)
GO

Set di risultati:

-- 
ab 

(1 row(s) affected)