数値書式

数値の整数部または小数部の桁数が、書式指定式内の 0 の桁数に満たない場合は、その桁位置には 0 が付加されます。数値の小数部の桁数が、書式指定式の小数部で指定されているゼロの数より多い場合は、ゼロの数と同じ桁数に数値が丸められます。数値の整数部の桁数が、書式指定式の整数部のゼロの数より多い場合は、桁をそのまま表示します。

この記号は 0 桁プレースホルダと同様の機能を持ちます。ただし、数値の桁数が、書式指定式の整数部および小数部にある # 記号よりも少ない場合でも、先頭および末尾にゼロが表示されません。

小数部の指定の有無にかかわらず、小数点のすぐ左に 3 桁ごとの区切り記号がある場合、または文字列の一番右に桁区切り記号がある場合は、"数値を 1,000 で割って、必要に応じて丸める" ことを意味します。500 以上で 1,000 未満の数値は 1 として表示され、500 未満の数値は 0 として表示されます。同じ位置で 3 桁ごとの区切り記号が 2 つ隣接する場合は、100 万で割って変換します。このように、桁区切り記号が増えるごとに 1,000 倍の係数で変換されます。

小数点のすぐ左、または文字列の一番右以外の位置に複数の区切り記号がある場合は、通常の 3 桁ごとの区切り記号を指定したものとして単純に処理されます。ロケールによっては、3 桁ごとの区切り記号としてピリオドが使用されます。書式指定された出力で、実際に 3 桁ごとの区切り記号として使用される記号は、システムで認識される数値書式によって異なります。したがって、桁区切り記号としてピリオドを使用するロケールであっても、書式指定の中ではコンマを 3 桁の桁区切り記号として使用する必要があります。書式指定された文字列は、ロケールに対して適切な書式で表現されます。

たとえば、次の 3 つの書式指定文字列があるとします。

• "#,0." とした場合、1 億という数値は、桁区切り記号を用いて "100,000,000" という文字列形式で表記されます。
• "#0,." とした場合、1 億という数値は、1000 で割って位取りした数値、つまり、"100000" という文字列になります。
• "#,0,." とした場合、1 億という数値は、1000 で割って位取りした結果が、桁区切り記号を用いて "100,000" という文字列形式で表記されます。

リテラル文字として表示できない文字には次のような文字があります。日付書式文字および時刻書式文字 (a、c、d、h、m、n、p、q、s、t、w、y、/、および :)、数値書式文字 (#、0、%、E、e、コンマ、およびピリオド)、および文字列書式文字 (@、&、<、>、および !)。