LTRIM (Transact-SQL)

  • [アーティクル]

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Microsoft Fabric の SQL 分析エンドポイントMicrosoft Fabric のウェアハウス

先頭の空白をすべて切り捨てた後の文字列を返します。

文字列の先頭にある空白文字 char(32) またはその他の指定した文字を削除します。

Transact-SQL 構文表記規則

構文

SQL Server 2022 (16.x) より前の SQL Server の構文:

LTRIM ( character_expression )

SQL Server 2022 (16.x) 以降、Azure SQL Managed Instance、Azure SQL Database、Azure Synapse Analytics、Microsoft Fabric の構文:

重要

省略可能な characters 引数を使うには、データベースの互換性レベルを 160 に設定する必要があります。

LTRIM ( character_expression , [ characters ] )

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

character_expression

文字データまたはバイナリ データの式。 character_expression には定数、変数、または列を指定できます。 character_expression 以外のデータ型の場合は、ある必要があります text、ntext、および image、つまりに暗黙的に変換 varcharです。 それ以外の場合は、CAST を指定して明示的に character_expression を変換します。

characters

削除する必要がある文字を含む LOB 以外の任意の文字型 (nvarchar、varchar、nchar、または char) のリテラル、変数、または関数呼び出しです。 nvarchar(max) 型と varchar(max) 型は使用できません。

戻り値の型

文字列引数の型を持つ文字式を返します。空白文字 char(32) またはその他の指定した文字は、character_expression の先頭から削除されます。 入力文字列が NULL の場合は NULL を返します。

解説

省略可能な characters 位置引数を有効にするには、クエリの実行時に接続するデータベースでデータベース互換レベル 160 を有効にします。

例

A. 先頭の空白を削除する

次の例では、LTRIM を使用して文字式から先頭の空白を削除します。

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

結果セットは次のようになります。

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

B: 変数を使用して先頭の空白を削除する

次の例では、LTRIM を使用して文字変数から先頭の空白を削除します。

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

結果セットは次のようになります。

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

C. 文字列の先頭から指定した文字を削除する

重要

省略可能な characters 引数を使うには、データベースの互換性レベルを 160 に設定する必要があります。

次の例では、123abc. 文字列の先頭から文字 123 を削除します。

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

結果セットは次のようになります。

abc.

関連項目