LEFT (Transact-SQL)

Gibt den linken Teil einer Zeichenfolge mit der angegebenen Anzahl von Zeichen zurück.

Gilt für: SQL Server (SQL Server 2008 bis aktuelle Version), Windows Azure SQL-Datenbank (Ursprüngliche Version bis aktuelle Version).

Transact-SQL-Syntaxkonventionen

Syntax

LEFT ( character_expression , integer_expression )

Argumente

• character_expression
  Ein Ausdruck aus Zeichen oder Binärdaten. character_expression kann eine Konstante, Variable oder Spalte sein. character_expression kann jeden Datentyp mit Ausnahme von text oder ntext aufweisen, der implizit in varchar oder nvarchar konvertiert werden kann. Verwenden Sie in allen anderen Fällen die CAST-Funktion zur expliziten Konvertierung von character_expression.

• integer_expression
  Ist eine positive ganze Zahl, die angibt, wie viele Zeichen von character_expression zurückgegeben werden. Wenn integer_expression negativ ist, wird ein Fehler zurückgegeben. Wenn integer_expression vom Typ bigint ist und einen umfangreichen Wert enthält, muss character_expression von einem Datentyp mit umfangreichen Werten sein, z. B. varchar(max).

  Für den integer_expression-Parameter wird ein UTF-16-Ersatzzeichen als ein Zeichen gezählt.

Rückgabetypen

Gibt varchar zurück, wenn character_expression von einem Nicht-Unicode-Zeichendatentyp ist.

Gibt nvarchar zurück, wenn character_expression von einem Unicode-Zeichendatentyp ist.

Hinweise

Bei Verwendung von SC-Sortierungen zählt der integer_expression-Parameter ein UTF-16-Ersatzpaar als ein Zeichen. Weitere Informationen finden Sie unter Sortierung und Unicode-Unterstützung.

Beispiele

A.Verwenden von LEFT mit einer Spalte

Im folgenden Beispiel werden die fünf am weitesten links stehenden Zeichen jedes Produktnamens in der Product-Tabelle der AdventureWorks2012-Datenbank zurückgegeben.

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

B.Verwenden von LEFT mit einer Zeichenfolge

Im folgenden Beispiel wird LEFT zur Rückgabe der beiden ersten Zeichen der Zeichenfolge abcdefg verwendet.

SELECT LEFT('abcdefg',2);
GO

Dies ist das Resultset.

-- 
ab 

(1 row(s) affected)

Siehe auch

Verweis

CAST und CONVERT (Transact-SQL)

Datentypen (Transact-SQL)

Zeichenfolgenfunktionen (Transact-SQL)