MDX セル プロパティ - FORMAT_STRING コンテンツ

適用対象: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

FORMAT_STRING セル プロパティは、 VALUE セル プロパティを書式設定して、 FORMATTED_VALUE セル プロパティの値を作成します。 FORMAT_STRING セル プロパティは文字列と数値列の値を処理し、その値にフォーマット式を適用して、 FORMATTED_VALUE セル プロパティ用に書式設定した値を返します。 次の表は、文字列および数値の処理に使用する構文および書式文字の詳細を示しています。

文字列の値

文字列のフォーマット式には、1 つのセクション、またはセミコロン (;) で区切った 2 つのセクションを含めることができます。

使用	結果
1 つ	この書式はすべての文字列の値に適用されます。
2 つ	最初のセクションは文字列のデータに適用され、2 番目のセクションは NULL 値および長さ 0 の文字列 ('''') に適用されます。

文字列用の書式文字列には、次の表の文字を含めることができます。

文字	説明
@	1 つの文字またはスペースを表示する、文字のプレースホルダー。 文字列の中で、書式文字列のアット マーク (@) に該当する位置に文字がある場合、書式設定された文字列にはその文字が表示されます。 それ以外の場合は、書式設定された文字列のその位置にスペースが表示されます。 プレースホルダーは、書式文字列に感嘆符 (!) がない限り、右側から左側に向かって指定されます。
&	1 つの文字を表示するか、または何も表示しない、文字のプレースホルダー。 文字列の中で、アンパサンド (&) に該当する位置に文字がある場合、書式設定された文字列にはその文字が表示されます。 それ以外の場合、書式設定された文字列には何も表示されません。 プレースホルダーは、書式文字列に感嘆符 (!) がない限り、右側から左側に向かって指定されます。
<	強制的に小文字にします。 書式設定された文字列には、すべての文字が小文字で表示されます。
>	強制的に大文字にします。 書式設定された文字列には、すべての文字が大文字で表示されます。
!	プレースホルダーを左から右に指定していくように強制的に設定します。 既定では、プレースホルダーは右から左に指定していくように設定されています。

数値

数値に対するユーザー定義のフォーマット式には、1 つのセクションからセミコロンで区切った 4 つのセクションまでを任意の場所に含めることができます。 フォーマット引数にいずれかの名前付き数値書式が含まれている場合、使用できるセクションは 1 つだけです。

使用	結果
1 つ	このフォーマット式は、すべての値に適用されます。
2 つ	最初のセクションは正の値および 0 に適用され、2 番目のセクションは負の値に適用されます。
3 つ	最初のセクションは正の値に、2 番目のセクションは負の値に、3 番目のセクションは 0 に適用されます。
4 つのセクション	最初のセクションは正の値に、2 番目のセクションは負の値に、3 番目のセクションは 0 に、そして 4 番目のセクションは NULL 値に適用されます。

次の例には 2 つのセクションが含まれています。 最初のセクションは正の値と 0 の書式を定義し、2 番目のセクションは負の値の書式を定義します。

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

連続したセミコロンを含めた場合、欠落したセクションは正の値の書式を使用して出力されます。 たとえば、次の書式では、最初のセクションの書式を使用して正と負の値が表示され、その値が 0 の場合は、"Zero" と表示されます。

"$#,##0;;\Z\e\r\o"  

次の表は、数値書式の書式文字列に使用できる文字を示しています。

文字	説明
なし	書式なしで数値を表示します。
0	1 つの数字または 0 を表示する、数字のプレースホルダー。 数値の中で、書式文字列の 0 に該当する位置に数字がある場合、書式設定された値にはその数字が表示されます。 それ以外の場合は、書式設定された値のその位置に 0 が表示されます。 数字の数が書式文字列の 0 の数 (小数点の両側を含む) より少ない数値の場合、書式設定された値には先頭または後ろに 0 が表示されます。 小数点記号の右側の数字の数がフォーマット式の小数点区切り文字の右側の 0 の数より多い数値の場合、書式設定された値は、小数点以下の数字の数が 0 の数と同じになるように丸められます。 小数点区切り文字の左側の数字の数が、フォーマット式の小数点区切り文字の左側の 0 の数より多い数値の場合、書式設定された値には追加の数字が修正されずに表示されます。
#	1 つの数字を表示するか、または何も表示しない、数字のプレースホルダー。 式の中で、書式文字列のシャープ記号 (#) に該当する位置に数字がある場合、書式設定された値にはその数字が表示されます。 それ以外の場合は、書式設定された値のその位置には何も表示されません。 シャープ記号 (#) プレースホルダーの機能はゼロ (0) プレースホルダーとほぼ同じです。ただし、先頭または後ろの 0 は、数値の数字の数が、フォーマット式の小数点区切り文字の左側または右側の # 文字の数と同じ、またはより少ない場合に表示されません。
.	小数点区切り文字の左右に表示される数字の数を決定する、小数点のプレースホルダー。 フォーマット式の中で、ピリオド (#) の左側にシャープ記号 (.) 文字だけがある場合、1 未満の数値は小数点区切り文字から始まります。 小数部の前に 0 を表示するには、小数点区切り文字の左側に使用する最初の数字プレースホルダーとして 0 を使用してください。 書式設定された出力で実際にどの文字が小数点のプレースホルダーとして使用されるかは、コンピューター システムが認識する数値書式によって決まります。 注: いくつかのロケールでは、小数点区切り文字としてコンマが使用されます。
%	パーセンテージのプレースホルダー。 式に 100 が乗算されます。 書式文字列のパーセントに該当する位置に、パーセント記号 (%) が挿入されます。
,	1000 単位の区切り文字。小数点区切り文字の左側が 4 桁以上である数値の中で、百の位と千の位を区切ります。 書式に含まれる数字のプレースホルダー (0 または #) の間に 1000 単位の区切り文字が含まれている場合、標準的な 1000 単位の区切り文字を使用するように指定されます。 隣接する 2 つの桁区切り記号、または小数点区切り記号のすぐ左側の桁区切り記号 (10 進数が指定されているかどうかに関係なく) は、「数値を 1000 で除算して数値をスケーリングし、必要に応じて丸める」を意味します。たとえば、書式指定文字列 "##0" を使用して、1 億を 100 として表すことができます。 100 万より小さい数値は 0 と表示されます。 小数点区切り文字のすぐ左側以外の位置に 2 つの隣接する 1000 単位区切り文字を使用すると、1 つの 1000 単位区切り文字を指定しているものとして扱われます。 書式設定された出力で実際にどの文字が 1000 単位の区切り文字として使用されるかは、コンピューター システムが認識する数値書式によって決まります。 注: いくつかのロケールでは、1000 単位の区切り文字としてピリオドが使用されます。
:	時刻区切り文字。時刻の値を書式設定する際に、時、分、秒を区切ります。 注: いくつかのロケールでは、時刻区切り文字として他の文字が使用されることがあります。 書式設定された出力で実際にどの文字が時刻区切り文字として使用されるかは、コンピューターのシステム設定によって決まります。
/	日付区切り文字。日付の値を書式設定する際に、年、月、日を区切ります。 書式設定された出力で実際にどの文字が日付区切り文字として使用されるかは、コンピューターのシステム設定によって決まります。 注: いくつかのロケールでは、日付区切り文字として他の文字が使用されることがあります。
E- E+ e- e+	指数書式。 フォーマット式の中で、E- 、 #E+ 、e- 、またはe+ の右側に少なくとも 1 つの数字のプレースホルダー (0 または) が含まれる場合、書式設定された値は指数書式で表示され、数値と指数の間に E または e が挿入されます。 右側の桁プレースホルダーの数によって、指数部の桁数が決まります。 負の指数の横にマイナス記号を付けるには、 E- または e- を使用します。 負の指数の横にマイナス記号を、正の指数の横にプラス記号を含めるには、 E+ または e+ を使用します。
- + $ ( )	リテラル文字を表示します。 表示されている文字以外の文字を表示するには、文字の前に円記号 (\) を付けるか、文字を二重引用符 (" ") で囲みます。
\	書式文字列の次の文字を表示します。 リテラル文字として特別な意味を持つ文字を表示するには、その文字の前に円記号 (\) を付けます。 円記号自体は表示されません。 円記号の使用は、次の文字を二重引用符で囲むことと同じです。 円記号を表示するには、2 つの円記号 (\\) を使用します。 以下のような文字は、リテラル文字として表示できません。 日付書式と時刻書式の文字 a、c、d、h、m、n、p、q、s、t、w、y、、/、および : 数値書式の文字-#、0、、%E、e、コンマ、ピリオド 文字列形式の文字、@&<、、>、および !
"ABC"	二重引用符 (" ") 内に文字列を表示します。 コード内で書式に文字列を含めるには、Chr(34) を使ってテキストを囲みます。 (二重引用符の文字コードは 34です)。

名前付き数値書式

次の表は、定義済み数値書式の名前を示しています。

形式名	説明
General Number	桁区切り記号を付けずに数値を表示します。
Currency	必要に応じて、桁区切り記号を付けて数値を表示します。 小数点区切り文字の右側に 2 桁の数字が表示されます。 出力はシステムのロケール設定に基づいきます。
Fixed	小数点区切り記号の左側に 1 桁以上、右側に 2 桁の数字を表示します。
Standard	桁区切り記号を付けて数値を表示します。少なくとも小数点区切り文字の左側に 1 桁、右側に 2 桁の数字を表示します。
Percent	数値を 100 倍して、右側にパーセント記号 (%) を付けて表示します。 小数点区切り文字の右側には、常に 2 桁の数字が表示されます。
Scientific	標準的な科学的表記法を使用します。
Yes/No	数値が 0 の場合は "No"、それ以外の場合は "Yes" を表示します。
True/False	数値が 0 の場合は "False"、それ以外の場合は "True" を表示します。
On/Off	数値が 0 の場合は "Off"、それ以外の場合は "On" を表示します。

日付の値

次の表は、日付/時刻形式の書式文字列で使用できる文字を示しています。

文字	説明
:	時刻区切り文字。時刻の値を書式設定する際に、時、分、秒を区切ります。 書式設定された出力で実際にどの文字が時刻区切り文字として使用されるかは、コンピューターのシステム設定によって決まります。 注: いくつかのロケールでは、時刻区切り文字として他の文字が使用されることがあります。
/	日付区切り文字。日付の値を書式設定する際に、年、月、日を区切ります。 書式設定された出力で実際にどの文字が日付区切り文字として使用されるかは、コンピューターのシステム設定によって決まります。 注: ロケールによっては、日付の区切り記号を表すために他の文字が使用されます。
C	日付を ddddd 、時刻を tttttとして、この順序で表示します。 日付のシリアル番号に小数部がない場合は、日付情報だけを表示します。 整数部がない場合は、時刻情報だけを表示します。
d	日を先頭に 0 (1 から 31) を付けずに数値で表示します。
dd	日を先頭に 0 (01 から 31) の数値で表示します。
Ddd	曜日を省略形 (日-土) として表示します。
Dddd	完全な名前 (日曜日から土曜日) として日を表示します。
ddddd	日付を完全な日付 (年、月、日) で表示します。表示形式はシステムの短縮日付の書式設定に従います。 Microsoft Windows では、既定の短縮日付フォーマットは m/d/yyです。
dddddd	日付のシリアル番号を完全な日付 (年、月、日) で表示します。表示形式は、コンピューター システムが認識する長い日付の書式設定に従います。 Windows では、既定の長い日付フォーマットは mmmm dd, yyyyです。
w	曜日を数値で表示します (日曜日が 1、土曜日が 7)。
ww	年の週を数値 (1 から 54) で表示します。
m	月を先頭にゼロ (1 から 12) を付けずに数値で表示します。 h または hh のすぐ後に mmがある場合、月ではなく分が表示されます。
mm	月を、先頭に 0 (01 から 12) の数値で表示します。 h または hh のすぐ後に mmがある場合、月ではなく分が表示されます。
mmm	月を省略形 (1 月から 12 月) として表示します。
mmmm	月を完全な月名 (1 月から 12 月) として表示します。
q	年の四半期を数値 (1 から 4) で表示します。
y	年の曜日を数値 (1 から 366) で表示します。
yy	年を 2 桁の数値 (00 から 99) で表示します。
yyyy	年を 4 桁の数値 (100 から 9999) で表示します。
h	先頭にゼロ (0 から 23) を付けずに、時間を数値で表示します。
hh	時間を先頭にゼロ (00 から 23) の数値で表示します。
n	分を先頭にゼロ (0 から 59) を付けずに数値として表示します。
nn	分を先頭に 0 (00 から 59) の数値で表示します。
s	2 つ目を先頭にゼロ (0 から 59) を付けずに数値として表示します。
ss	2 つ目を先頭に 0 (00 から 59) の数値で表示します。
t t t t t	時刻を完全な時刻 (時間、分、秒) で表示します。表示形式は、コンピューター システムが認識する時刻書式で定義された時刻区切り文字を使用します。 先頭にゼロを付けるオプションを選択した場合、午前または午後の 10:00 より早い時刻であれば、前にゼロが表示されます (たとえば 09:59)。 Windows では、既定の時刻書式は h:mm:ssです。
AM/PM	午前 0 時から正午までの時間に大文字の AM 、正午から午前 0 時までの時間に大文字の PM をそれぞれ付けて表示します。 注: 12 時間形式を使用します。
am/pm	午前 0 時から正午までの時間に小文字の am 、正午から午前 0 時までの時間に小文字の pm をそれぞれ付けて表示します。 注: 12 時間形式を使用します。
A/P	午前 0 時から正午までの時間に大文字の A 、正午から午前 0 時までの時間に大文字の P をそれぞれ付けて表示します。 注: 12 時間形式を使用します。
a/p	午前 0 時から正午までの時間に小文字の a 、正午から午前 0 時までの時間に小文字の p をそれぞれ付けて表示します。 注: 12 時間形式を使用します。
AMPM	午前 0 時から正午までの時間にコンピューター システム定義の AM 文字列リテラルを、正午から午前 0 時までの時間にコンピューター システム定義の PM 文字列リテラルをそれぞれ付けて表示します。 AMPM は大文字、小文字のいずれでもかまいません。ただし、表示される文字列の大文字、小文字の区別は、コンピューターのシステム設定で定義された文字列に一致します。 Windows の場合、既定の書式は AM/PMです。 注: 12 時間形式を使用します。

名前付き日付形式

次の表は、定義済みの日付/時刻形式の名前を示しています。

形式名	説明
General Date	日付と時刻、またはそのいずれかを表示します。 実数の場合は、日付と時刻を表示します ("4/3/93 05:34 PM" など)。 小数部分がない場合は、4/3/93 のように、日付のみを表示します。 整数部分がない場合は、05:34 PM のように、時刻のみを表示します。 日付の表示形式は、システム設定によって決まります。
Long Date	システムの長い日付形式に従って日付を表示します。
Medium Date	ホスト アプリケーションの言語バージョンに適切な中間の長さの日付形式で日付を表示します。
Short Date	システムの短い日付形式を使用して日付を表示します。
Long Time	システムの長い時刻形式を使用して、時、分、および秒を含む時刻を表示します。
Medium Time	時、分、および AM/PM 指定子を使用して、12 時間形式で時刻を表示します。
Short Time	24 時間形式を使用して時刻を表示します (たとえば 17:45)。

参照

FORMATTED_VALUEでの言語とFORMAT_STRING
セル プロパティの使用 (MDX)
プロパティ値の作成および使用 (MDX)
MDX クエリの基礎 (Analysis Services)