次の方法で共有


_Application2.FormatString(Object, String, String) メソッド

定義

指定したカテゴリとオプションのパラメーターに従って、指定された文字列または XML ノードの書式を設定します。

public:
 System::String ^ FormatString(System::Object ^ varInput, System::String ^ bstrCategory, System::String ^ bstrOptions);
public string FormatString (object varInput, string bstrCategory, string bstrOptions);
abstract member FormatString : obj * string * string -> string
Public Function FormatString (varInput As Object, bstrCategory As String, bstrOptions As String) As String

パラメーター

varInput
Object

書式設定する値または XML ノード。

bstrCategory
String

書式設定に使用するカテゴリを指定する値。 値には、数値、パーセント、通貨、日付、時刻、および日時が含まれます。

bstrOptions
String

書式設定に使用するオプションを指定する値。 "optionName:value" の形式の文字列で、大文字と小文字が区別されます。

戻り値

指定されたカテゴリとオプションのパラメーターに従って書式設定された string

実装

次の例では、 オブジェクトの FormatString メソッドを Application 使用して、指定した日付文字列を長い日付形式に書式設定します。

thisApplication.<span class="label">FormatString</span>("2003-01-08", "date", "dateFormat:Long Date");

注釈

どこでも必要な場所で FormatString メソッドを使用して、指定した文字列の書式を変更できます。 アプリケーション名で修飾する必要があり、戻り値は、変数に代入するか、または文字列値が必要な式として使用する必要があります。

次のセクションでは、 と bstrOptionsに使用できる値の一覧をbstrCategory示します。

カテゴリの一覧

number 数値を使用します。 このカテゴリに対して有効なオプションは、locale、numDigits、leadingZero、grouping、decimalSep、thousandSep、および negativeOrder です。
割合 パーセント値を使用します。 このカテゴリに対して有効なオプションは、locale、numDigits、leadingZero、grouping、decimalSep、thousandSep、および negativeOrder です。
currency 通貨値を使用します。 このカテゴリに対して有効なオプションは、locale、"numDigits、leadingZero、grouping、decimalSep、thousandSep、negativeOrder、positiveOrder、および currencyLocale です。
date 日付値を使用します。 このカテゴリに対して有効なオプションは、locale、dateFormat、useAltCalendar、および useEnglishStringsAlways です。
time 時刻値を使用します。 このカテゴリに対して有効なオプションは、locale、timeFormat、および noSeconds です。
Datetime 日時値を使用します。 このカテゴリに対して有効なオプションは、locale、dateFormat、timeFormat、noSeconds、useAltCalendar、および useEnglishStringAlways です。

オプションの一覧

locale ロケール識別子 (LCID) を指定します。 指定しない場合は、既定で現在のユーザーの LCID になります。
numDigits 小数点記号の後の小数部の桁数を指定します。 値 auto を使用して、入力された小数部桁数を出力の小数部桁数にするように示すこともできます。 たとえば、1.234、1.234、1.00、1.00、1.56e2、156.00 などです。 指定しないと、地域設定の対応する値が既定で使用されます。
leadingZero 10 進数フィールドで、値の前にゼロを付けるかどうかを指定します。 0 はゼロを付けないことを意味し、1 はゼロを付けることを意味します。 指定しないと、地域設定の対応する値が既定で使用されます。
グループ 小数点の左側の各桁グループのサイズを指定します。 0 ~ 9 の範囲の値および値 32 が有効です。 値 32 は、グループが最初は 3 桁で、その後は 2 桁であることを示します。 指定しないと、地域設定の対応する値が既定で使用されます。
decimalSep 小数点の区切り文字を指定します。 指定しないと、地域設定の対応する値が既定で使用されます。
thousandSep 3 桁の区切り文字を指定します。 指定しないと、地域設定の対応する値が既定で使用されます。
negativeOrder 負の値のモードを指定します。 指定しないと、地域設定の対応する値が既定で使用されます。
positiveOrder 正の値のモードを指定します。 指定しないと、地域設定の対応する値が既定で使用されます。
currencyLocale 通貨記号に対するロケール識別子 (LCID) を指定します。 指定しないと、ロケールで指定されている値が既定で使用されます。
dateFormat 日付文字列を作成するために使用する書式設定の図の文字列を指定します。 値 Short Date、Long Date、Year Month、および none を使用して、短い日付書式、長い日付書式、年月の書式、および書式なしを示すこともできます。 Short Date、Long Date、および Year Month は、オペレーティング システムの地域設定および言語設定で提供される既定の書式です。
useAltCalendar 日付の書式設定に対して代替カレンダーを使用するかどうかを指定します。 通常のカレンダーを使用する場合は 0 を指定し、代替カレンダーを使用する場合は 1 を指定します。 指定しない場合の既定値は 0 です。
useEnglishStringsAlways 日付の書式設定に対して常に英語の文字列を使用するかどうかを指定します。 ロケールで指定されている言語を使用する場合は 0 を指定し、常に英語を使用する場合は 1 を指定します。 指定しない場合の既定値は 0 です。
timeFormat 時刻の文字列を作成するために使用する書式設定文字列を指定します。 値 none を使用して、書式設定なしを示すこともできます。 指定しないと、地域設定の時刻の書式が既定で使用されます。
noSeconds 秒を使用しないかどうかを指定します。 秒を使用する場合は 0 を指定し、秒を使用しない場合は 1 を指定します。 指定しない場合の既定値は 0 です。

適用対象