Format 関数 (カスタム web アプリケーションのアクセス) 用のカスタムの数値書式
ユーザー定義の数値書式を作成して数値の表示方法を制御する方法について説明します。
重要
現在 Microsoft では、SharePoint での Access Web アプリケーションの作成や使用は推奨していません。 代わりに、web およびモバイル デバイス用のコードのないビジネス ソリューションを構築するマイクロソフトの PowerAppsを使用して検討してください。
ユーザー定義の数値書式を作成して数値の表示方法を変更できます。 ユーザー定義の数値書式は、セミコロン (;) で区切られた 1 ～ 3 つのセクションを持つことができます。 Format Function (Access カスタム Web アプリ) 関数の Style 引数に定義済みの数値形式のいずれかが含まれている場合、許可されるセクションは 1 つだけです。
書式指定
次の表は、ユーザー定義の数値書式の作成に使用できる文字をリストしています。
| 書式指定 | 説明 |
|---|---|
| なし |
書式設定されていない数値が表示されます。 |
| 0 (0 文字) |
桁のプレースホルダーです。 1 桁の数または 0 を表示します。 式に、書式指定文字列で 0 が指定されている場所に数字がある場合は、該当する数字がその桁に表示されます。それ以外の場合は、その場所に 0 を表示します。 数値の整数部または小数部の桁数が、書式指定式内の 0 の桁数に満たない場合は、その桁位置には 0 を表示します。 数値の小数部の桁数が、書式指定式の小数部で指定されている 0 の数より多い場合は、0 の数と同じ桁数に数値が丸められます。 数値の整数部の桁数が、書式指定式の整数部の 0 の数より多い場合は、桁をそのまま表示します。 |
| # |
桁のプレースホルダーです。 1 桁の数字または 0 を表示します。 式に、書式指定文字列で # 文字が指定されている場所に数字がある場合は、該当する数字がその桁に表示されます。それ以外の場合は、その場所に 0 を表示します。 この記号は 0 桁プレースホルダーとまったく同様の機能を持ちます。ただし、数値の桁数が、書式指定式の整数部および小数部にある # 記号よりも少ない場合でも、先頭および末尾に 0 が表示されません。 |
| . (ドット文字) |
小数点のプレースホルダーです。 小数点のプレースホルダーにより、整数部および小数部に表示する桁数が決まります。 書式指定式でこの記号の左に # 記号だけがある場合、1 未満の数値の先頭は小数点区切り記号になります。 小数値の先頭に 0 を表示するには、整数部の最初の桁のプレースホルダーとして 0 を使用します。 ロケールによっては、桁区切り記号としてコンマが使用されます。 書式指定結果で小数点のプレースホルダーとして実際に使用される記号は、システムで認識される数値書式によって異なります。 したがって、コンマが桁区切り記号として使用されるロケールのユーザーであっても、書式では桁区切り記号としてピリオドを使用する必要があります。 書式設定された文字列は、ロケールの正しい形式で表示されます。 |
| % |
パーセントのプレースホルダーです。 式を 100 倍します。 書式指定文字列の表示位置にパーセント記号 (%) が挿入されます。 |
| , (コンマ文字) |
桁区切り記号です。 桁区切り記号は、整数部に 4 桁以上ある数値の百の位と千の位を区切ります。 書式にある桁区切り記号が桁のプレースホルダー (0 または #) で囲まれている場合は、桁区切り記号の標準使用が指定されます。 小数点の左側の桁区切り記号 (10 進数が指定されているかどうか) または文字列の右端の文字は、「必要に応じて 1,000 で除算して数値をスケーリングする」を意味します。1,000 より小さいが 500 以上の数値は 1 として表示され、500 より小さい数値は 0 として表示されます。 この位置に 2 つの隣接する区切り記号がある場合は百万の因数でスケーリングし、桁区切り記号が 1 つ増えるごとにさらに 1,000 の因数でスケーリングします。 小数点のすぐ左以外の位置、または文字列の右端の位置に複数の隣接する区切り記号がある場合は、通常の桁区切り記号を指定したものとして処理されます。 ロケールによっては、桁区切り記号としてピリオドが使用されます。 書式指定された出力で、実際に桁区切り記号として使用される記号は、システムで認識される数値書式によって異なります。 したがって、桁区切り記号としてピリオドが使用されるロケールのユーザーであっても、書式で桁区切り記号としてコンマを使用する必要があります。 書式設定された文字列は、ロケールの正しい形式で表示されます。 たとえば、次の 3 つの書式文字列を考えてみます。 "#,0." は、桁区切り記号を使用して、1 億を文字列 "100,000,000" として書式設定します。 "#0,." は、1,000 の因数によるスケーリングを使用して、1 億を文字列 "100000" として書式設定します。 "#,0,." は、桁区切り記号と 1,000 の因数によるスケーリングを使用して、1 億を文字列 "100,000" として書式設定します。 |
| : (コロン文字) |
時刻の区切り記号。 一部のロケールでは、時刻区切り文字を表す目的で他の文字が使用されることがあります。 時刻の値が書式設定されるときに、時刻区切り文字によって時、分、および秒が区切られます。 書式設定された出力で時刻区切り文字として使用される実際の文字は、システム設定によって決まります。 |
| / (スラッシュ) |
日付の区切り記号。 ロケールによっては、他の文字が日付の区切り記号として表示される場合があります。 日付値の書式が設定されている場合、日付、月、および年は、日付の区切り記号によって区切られます。 書式設定された出力で、日付の区切り文字として実際に使用される文字は、システム設定によって決まります。 |
| 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" |
二重引用符 (" ") で囲まれた文字列を表示します。 コード内の style 引数に文字列を含めるには、Chr(34) を使ってテキストを囲みます (34 は引用符 (") を表す文字コードです)。 |
次の表には、数値のサンプルの書式指定式が含まれています (これらのすべての例では、システムのロケールが English-U.S. であることを想定しています)。 最初の列には Format 関数の書式文字列が含まれています。 別の列には、書式設定されたデータに列見出しの値がある場合の結果の出力が含まれています。
| 書式設定 (スタイル) | "5" の書式設定 | "-5" の書式設定 | "0.5" の書式設定 | "0" の書式設定 |
|---|---|---|---|---|
| 長さ 0 の文字列 ("") |
5 |
-5 |
0.5 |
0 |
| 0 |
5 |
-5 |
1 |
0 |
| 0.00 |
5.00 |
-5.00 |
0.50 |
0.00 |
| #,##0 |
5 |
-5 |
1 |
0 |
| $#,##0;($#,##0) |
$5 |
($5) |
$1 |
$0 |
| $#,##0.00;($#,##0.00) |
$5.00 |
($5.00) |
$0.50 |
$0.00 |
| 0% |
500% |
-500% |
50% |
0% |
| 0.00% |
500.00% |
-500.00% |
50.00% |
0.00% |
| 0.00E+00 |
5.00E+00 |
-5.00E+00 |
5.00E-01 |
0.00E+00 |
| 0.00E-00 |
5.00E00 |
-5.00E00 |
5.00E-01 |
0.00E00 |
| "$#,##0;;\Z\e\r\o" |
$5 |
$-5 |
$1 |
ゼロ |
解説
間に何も入れずに複数のセミコロンを含めた場合、欠けているセクションは正の値の書式を使用して表示されます。