LEFT (Transact-SQL)
Retorna a parte da esquerda de uma cadeia de caracteres com o número de caracteres especificado.
.gif "Ícone de vínculo de tópico")
Convenções de sintaxe Transact-SQL
Sintaxe
LEFT ( character_expression , integer_expression )
Argumentos
character_expression
É uma expressão de dados binários ou de caracteres. character_expression pode ser uma constante, variável ou coluna. character_expression pode ser qualquer tipo de dados, exceto text ou ntext, que pode ser implicitamente convertido em varchar ou nvarchar. Caso contrário, use a função CAST para converter explicitamente a character_expression.integer_expression
É um inteiro positivo que especifica quantos caracteres da character_expression serão retornados. Se integer_expression for negativo, será retornado um erro. Se integer_expression for do tipo bigint e contiver um valor grande, character_expression deverá ter um tipo de dados grande, como varchar(max).O parâmetro integer_expression conta um caractere alternativo de UTF-16 como um caractere.
Tipos de retorno
Retorna varchar quando character_expression é de um tipo de dados de caractere não Unicode.
Retorna nvarchar quando character_expression é de um tipo de dados de caractere Unicode.
Comentários
Durante o uso de agrupamentos SC, o parâmetro integer_expression conta um par substituto UTF-16 como um caractere. Para obter mais informações, consulte Suporte a agrupamentos e a Unicode.
Exemplos
A.Usando LEFT com uma coluna
O exemplo a seguir retorna os cinco caracteres mais à esquerda do nome de cada produto.
USE AdventureWorks2012;
GO
SELECT LEFT(Name, 5)
FROM Production.Product
ORDER BY ProductID;
GO
B.Usando LEFT com uma cadeia de caracteres
O exemplo a seguir usa LEFT para retornar os dois caracteres mais à esquerda da cadeia de caracteres abcdefg.
SELECT LEFT('abcdefg',2)
GO
Aqui está o conjunto de resultados.
--
ab
(1 row(s) affected)