FORMAT

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

指定した formatに従って、value をテキストに変換します。

構文

FORMAT(<value>, <format_string>[, <locale_name>])

パラメーター

value を返す

valueによって定義 format_string 書式が設定された文字列。

備考

• 定義済みの format 文字列では、結果の書式設定時にモデル カルチャ プロパティが使用されます。 既定では、モデル カルチャ プロパティはコンピューターのユーザー ロケールに従って設定されます。 新しい Power BI Desktop モデルの場合、[オプション] > [地域設定] > [モデル言語] でモデル カルチャ プロパティを変更できます。 Analysis Services の場合、モデル カルチャは、インスタンスによって最初に定義された Language プロパティに従って設定されます。

• DAX FORMAT 関数の引数としてサポートされる format 文字列は、.NET Framework で使用される format 文字列に not、Visual Basic (OLE オートメーション) で使用される format 文字列に基づいています。 したがって、引数が定義された format 文字列と一致しない errorifor、予期しない結果が発生する可能性があります。 たとえば、"Percent" の省略形としての "p" はサポートされていません。 定義済みの format 文字列の一覧に含まれていない FORMAT 関数の引数として指定した文字列は、文字列リテラルとして or カスタム format 文字列の一部として処理されます。

• FORMATでロケールを指定する方法の詳細については、この ビデオを参照してください。

• FORMAT を使用すると、measure 結果がテキスト データ型に変更されます。 measure の結果が元の数値データ型である If、FORMATでは、measure は、グラフなどの数値データ型が values セクションに必要なビジュアルでは使用できません。 Power BI では、メジャーに動的 format 文字列 使用、measureの数値データ型を保持する条件付き format 文字列を指定することもできます。

• この関数は、行レベル セキュリティ (RLS) 規則 or 計算列で使用する場合に、DirectQuery モードで使用するためにサポート not。

例

Format 文字列

= FORMAT( 12345.67, "General Number")
= FORMAT( 12345.67, "Currency")
= FORMAT( 12345.67, "Fixed")
= FORMAT( 12345.67, "Standard")
= FORMAT( 12345.67, "Percent")
= FORMAT( 12345.67, "Scientific")

収益：

12345.67 [一般番号] には、書式設定なしで番号が表示されます。

$12,345.67 "Currency" は、currency ロケールの書式設定で数値を表示します。 ここでの sample は、既定の米国 currency の書式設定を示しています。

12345.67 "Fixed" は、小数点区切り記号の left に少なくとも 1 桁 and 小数点区切り記号の right に 2 桁を表示します。

12,345.67 "Standard" は、小数点区切り記号の right に 2 桁 and 小数点区切り記号の left に少なくとも 1 桁を表示 and、桁区切り記号を含みます。 ここでの sample は、既定の米国番号の書式設定を示しています。

1,234,567.00 % "Percent" は、数値をパーセント (100 で乗算) として表示し、1 つのスペースで区切られた数値の right の signand パーセントを書式設定します。

1.23E+04"Scientific" は、数値を 2 桁の 10 進数で指数表記で表示します。

Datetime (省略可能なlocale_name)

= FORMAT( dt"2020-12-15T12:30:59", BLANK(), "en-US" ) 
= FORMAT( dt"2020-12-15T12:30:59", BLANK(), "en-GB" ) 
= FORMAT( dt"2020-12-15T12:30:59", "mm/dd/yyyy", "en-GB" )

収益：

12/15/2020 12:30:59 PMmonth の前 dayandtime は 12-hourformatです。

15/12/2020 12:30:59day が monthandtime の前にある場所は 24-hourformatです。

2020 年 12 月 15 日 12:30:59month 前の dayandtime は 24hourformatです。 ロケールに依存しない format 文字列が指定されているため、ロケール以外の format が返 andnot ロケールが適用されます。

定義済みの数値形式

format_string 引数には、次の定義済みの数値書式を指定できます。

カスタム数値形式

数値のカスタム format 式には、セミコロンで区切られた 1 ~ 3 つのセクションを含めることができます。 名前付き数値形式の 1 つ containsformat 文字列引数を If、使用できるセクションは 1 つだけです。

"$#,##0;($#,##0)"

セミコロンの間に何もないセミコロンを含める If、不足しているセクションは、正の valueの format を使用して定義されます。 たとえば、次の format では、first セクションの format を使用して正 and 負の values を表示 and、value が 0 if "ゼロ" と表示されます。

"$#,##0"

セミコロンの間に何も含まれていない If、正の valueの format を使用して不足しているセクションが表示されます。

ユーザー設定の数値 format 文字

format_string 引数には、次のカスタム数値 format 文字を指定できます。

定義済みの date/time 形式

format_string 引数には、次の定義済みの date/time 形式を指定できます。 これら以外の形式を使用する場合は、カスタム date/timeformatとして解釈されます。

カスタム date/time 形式

format_string では、次の format 文字を指定して、カスタムの date/time 形式を作成できます。

Date/time 書式設定では、現在のユーザー ロケールを使用して文字列を format します。 たとえば、2020 年 6 月 25 日 date について考えてみます。 文字列 "m/d/yy" format 使用して書式設定すると、次のようになります。

• ユーザー ロケールは米国 (en-US): "6/25/2020"
• ユーザーロケールはドイツ (de-DE): "6.25.2020"

カスタム date/timeformat の例

次の例では、2020 年 6 月 25 日木曜日の午後 1:23:45 に date/time を使用します。 ドイツ (de-DE) は、24hour システムを使用します。 AM/PM に相当するものはありません。