Skip to content

right-transact-sql.md

Latest commit

 

History

History
139 lines (108 loc) · 4.84 KB

right-transact-sql.md

File metadata and controls

139 lines (108 loc) · 4.84 KB

title: "RIGHT (Transact-SQL) | Microsoft Docs" ms.custom: "" ms.date: "03/13/2017" ms.prod: "sql" ms.prod_service: "database-engine, sql-database, sql-data-warehouse, pdw" ms.service: "" ms.component: "t-sql|functions" ms.reviewer: "" ms.suite: "sql" ms.technology:

  • "database-engine" ms.tgt_pltfrm: "" ms.topic: "language-reference" f1_keywords:
  • "RIGHT_TSQL"
  • "RIGHT" dev_langs:
  • "TSQL" helpviewer_keywords:
  • "rightmost character of expression"
  • "RIGHT function"
  • "character strings [SQL Server], RIGHT" ms.assetid: 43f1fe1f-aa18-47e3-ba20-e03e32254a6d caps.latest.revision: 37 author: "edmacauley" ms.author: "edmaca" manager: "craigg" ms.workload: "Active" monikerRange: ">= aps-pdw-2016 || = azuresqldb-current || = azure-sqldw-latest || >= sql-server-2016 || = sqlallproducts-allversions"

RIGHT (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-all-md]

Returns the right part of a character string with the specified number of characters.

Topic link icon Transact-SQL Syntax Conventions

Syntax

RIGHT ( 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 character_expression will be returned. If integer_expression is negative, an error is returned. If integer_expression is type bigint and contains a large value, character_expression must be of a large data type such as varchar(max).

Return Types

Returns varchar when character_expression is a non-Unicode character data type.

Returns nvarchar when character_expression is a Unicode character data type.

Supplementary Characters (Surrogate Pairs)

When using SC collations, the RIGHT function counts a UTF-16 surrogate pair as a single character. For more information, see Collation and Unicode Support.

Examples

A: Using RIGHT with a column

The following example returns the five rightmost characters of the first name for each person in the [!INCLUDEssSampleDBnormal] database.

SELECT RIGHT(FirstName, 5) AS 'First Name'  
FROM Person.Person  
WHERE BusinessEntityID < 5  
ORDER BY FirstName;  
GO

[!INCLUDEssResult]

First Name  
----------  
Ken  
Terri  
berto  
Rob  
  
(4 row(s) affected)

Examples: [!INCLUDEssSDWfull] and [!INCLUDEssPDW]

B. Using RIGHT with a column

The following example returns the five rightmost characters of each last name in the DimEmployee table.

-- Uses AdventureWorks  
  
SELECT RIGHT(LastName, 5) AS Name  
FROM dbo.DimEmployee  
ORDER BY EmployeeKey;

Here is a partial result set.

Name
-----
lbert
Brown
rello
lters

C. Using RIGHT with a character string

The following example uses RIGHT to return the two rightmost characters of the character string abcdefg.

-- Uses AdventureWorks  
  
SELECT TOP(1) RIGHT('abcdefg',2) FROM dbo.DimProduct;

[!INCLUDEssResult]

-------  
fg

See Also

LEFT (Transact-SQL)
LTRIM (Transact-SQL)
RTRIM (Transact-SQL)
STRING_SPLIT (Transact-SQL)
SUBSTRING (Transact-SQL)
TRIM (Transact-SQL)
CAST and CONVERT (Transact-SQL)
Data Types (Transact-SQL)
String Functions (Transact-SQL)