Compartilhar via


LEFT (Transact-SQL)

Retorna a parte da esquerda de uma cadeia de caracteres com o número de caracteres especificado.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

LEFT ( character_expression , integer_expression )

Argumentos

  • character_expression
    É uma expressão de dados de caractere ou binários. character_expression pode ser uma constante, variável ou coluna. character_expression pode ser de qualquer tipo de dados, com exceção de text ou ntext, que possam ser implicitamente convertidos 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).

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

Os níveis de compatibilidade podem afetar os valores de retorno. Para obter mais informações sobre níveis de compatibilidade, consulte sp_dbcmptlevel (Transact-SQL).

Exemplos

A. Usando LEFT com uma coluna

O exemplo a seguir retorna os cinco caracteres mais à esquerda do nome de cada produto.

USE AdventureWorks;
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

Conjunto de resultados.

-- 
ab 

(1 row(s) affected)