次の方法で共有


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) またはその他の指定した文字を削除します。

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

引数

character_expression

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

characters

削除する必要がある文字を含む LOB 以外の任意の文字型 (nvarcharvarcharnchar、または 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.