LTRIM (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Punto de conexión SQL en Microsoft FabricAlmacenamiento 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

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

LTRIM ( character_expression , [ characters ] )

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

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 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 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.');

El conjunto de resultados es el siguiente:

---------------------------------------------------------------  
  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

El conjunto de resultados es el siguiente:

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

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 123 del principio de la cadena 123abc..

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

El conjunto de resultados es el siguiente:

abc.

Vea también