LEFT

適用対象: 計算列計算テーブルメジャービジュアル計算

テキスト文字列の先頭から指定した文字数を返します。

構文

LEFT(<text>, <num_chars>)

パラメーター

用語 定義
text 抽出する文字を含むテキスト文字列、またはテキストを含む列への参照。
num_chars (省略可能)抽出する LEFT 文字数。省略した場合は 1。

戻り値

テキスト文字列。

備考

  • Microsoft Excel には、1 バイトと 2 バイトの文字言語でテキストを操作するためのさまざまな関数が含まれていますが、DAX Unicode で動作し、すべての文字を同じ長さで格納します。したがって、1 つの関数で十分です。

  • この関数は、計算列または行レベル セキュリティ (RLS) 規則で使用する場合、DirectQuery モードでは使用できません。

  • この関数は、 モデルの UnicodeCharacterBehavior 設定に応じて異なる結果を返します。

この記事の例は、Adventure Works DW 2020 Power BI Desktop モデルのサンプルと共に使用できます。 モデルを取得するには、サンプル モデル 参照してください。

次の例では、[City] 列の会社の市区町村の最初の 5 文字と、[ResellerKey] 列のリセラー キーの最初の 5 文字を返し、それらを連結して識別子を作成します。

=
CONCATENATE (
    LEFT ( 'Reseller'[City], 5 ),
    LEFT ( 'Reseller'[ResellerKey], 5 )
)

num_chars引数が使用可能な文字数を超える場合、関数は使用可能な最大文字数を返し、エラーは発生しません。 たとえば、[ResellerKey] 列には 5、24、312 などの数値が含まれているため、結果も可変長になります。