次の表で、数値カスタム書式指定子について説明します。
| 書式指定子 | 名前 | 説明 |
|---|---|---|
| 0 | ０のプレースホルダ | 書式設定する値の中の書式文字列の「0」の位置に数字がある場合、その数字は出力文字列にそのままコピーされます。小数点より前にある左端の「0」の位置と、小数点より後にある右端の「0」の位置により、出力文字列に常に表示される桁の範囲が決定されます。 |
| # | 桁のプレースホルダ | 書式設定する値の中の書式文字列の「#」の位置に数字がある場合、その数字は出力文字列にそのままコピーされます。その位置に数字がない場合、出力文字列内のその位置には何も置かれません。文字列内の数字が「0」だけであっても、有効数字でない「0」は、この指定子の位置に表示されないことに注意してください。表示される数値の有効数字である文字「0」は表示されます。 |
| . | 小数点 | 書式文字列内の最初の文字「.」により、書式設定された値での小数点の位置が決定されます。その他の「.」は無視されます。小数点として実際に使用される文字は、書式設定を制御する NumberFormatInfo オブジェクトの NumberDecimalSeparator プロパティによって決定されます。 |
| , | 桁区切りと数値のスケーリング | 文字「,」には２つの機能があります。小数点より左の書式文字列内の桁のプレースホルダ（０または #）の間に文字「,」がある場合は、小数点より左の数値に３桁ごとに桁区切りが挿入されます。出力文字列で桁区切りとして実際に使用される文字は、書式設定を制御する現在の NumberFormatInfo オブジェクトの NumberGroupSeparator プロパティによって決定されます。書式文字列内の小数点のすぐ左に「,」文字が１つ以上ある場合は、書式設定される前に、「,」文字の数の回数だけ数値が 1000 で割られます。たとえば、書式文字列「0,,」の場合、100,000,000 は単純に「100」と表されます。「,」文字を使用してスケーリングを示すと、書式設定された数値に桁区切りが含まれなくなります。このため、1,000,000 で数値をスケーリングし、桁区切りも挿入するには、書式文字列「#,##0,,」を使用します。 |
| % | パーセンテージのプレースホルダ | 書式文字列に「%」の文字があると、書式設定される前に、数値が 100 倍されます。書式文字列内の「%」の位置に応じて、適切な記号が数値に挿入されます。パーセンテージを表すために使用される文字は、現在の NumberFormatInfo クラスによって異なります。 |
| E0 E+0 E-0 e0 e+0 e-0 | 指数表記 | 書式文字列内に「E」、「E+」、「E-」、「e」、「e+」、または「e-」の文字列があり、直後に１つ以上の文字「0」が続く場合、数値は指数表記を使用して書式設定され、数値と指数の間に「E」または「e」が挿入されます。指数表記を示す文字に続く文字「0」の数により、出力される指数の最小の桁数が決定されます。「E+」と「e+」は、プラス記号（+）またはマイナス記号（-）が常に指数の前に置かれることを示します。「E」、「E-」、「e」、または「e-」は、符号が負の指数の前にのみ置かれることを示します。 |
| 'ABC' "ABC" | リテラル文字列 | 一重引用符または二重引用符で囲まれた文字は、出力文字列にそのままコピーされ、書式設定には影響しません。 |
| ; | セクション区切り | 文字「;」は、書式文字列内の正の数値、負の数値、および数値０のセクションを区切るために使用されます。 |
| True|False | ブール値の書式 | ２つのブール値 True と False を「|」で区切った文字列表現です。文字列「True」と「False」は、２つのブール値を示す他の文字列に置き換えることができます。 |
| その他 | その他のすべての文字 | その他の文字は、出力文字列の同じ位置にそのままコピーされます。 |
次の表に、数値カスタム書式指定子の使用例を示します。
| CustomFormat | 値 | 出力 |
|---|---|---|
| ##### | 123 | 123 |
| 00000 | 123 | 00123 |
| (###) ### - #### | 1234567890 | (123) 456 ? 7890 |
| #.## | 1.2 | 1.2 |
| 0.00 | 1.2 | 1.20 |
| 00.00 | 1.2 | 01.20 |
| #,# | 1234567890 | 1,234,567,890 |
| #,, | 1234567890 | 1235 |
| #,,, | 1234567890 | 1 |
| #,##0,, | 1234567890 | 1,235 |
| #0.##% | 0.086 | 8.6% |
| 0.###E+0 | 86000 | 8.6E+4 |
| 0.###E+000 | 86000 | 8.6E+004 |
| 0.###E-000 | 86000 | 8.6E004 |
| [##-##-##] | 123456 | [12-34-56] |
| ##;(##) | 1234 | 1234 |
| ##;(##) | -1234 | (1234) |