LEFT (Transact-SQL)

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

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

LEFT ( character_expression , integer_expression )

Argumentos

  • character_expression
    Es una expresión de datos binarios o de caracteres. character_expression puede ser una constante, una variable o una columna. El tipo de datos de character_expression puede ser cualquiera, excepto text o ntext, que se pueda convertir implícitamente a varchar o 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).

    El parámetro integer_expression cuenta un carácter suplente UTF 16 como un carácter.

Tipos de valores 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.

Comentarios

Al utilizar las intercalaciones de SC, el parámetro integer_expression cuenta un par suplente UTF 16 como un carácter. Para obtener más información, vea Compatibilidad con la intercalación y Unicode.

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 AdventureWorks2012;
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

El conjunto de resultados es el siguiente.

-- 
ab 

(1 row(s) affected)

Vea también

Referencia

CAST y CONVERT (Transact-SQL)

Tipos de datos (Transact-SQL)

Funciones de cadena (Transact-SQL)