LTRIM (Transact-SQL)
Applies to: 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 ] )
引数
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.