Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Returns the left part of a character string with the specified number of characters.
Transact-SQL Syntax Conventions
Syntax
LEFT ( character_expression , integer_expression )
Arguments
- character_expression
Is an expression of character or binary data. character_expression can be a constant, variable, or column. character_expression can be of any data type, except text or ntext, that can be implicitly converted to varchar or nvarchar. Otherwise, use the CAST function to explicitly convert character_expression.
- integer_expression
Is a positive integer that specifies how many characters of the character_expression will be returned. If integer_expression is negative, an error is returned. integer_expression can be of type bigint.
Return Types
varchar or nvarchar
Remarks
Compatibility levels can affect return values. For more information about compatibility levels, see sp_dbcmptlevel (Transact-SQL).
Examples
A. Using LEFT with a column
The following example returns the five leftmost characters of each product name.
USE AdventureWorks;
GO
SELECT LEFT(Name, 5)
FROM Production.Product
ORDER BY ProductID;
GO
B. Using LEFT with a character string
The following example uses LEFT
to return the two leftmost characters of the character string abcdefg
.
SELECT LEFT('abcdefg',2)
GO
Here is the result set.
--
ab
(1 row(s) affected)
See Also
Reference
Data Types (Transact-SQL)
String Functions (Transact-SQL)