RTRIM (Transact-SQL)

Se aplica a: SQL Server (todas las versiones admitidas) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Devuelve una cadena de caracteres después de truncar todos los espacios finales.

Quita el carácter de espacio char(32) u otros caracteres especificados del final de una cadena.

Convenciones de sintaxis de Transact-SQL

Sintaxis

RTRIM ( character_expression )

Sintaxis para SQL Server 2022 (16.x) y versiones posteriores:

Importante

Necesitará el nivel de compatibilidad de la base de datos establecido en 160 para usar el argumento de caracteres opcional.

RTRIM ( character_expression , [ characters ] )

Sintaxis para Azure SQL Database:

RTRIM ( character_expression )

Nota

Para ver la sintaxis de Transact-SQL para SQL Server 2014 y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

character_expression

Una expresión de datos binarios o de caracteres. character_expression puede ser una constante, una variable o una columna. character_expression debe ser de un tipo de datos (excepto text, ntext e image) que se pueda convertir implícitamente a varchar. De lo contrario, use CAST para convertir character_expression explícitamente.

characters

Se aplica a: SQL Server 2022 (16.x) y versiones posteriores.

Un literal, una variable o una llamada de función de cualquier tipo de carácter no de LOB (nvarchar, , varchar, nchar, o char) que contiene caracteres que se deben quitar. No se permiten los tipos nvarchar(max) y varchar(max).

Tipos de valores devueltos

varchar o nvarchar

Devuelve una expresión de caracteres con un tipo de argumento de cadena donde el carácter de espacio char(32) u otros caracteres especificados se quitan del final de un character_expression. Devuelve NULL si la cadena de entrada es NULL.

Comentarios

Para habilitar los argumentos posicionales de caracteres, debe habilitar el nivel 160 de compatibilidad de la base de datos en la o las bases de datos a las que se va a conectar al ejecutar consultas.

Ejemplos

A. Quitar los espacios finales.

El siguiente ejemplo toma una cadena de caracteres que tiene espacios al final de la frase y devuelve el texto sin esos espacios.

SELECT RTRIM('Removes trailing spaces.   ');

El conjunto de resultados es el siguiente:

Removes trailing spaces.

B. Quitar espacios finales con una variable

En el ejemplo siguiente se muestra cómo utilizar RTRIM para quitar los espacios finales de una variable de caracteres.

DECLARE @string_to_trim VARCHAR(60);  
SET @string_to_trim = 'Four spaces are after the period in this sentence.    ';  
SELECT @string_to_trim + ' Next string.';  
SELECT RTRIM(@string_to_trim) + ' Next string.';  
GO

El conjunto de resultados es el siguiente:

Four spaces are after the period in this sentence.     Next string.

Four spaces are after the period in this sentence. Next string.

C. Eliminación de los caracteres especificados de ambos lados de la cadena

Importante

Necesitará el nivel de compatibilidad de la base de datos establecido en 160 para usar el argumento de caracteres opcional.

En el ejemplo siguiente se quitan los caracteres abc. del final de la cadena .123abc..

SELECT RTRIM('.123abc.' , 'abc.');

El conjunto de resultados es el siguiente:

.123

Vea también