LTRIM (Transact-SQL)

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) Punto de conexión de análisis SQL en Microsoft Fabric Almacenamiento en Microsoft Fabric

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

Sintaxis de SQL Server antes de SQL Server 2022 (16.x):

LTRIM ( character_expression )

Sintaxis de SQL Server 2022 (16.x) y las versiones posteriores, Azure SQL Managed Instance, Azure SQL Database, Azure Synapse Analytics y Microsoft Fabric:

Importante

Necesita el nivel de compatibilidad de la base de datos establecido en 160 para usar el argumento de caracteres opcionales.

LTRIM ( character_expression , [ characters ] )

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

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

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 principio de un character_expression. Devuelve NULL si la cadena de entrada es NULL.

Comentarios

Para habilitar el argumento posicional de caracteres opcionales, habilite el nivel 160 de compatibilidad de la base de datos en la base de datos a la que se conecta al ejecutar consultas.

Ejemplos

A. Quitar espacios iniciales

En el siguiente ejemplo se usa LTRIM para quitar los espacios iniciales de una expresión de caracteres.

SELECT LTRIM('     Five spaces are at the beginning of this string.');

Este es el conjunto de resultados.

---------------------------------------------------------------
  Five spaces are at the beginning of this string.

B: Quitar espacios iniciales mediante una variable

En el siguiente ejemplo se utiliza LTRIM para quitar espacios iniciales de una variable de caracteres.

DECLARE @string_to_trim VARCHAR(60);
SET @string_to_trim = '     Five spaces are at the beginning of this string.';
SELECT
    @string_to_trim AS 'Original string',
    LTRIM(@string_to_trim) AS 'Without spaces';
GO

Este es el conjunto de resultados.

Original string                                            Without spaces
-----------------------------------------------------   ---------------------------------------------
     Five spaces are at the beginning of this string.    Five spaces are at the beginning of this string.

C. Quitar caracteres especificados del principio y el final de una cadena

Importante

Necesita el nivel de compatibilidad de la base de datos establecido en 160 para usar el argumento de caracteres opcionales.

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

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

Este es el conjunto de resultados.

abc.