LEFT (Transact-SQL)
Retourne la partie de gauche d'une chaîne de caractères avec le nombre spécifié de caractères.
Conventions de syntaxe de Transact-SQL
Syntaxe
LEFT ( character_expression , integer_expression )
Arguments
character_expression
Expression de type caractère ou binaire. character_expression peut être une constante, une variable ou une colonne. character_expression peut être de tout type de données, à l'exception de text ou de ntext, implicitement convertible en varchar ou en nvarchar. Sinon, utilisez la fonction CAST pour convertir explicitement character_expression.
integer_expression
Entier positif qui spécifie le nombre de caractères de character_expression à retourner. Si integer_expression est négatif, une erreur est retournée. integer_expression peut être de type bigint.
Notes
Les niveaux de compatibilité peuvent affecter les valeurs retournées. Pour plus d'informations sur les niveaux de compatibilité, consultez sp_dbcmptlevel (Transact-SQL).
Types de retour
varchar ou nvarchar
Exemples
A. Utilisation de LEFT avec une colonne
L'exemple suivant retourne les cinq caractères les plus à gauche du nom de chaque produit.
USE AdventureWorks;
GO
SELECT LEFT(Name, 5)
FROM Production.Product
ORDER BY ProductID;
GO
B. Utilisation de LEFT avec une chaîne de caractères
L'exemple suivant utilise LEFT
pour retourner les deux caractères les plus à gauche de la chaîne de caractères LEFT
.
SELECT LEFT('abcdefg',2)
GO
Voici l'ensemble des résultats.
--
ab
(1 row(s) affected)
Voir aussi
Référence
Types de données (Transact-SQL)
Fonctions de chaîne (Transact-SQL)