LEFT (Transact-SQL)

Devuelve la parte izquierda de una cadena de caracteres con el número de caracteres especificado.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

LEFT ( character_expression , integer_expression )

Argumentos

  • character_expression
    Es una expresión de datos de caracteres o binarios. character_expression puede ser una constante, variable o columna. El tipo de datos de character_expression puede ser cualquiera, excepto text y ntext, que se pueda convertir implícitamente a varchar y nvarchar. De lo contrario, utilice la función CAST para convertir character_expression explícitamente.

  • integer_expression
    Es un entero positivo que especifica cuántos caracteres de character_expression se van a devolver. Si integer_expression es negativo, se devuelve un error. Si integer_expression es del tipo bigint y contiene un valor grande, character_expression debe ser de un tipo de datos de valor grande como varchar(max).

Tipos de valor devueltos

Devuelve varchar cuando character_expression es de un tipo de datos de caracteres no Unicode.

Devuelve nvarchar cuando character_expression es de un tipo de datos de caracteres Unicode.

Notas

Los niveles de compatibilidad pueden afectar a los valores devueltos. Para obtener más información acerca de los niveles de compatibilidad, vea sp_dbcmptlevel (Transact-SQL).

Ejemplos

A. Utilizar LEFT con una columna

En el ejemplo siguiente se devuelven los cinco caracteres situados más a la izquierda de cada nombre de producto.

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

B. Utilizar LEFT con una cadena de caracteres

En el ejemplo siguiente se utiliza LEFT para devolver los dos caracteres situados más a la izquierda de la cadena de caracteres abcdefg.

SELECT LEFT('abcdefg',2)
GO

Éste es el conjunto de resultados.

-- 
ab 

(1 row(s) affected)