数値フォーマット

フォーマットプロパティがパーセント記号（％）で始まっておらず、@記号が含まれていない場合、フォーマットは数値フォーマットコードに従います。このフォーマットでは、文字列が浮動小数点値であると想定しています。フォーマットプロパティでは、次の形式指定子がサポートされています。

指定子	説明
「0」桁のプレースホルダー	フォーマットされる値のフォーマット文字列で「0」が現れる位置に数字がある場合、その数字は出力文字列にコピーされます。それ以外の場合は、出力文字列のその位置に「0」が格納されます。
＃桁のプレースホルダー	フォーマットされる値のフォーマット文字列で「＃」が現れる位置に数字がある場合、その数字は出力文字列にコピーされます。それ以外の場合、出力文字列のその位置には何も保存されません。
。小数点	最初「。」書式文字列の文字は、書式設定された値の小数点の位置を決定します。追加の「。」文字は無視されます。
,千区切り	書式文字列に1つ以上の '、'文字が含まれている場合、出力の小数点の左側の3桁の各グループの間に1000の区切り文字が挿入されます。書式文字列内の '、'文字の配置と数は、千の区切り文字が使用されていることを示す場合を除いて、出力には影響しません。
E +科学表記	文字列「E +」、「E-」、「e +」、または「e-」のいずれかがフォーマット文字列に含まれている場合、数値は科学表記法を使用してフォーマットされます。最大4つの「0」文字のグループを「E +」、「E-」、「e +」、または「e-」の直後に続けて、指数の最小桁数を決定できます。「E +」および「e +」フォーマットでは、正の指数の場合は正符号が出力され、負の指数の場合は負符号が出力されます。「E-」および「e-」フォーマットは、負の指数の場合にのみ符号文字を出力します。
「xx」/「xx」	一重引用符または二重引用符で囲まれた文字はそのまま出力され、書式設定には影響しません。
;	この文字は、フォーマット文字列内の正の数、負の数、ゼロの数を区切ります。

書式文字列の小数点の前の左端の「0」と書式文字列の小数点の右端の「0」の位置によって、出力文字列に常に存在する桁の範囲が決まります。

書式設定される数値は常に、小数点の右側にある数字のプレースホルダー（ '0'または '＃'）と同じ位の小数点以下の桁数に丸められます。フォーマット文字列に小数点が含まれていない場合、フォーマットされる値は最も近い整数に丸められます。

書式設定する数値の小数点の左側にある桁数が「。」の左側にある桁のプレースホルダーよりも多い場合。フォーマット文字列の文字の場合、余分な数字は最初の数字のプレースホルダーの前に出力されます。

正の値、負の値、ゼロの値に異なるフォーマットを許可するには、フォーマット文字列にセミコロンで区切られた1〜3つのセクションを含めることができます。

1つのセクション：書式文字列はすべての値に適用されます。
2つのセクション：最初のセクションは正の値とゼロに適用され、2番目のセクションは負の値に適用されます。
3つのセクション：最初のセクションは正の値に適用され、2番目のセクションは負の値に適用され、3番目のセクションはゼロに適用されます。

負の値のセクションまたはゼロの値のセクションが空の場合、つまりセクションを区切るセミコロンの間に何もない場合は、代わりに正の値のセクションが使用されます。

正の値のセクションが空の場合、またはフォーマット文字列全体が空の場合、値は有効桁数15桁の一般的な浮動小数点フォーマットを使用してフォーマットされます。値の小数点の左側が18桁を超えていて、フォーマット文字列が科学表記法を指定していない場合も、一般的な浮動小数点フォーマットが使用されます。

次の表は、FormatプロパティとStringプロパティに入力される値の例を示しています。

書式プロパティ	文字列プロパティ： 1234	文字列プロパティ： -1234	文字列プロパティ： 0.5	文字列プロパティ： 0
0	1234	-1234	0.5	0
0.00	1234.00	-1234.00	0.50	0.00
#.##	1234	-1234	.5
#,##0.00	1,234.00	-1,234.00	0.50	0.00
#,##0.00;(#,##0.00)	1,234.00	（1,234.00）	0.50	0.00
#,##0.00;;ゼロ	1,234.00	-1,234.00	0.50	ゼロ
0.000E + 00	0.000E + 03	-1.234E + 03	5.000E-01	0.000E + 00
#.###E-0	1.234E3	-1.234E3	5E-1	0E0