Strings.Format(Object, String) メソッド

public static string Format (object? Expression, string? Style = "");

public static string Format (object Expression, string Style = "");

static member Format : obj * string -> string

Public Function Format (Expression As Object, Optional Style As String = "") As String

パラメーター

戻り値

書式 String 式に含まれる命令に従って書式設定された文字列。

例

この例では、Format 関数を使用して、String 形式とユーザー定義形式の両方を使用して値を書式設定するさまざまな使用方法を示します。 日付区切り記号 (/)、時刻区切り記号 (:)、AM/PM インジケーター (t と tt) の場合、システムによって表示される実際の書式設定された出力は、コードで使用されているロケール設定によって異なります。 開発環境で時刻と日付が表示される場合は、コード ロケールの短い時刻形式と短い日付形式が使用されます。

Dim testDateTime As Date = #1/27/2001 5:04:23 PM#
Dim testStr As String
' Returns current system time in the system-defined long time format.
testStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
testStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date 
' format, using the single letter code for the format.
testStr = Format(Now(), "D")

' Returns the value of testDateTime in user-defined date/time formats.
' Returns "5:4:23".
testStr = Format(testDateTime, "h:m:s")
' Returns "05:04:23 PM".
testStr = Format(testDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
testStr = Format(testDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
testStr = Format(testDateTime, "HH:mm:ss")
' Returns "23".
testStr = Format(23)

' User-defined numeric formats.
' Returns "5,459.40".
testStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
testStr = Format(334.9, "###0.00")
' Returns "500.00%".
testStr = Format(5, "0.00%")

注釈

String.Format メソッドにも同様の機能があります。

ローカライズされていない数値文字列を書式設定する場合は、ユーザー定義の数値書式を使用して、目的の外観を確実に取得する必要があります。

Styleを指定せずに数値を書式設定しようとすると、Format 関数は Str 関数と同様の機能を提供しますが、これは国際的に認識されています。 ただし、Format 関数を使用して文字列として書式設定された正の数値には、値の符号用に予約された先頭のスペースは含まれません。Str 関数を使用して変換されたものは、先頭のスペースを保持します。

異なる数値の異なる形式

数値のユーザー定義書式式には、セミコロンで区切られた 1 ~ 3 つのセクションを含めることができます。 Format 関数の Style 引数に定義済みの数値書式のいずれかが含まれている場合は、1 つのセクションのみが許可されます。

次の例には、2 つのセクションがあります。最初のセクションでは、正の値と 0 の形式を定義します。2 番目のセクションでは、負の値の形式を定義します。 Format 関数の Style 引数は文字列を受け取るので、引用符で囲まれます。

Dim style1 As String = "$#,##0;($#,##0)"

セミコロンの間に何も含まれていない場合、不足しているセクションは正の値の形式を使用して出力されます。 たとえば、次の形式では、最初のセクションの書式を使用して正の値と負の値が表示され、値が 0 の場合は Zero 表示されます。

Dim style2 As String = "$#,##0;;\Z\e\r\o"

定義済みの数値書式

次の表は、定義済みの数値書式名を示しています。 これらは、Format 関数の Style 引数として名前で使用できます。

スマート デバイス開発者向けノート

Yes/No、True/False、および On/Off 形式はサポートされていません。

数値形式の User-Defined

次の表は、ユーザー定義の数値書式の作成に使用できる文字を示しています。 これらは、Format 関数の Style 引数を作成するために使用できます。

従来のコード例

次の表に、数値の書式式の例をいくつか示します。 (これらの例はすべて、システムのロケール設定が英語と米国であることを前提としています)最初の列には、Format 関数の Style 引数の書式指定文字列が含まれています。書式設定されたデータが列見出しに指定された値を持つ場合、他の列には結果の出力が含まれます。

定義済みの日付/時刻形式

次の表は、定義済みの日付と時刻の形式名を示しています。 これらは、Format 関数のスタイル引数として名前で使用できます。

アプリケーションの現在のカルチャ情報の詳細については、「Visual Basicのカルチャが文字列に与える影響 」を参照してください。

日付/時刻形式の User-Defined

次の表に、ユーザー定義の日付/時刻形式の作成に使用できる文字を示します。 以前のバージョンの Visual Basic とは異なり、これらの形式文字では大文字と小文字が区別されます。

従来のコード例

December 7, 1958, 8:50 PM, 35 secondsのユーザー定義の日付と時刻の形式の例を次に示します。

スマート デバイス開発者向けノート

デバイスの最小時間解像度は、デバイスの製造元によって決まります。 デバイスの時間解決が十分に粗い場合、f 形式の文字は、そのデバイスで実行されるときに 0 を返します。

適用対象

こちらもご覧ください

• Format(String, Object)
• Str(Object)
• 文字列操作の概要