LTRIM (Transact-SQL)
適用対象: SQL Server
Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Analytics Platform System (PDW)
Microsoft Fabric のSQL 分析エンドポイント
Microsoft Fabric のウェアハウス
先頭の空白をすべて切り捨てた後の文字列を返します。
文字列の先頭にある空白文字 char(32)
またはその他の指定した文字を削除します。
構文
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
を返します。
解説
オプションの 文字 位置指定引数を有効にするには、クエリの実行時に接続するデータベースでデータベース互換性レベルの 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. 文字列の先頭から指定した文字を削除する
重要
省略可能な文字引数を使用するには、データベース互換性レベルを160
に設定する必要があります。
次の例では、123abc.
文字列の先頭から文字 123
を削除します。
SELECT LTRIM('123abc.' , '123.');
結果セットは次のようになります。
abc.