Share via


RIGHT (Transact-SQL)

Retorna a parte da direita de uma cadeia de caracteres com o número de caracteres especificado.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

RIGHT ( character_expression , integer_expression )

Argumentos

  • character_expression
    É uma expressão de dados binários ou de caracteres. character_expression pode ser uma constante, variável ou coluna. character_expression pode ser qualquer tipo de dados, exceto text ou ntext, que pode ser implicitamente convertido em varchar ou nvarchar. Caso contrário, use a função CAST para converter explicitamente a character_expression.

  • integer_expression
    Um inteiro positivo que especifica quantos caracteres de character_expression serão retornados. Se integer_expression for negativo, será retornado um erro. Se integer_expression for do tipo bigint e contiver um valor grande, character_expression deverá ter um tipo de dados grande, como varchar(max).

Tipos de retorno

Retorna varchar quando character_expression é de um tipo de dados de caractere não Unicode.

Retorna nvarchar quando character_expression é de um tipo de dados de caractere Unicode.

Caracteres suplementares (pares substitutos)

Ao usar agrupamentos SC, a função RIGHT conta cada par substituto UTF-16 como um caractere único. Para obter mais informações, consulte Suporte a agrupamentos e a Unicode.

Exemplos

O exemplo a seguir retorna os cinco caracteres mais à direita do nome de cada contato.

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

Aqui está o conjunto de resultados.

First Name
----------
Ken
Terri
berto
Rob

(4 row(s) affected)

Consulte também

Referência

CAST e CONVERT (Transact-SQL)

Tipos de dados (Transact-SQL)

Funções de cadeia de caracteres (Transact-SQL)