SUBSTITUTE 関数

テキスト文字列内の既存のテキストを新しいテキストに置き換えます。

構文

SUBSTITUTE(<text>, <old_text>, <new_text>, <instance_num>)

パラメーター

項目

定義

text

文字を置き換える対象のテキスト、またはテキストが含まれている列への参照。

old_text

置き換える既存のテキスト。

new_text

old_text を置き換えるテキスト。

instance_num

(省略可能) 置き換える old_text の出現箇所。 省略した場合は、old_text のすべてのインスタンスが置き換えられます。

プロパティ値/戻り値

テキスト文字列。

説明

テキスト文字列内の特定のテキストを置き換える場合は、SUBSTITUTE 関数を使用します。テキスト文字列の特定の位置にある任意の可変長のテキストを置き換えるには、REPLACE 関数を使用します。

SUBSTITUTE 関数では、大文字と小文字が区別されます。 text と old_text で大文字と小文字が一致しない場合は、SUBSTITUTE を使用してもテキストは置換されません。

この DAX 関数は、配置済みのモデルで使用し、DirectQuery モードでクエリを実行した場合には、異なる結果を返すことがあります。 DirectQuery モードのセマンティックの相違点の詳細については、https://go.microsoft.com/fwlink/?LinkId=219171 を参照してください。

例: 文字列内の置換

説明

次の式は、列内の古い製品コード PA をすべて新しい製品コード NW に置き換えた、列 [Product Code] のコピーを作成します。

コード

=SUBSTITUTE([Product Code], "NW", "PA") 

関連項目

参照

REPLACE 関数

その他の技術情報

文字列関数 (DAX)