カスタム数値書式指定文字列

カスタム数値書式指定文字列は、ユーザーが 1 つ以上のカスタム数値書式指定子を使用して作成するもので、数値データの書式設定方法を定義します。カスタム数値書式指定文字列は、標準の数値書式指定文字列ではない任意の文字列と同等として定義されます。

カスタム数値書式指定子を次の表に示します。各書式指定子によって生成される出力の例については、「カスタム数値書式指定文字列の出力例」を参照してください。詳細については、表の後の「メモ」を参照してください。

メモ

浮動小数点の無限大値と NaN (非数) 値

Single の浮動小数点型または Double の浮動小数点型が正の無限大、負の無限大、または NaN (非数) である場合は、書式指定文字列とは関係なく、現在適用可能な NumberFormatInfo オブジェクトによって指定される PositiveInfinitySymbol、NegativeInfinitySymbol、または NaNSymbol の各プロパティの値が、書式設定された文字列となることに注意してください。

コントロール パネルの設定

コントロール パネルの [地域と言語のオプション] での設定は、書式設定操作によって生成される結果の文字列に影響します。これらの設定は、現在のスレッド カルチャに関連付けられた NumberFormatInfo オブジェクトを初期化するために使用され、現在のスレッド カルチャから書式設定の制御に使用される値が提供されます。コンピュータで使用する設定が異なる場合は、生成される文字列も異なります。

丸めと固定小数点の書式指定文字列

固定小数点の書式指定文字列 (つまり指数表記の書式指定文字を含まない書式指定文字列) の場合は、小数点以下の桁数が小数点の右側にある桁プレースホルダの数と同じである数値に丸められます。書式指定文字列に小数点が含まれていない場合には、最も近い整数に丸められます。数値の桁数が、整数部の桁プレースホルダの数よりも大きい場合には、桁プレースホルダに収まらない桁が、結果の文字列の 1 番目の桁プレースホルダの直前にコピーされます。

セクション区切り記号と条件付き書式設定

数値が正の値、負の値、ゼロのいずれかであるかによって、異なる書式を文字列に適用できます。このように数値の内容によって適用する書式を変更するには、カスタム書式指定文字列に、セミコロンで区切ったセクションを最大 3 つまで作成します。これらのセクションの説明を次に示します。

セクション区切り記号は、最後の値が書式設定されるときに、数値に関連付けられた既存の書式設定をすべて無視します。たとえば、セクション区切り記号を使用する場合、負の値はマイナス記号を付けずに表示されます。最終的に書式設定された値にマイナス記号を付ける場合は、カスタム書式指定子の中に明示的にマイナス記号を含める必要があります。

セクション区切り記号を使用して、書式設定された文字列を作成する方法を次のコードに示します。

Dim MyPos As Double = 19.95
Dim MyNeg As Double = -19.95
Dim MyZero As Double = 0

' In the U.S. English culture, MyString has the value: $19.95.
Dim MyString As String = MyPos.ToString("$#,##0.00;($#,##0.00);Zero")

' In the U.S. English culture, MyString has the value: ($19.95).
' The minus sign is omitted by default.
MyString = MyNeg.ToString("$#,##0.00;($#,##0.00);Zero")

' In the U.S. English culture, MyString has the value: Zero.
MyString = MyZero.ToString("$#,##0.00;($#,##0.00);Zero")

double MyPos = 19.95, MyNeg = -19.95, MyZero = 0.0;

// In the U.S. English culture, MyString has the value: $19.95.
string MyString = MyPos.ToString("$#,##0.00;($#,##0.00);Zero");

// In the U.S. English culture, MyString has the value: ($19.95).
// The minus sign is omitted by default.
MyString = MyNeg.ToString("$#,##0.00;($#,##0.00);Zero");

// In the U.S. English culture, MyString has the value: Zero.
MyString = MyZero.ToString("$#,##0.00;($#,##0.00);Zero");

2 つのカスタム書式の例

次のコードは、カスタム数値の書式設定を示しています。どちらの場合も、カスタム書式指定文字列内の桁プレースホルダ (#) によって数値データが表示され、それ以外の文字はすべて出力にコピーされます。

Dim myDouble As Double = 1234567890
Dim myString As String = myDouble.ToString( "(###) ### - ####" )
' The value of myString is "(123) 456 – 7890".

Dim MyInt As Integer = 42
MyString = MyInt.ToString( "My Number = #" )
' In the U.S. English culture, MyString has the value: 
' "My Number = 42".

Double myDouble = 1234567890;
String myString = myDouble.ToString( "(###) ### - ####" );
// The value of myString is "(123) 456 – 7890".

int  MyInt = 42;
MyString = MyInt.ToString( "My Number = #" );
// In the U.S. English culture, MyString has the value: 
// "My Number = 42".

参照

関連項目

NumberFormatInfo

概念

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

その他の技術情報

型の書式設定