• 書式を指定して数値を文字列に変換する
  • 標準の数値書式指定文字列とその例
  • カスタム数値書式指定文字列とその例
  • カルチャを指定する
  • String.Formatメソッドを使う

• この記事への評価、コメント

書式を指定して数値を文字列に変換する

数値を文字列に変換する方法は「文字列を数値に変換する、数値を文字列に変換する」で説明しました。ここでは、書式（フォーマット）を指定して数値を文字列に変換する方法を説明します。

ToStringメソッドを使えば数値を文字列に変換できますが、その時どのような文字列に変換するかを書式で指定することが出来ます。書式には、文字列を使用します。この文字列を「書式指定文字列」と呼びます。数値を文字列に変換する時に使用される書式指定文字列には、「標準の数値書式指定文字列」と「カスタム数値書式指定文字列」の2種類があります。

標準の数値書式指定文字列は、アルファベット一文字、あるいは、アルファベット一文字と数字から成ります。例えば、通貨に使用される書式は"C"ですが、この書式で 10000 を文字列に変換すると、"\10,000"という文字列になります。

カスタム数値書式指定文字列は、複数の文字列を組み合わせて使用することができ、より柔軟な書式指定が可能です。例えば、"#,0"という書式を使うと、3桁ごとにコンマが入った文字列に変換できます。

Dim num As Integer = 10000

Console.WriteLine(num.ToString("C"))
'\10,000

Console.WriteLine(num.ToString("#,0"))
'10,000

int num = 10000;

Console.WriteLine(num.ToString("C"));
//\10,000

Console.WriteLine(num.ToString("#,0"));
//10,000

このような数値書式指定文字列については下で詳しく説明しますが、MSDNでは次のようなページで説明されています。これらのページも参考にしてください。

• 標準の数値書式指定文字列
• カスタム数値書式指定文字列

標準の数値書式指定文字列とその例

ここからは、数値書式指定文字列の説明とその例を表にして紹介します。

ここで紹介している「例」は、= より前が書式を指定してToStringメソッドを呼び出すコードで、= より後がToStringが返す結果です。リテラル文字列の書き方は、VB.NETになっています。C#の場合は、@ をリテラル文字列の前につければ同じになります。また、結果はカレントカルチャが"ja-JP"の時のものです。別のカルチャ（NumberFormatInfo）では別の結果になる可能性があります。

標準の数値書式指定文字列は、一つのアルファベットと、数字から成ります。アルファベットの部分を「書式指定子」、数字の部分を「精度指定子」と呼びます。

(10000).ToString("C") = "\10,000"
(-100.5).ToString("C") = "-\101"
(12345.5555).ToString("C2") = "\12,345.56"

(12345).ToString("D") = "12345"
(12345).ToString("D8") = "00012345"
(-12345).ToString("D6") = "-012345"
(12345).ToString("D4") = "12345"

(123.456).ToString("E") = "1.234560E+002"
(0.0).ToString("e") = "0.000000e+000"
(-123.45).ToString("E8") = "-1.23450000E+002"
(0.12345).ToString("E3") = "1.235E-001"

(123.456).ToString("F") = "123.46"
(1).ToString("F") = "1.00"
(-123.456789).ToString("F4") = "-123.4568"
(0.1).ToString("F6") = "0.100000"

(123456).ToString("G") = "123456"
(0.00001).ToString("G") = "1E-05"
(-0.00001).ToString("g") = "-1e-05"
(123456).ToString("G4") = "1.235E+05"
(-123.456).ToString("G4") = "-123.5"
(0.0).ToString("G4") = "0"

(1234.56789).ToString("N") = "1,234.57"
(10000).ToString("N") = "10,000.00"
(-1234.56789).ToString("n4") = "-1,234.5679"

(1).ToString("P") = "100.00%"
(-0.123456789).ToString("p") = "-12.35%"
(100).ToString("P") = "10,000.00%"
(0.00001).ToString("P") = "0.00%"
(0.123456789).ToString("P4") = "12.3457%"
(0.125).ToString("P0") = "13%"

(123456789.123456789).ToString("R") = "123456789.12345679"
(-123456789.123456789).ToString("R") = "-123456789.12345679"

(10).ToString("X") = "A"
(-1).ToString("x") = "ffffffff"
(10).ToString("X4") = "000A"

カスタム数値書式指定文字列とその例

カスタム数値書式指定文字列は、以下の書式指定子の組み合わせになります。

(123).ToString("00000") = "00123"
(-1.2).ToString("00.00") = "-01.20"
(123.456).ToString("00.00") = "123.46"
(123.456).ToString("0") = "123"

(123).ToString("#####") = "123"
(123.456).ToString("#") = "123"
(-123).ToString("#####") = "-123"
(0.123456).ToString("#.####") = ".1235"

(123.456).ToString("0.00") = "123.46"
(1.23456).ToString("0.0.0") = "1.23"

(123456789).ToString("#,0") = "123,456,789"
(123456789).ToString("0,") = "123457"
(123456789).ToString("0,,") = "123"
(123456789.12).ToString("0,.###") = "123,456.789"
(1).ToString("0,0,0") = "001"
(1000).ToString("0,0,0") = "1,000"

(0.123456).ToString("0.00%") = "12.35%"
(0.123456).ToString("%0.00") = "%12.35"

(0.123456).ToString("0.00‰") = "123.46‰"
(0.123456).ToString("‰0.00") = "‰123.46"

(12.345).ToString("0.00E0") = "1.23E1"
(12.345).ToString("0.00e00") = "1.23e01"
(12.345).ToString("0.00E+0") = "1.23E+1"
(12.345).ToString("0.00E-0") = "1.23E1"
(0.12345).ToString("0.00E0") = "1.23E-1"
(0.12345).ToString("0.00E+0") = "1.23E-1"
(0.12345).ToString("0.00E-0") = "1.23E-1"

(12.345).ToString("\\0.##\#") = "\12.35#"

(12.345).ToString("0.##('0.##')") = "12.35(0.##)"
(12.345).ToString("0.##(""0.##"")") = "12.35(0.##)"

(10).ToString("000;[000]") = "010"
(-10).ToString("000;[000]") = "[010]"
(0).ToString("000;[000]") = "000"
(10).ToString("000;[000];Zero") = "010"
(-10).ToString("000;[000];Zero") = "[010]"
(0).ToString("000;[000];Zero") = "Zero"

(10).ToString("0個") = "10個"
(1234).ToString("0あ0い0う0え0お0") = "0あ0い1う2え3お4"

カルチャを指定する

前に触れたように、数値書式指定文字列の中には、カルチャによって結果の変わるものも多くあります。数値型（IFormattableインターフェイスを実装する型）のToStringメソッドにはパラメータとしてIFormatProviderを指定することもできますが、これを指定しなかった場合は、現在のカルチャが使用されます。

以下に、IFormatProviderを指定してToStringメソッドを呼び出す例を示します。

'カルチャを en-US にして通貨書式で文字列にする
Dim ci As New System.Globalization.CultureInfo("en-US")
Console.WriteLine((10000).ToString("C", ci))
'$10,000.00

//カルチャを en-US にして通貨書式で文字列にする
System.Globalization.CultureInfo ci =
    new System.Globalization.CultureInfo("en-US");
Console.WriteLine((10000).ToString("C", ci));
//$10,000.00

String.Formatメソッドを使う

数値書式指定文字列はString.Formatメソッドで使用することもできます。String.Formatメソッドの使い方は、ぐだぐだ説明するよりも、具体例を見たほうが分かりやすいと思いますので、以下に幾つかの例を示します。

Dim s1 As String = String.Format("{0}円の商品を{1}個買う", 1000, 12)
'1000円の商品を12個買う

Dim s2 As String = String.Format("{0:C}円の商品を{1:000}個買う", 1000, 12)
'\1,000円の商品を012個買う

Dim s3 As String = String.Format("{0,9:C}円の商品を{1,-9:000}個買う", 1000, 12)
'   \1,000円の商品を012      個買う

Dim s4 As String = String.Format("{0,9}円の商品を{1,-9}個買う", 1000, 12)
'     1000円の商品を12       個買う

string s1 = string.Format("{0}円の商品を{1}個買う", 1000, 12);
//1000円の商品を12個買う

string s2 = string.Format("{0:C}円の商品を{1:000}個買う", 1000, 12);
//\1,000円の商品を012個買う

string s3 = string.Format("{0,9:C}円の商品を{1,-9:000}個買う", 1000, 12);
//   \1,000円の商品を012      個買う

string s4 = string.Format("{0,9}円の商品を{1,-9}個買う", 1000, 12);
//     1000円の商品を12       個買う

一番目の例では、書式を指定せずに、2つの数値を定型文の中に埋め込んでいます。{(数字)} の部分に、その後に指定されたパラメータの値が文字列に変換されて埋め込まれます。{ } 内の数字は、言うまでもなく、そこに埋め込むパラメータの番号（一番初めが0）です。この例では2つの値だけを埋め込みましたが、何個でも構いません。

2番目の例では、書式を指定しています。{ } 内で、番号に続けてコロンと書式を記述します。

3番目の例では、書式と、さらに最小幅を指定しています。最小幅よりそこに埋め込まれる文字列が小さいと、最小幅になるように、その文字列の左側にスペース文字が挿入されます。最小幅に負の数を指定した時は、右側にスペースが挿入されます。

4番目の例は、書式を指定せずに、最小幅だけを指定した例です。

このような機能は、「複合書式指定機能」と呼ばれています。複合書式指定機能についてより詳しくは、MSDNの「複合書式設定」をご覧ください。

• 関連：
• 文字列を数値に変換する、数値を文字列に変換する
• 日時（DateTimeオブジェクト）を文字列に変換する

• 履歴：
• 2006/12/2 表を追加。
• 2010/12/7 全面的に書き換える。