Share via

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 の構文:

重要

省略可能 な文字引数を使用するには、データベース互換性レベルを 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.

関連するコンテンツ