Formatter クラス

定義

名前空間:

Java.Util

アセンブリ:

Mono.Android.dll

printf スタイルの書式指定文字列のインタープリター。

[Android.Runtime.Register("java/util/Formatter", DoNotGenerateAcw=true)]
public sealed class Formatter : Java.Lang.Object, IDisposable, Java.IO.ICloseable, Java.IO.IFlushable

[<Android.Runtime.Register("java/util/Formatter", DoNotGenerateAcw=true)>]
type Formatter = class
    inherit Object
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IFlushable

継承

Object

JavaObject

Object

Formatter

属性

RegisterAttribute

実装

IJavaObject IJavaPeerable ICloseable IFlushable IDisposable

注釈

printf スタイルの書式指定文字列のインタープリター。 このクラスは、レイアウトの理由と配置、数値、文字列、日付/時刻データの一般的な形式、およびロケール固有の出力をサポートします。 byte、java.math.BigDecimal BigDecimal、Calendarなどの一般的なJavaの種類がサポートされています。 Formattable インターフェイスを使用して、任意のユーザーの種類に対する制限付き書式のカスタマイズが提供されます。

フォーマッタは、マルチスレッド アクセスに対して必ずしも安全であるとは限りません。 スレッド セーフは省略可能であり、このクラスのメソッドのユーザーの責任です。

Java言語の書式設定された印刷は、C のprintfに大きな影響を受けます。 書式指定文字列は C に似ていますが、Java言語に対応し、その機能の一部を利用するためにいくつかのカスタマイズが行われています。 また、Java書式設定は C よりも厳密です。たとえば、変換がフラグと互換性がない場合は、例外がスローされます。 C では、適用できないフラグは自動的に無視されます。 したがって、書式指定文字列は C プログラマが認識できるように意図されていますが、必ずしも C のプログラマと完全に互換性があるわけではありません。

想定される使用方法の例:

<blockquote>

StringBuilder sb = new StringBuilder();
              // Send all output to the Appendable object sb
              Formatter formatter = new Formatter(sb, Locale.US);

              // Explicit argument indices may be used to re-order output.
              formatter.format("%4$2s %3$2s %2$2s %1$2s", "a", "b", "c", "d")
              // -> " d  c  b  a"

              // Optional locale as the first argument can be used to get
              // locale-specific formatting of numbers.  The precision and width can be
              // given to round and align the value.
              formatter.format(Locale.FRANCE, "e = %+10.4f", Math.E);
              // -> "e =    +2,7183"

              // The '(' numeric flag may be used to format negative numbers with
              // parentheses rather than a minus sign.  Group separators are
              // automatically inserted.
              formatter.format("Amount gained or lost since last statement: $ %(,.2f",
                               balanceDelta);
              // -> "Amount gained or lost since last statement: $ (6,217.58)"

</blockquote>

一般的な書式設定要求の便利なメソッドは、次の呼び出しで示すように存在します。

<blockquote>

// Writes a formatted string to System.out.
              System.out.format("Local time: %tT", Calendar.getInstance());
              // -> "Local time: 13:34:18"

              // Writes formatted output to System.err.
              System.err.printf("Unable to open file '%1$s': %2$s",
                                fileName, exception.getMessage());
              // -> "Unable to open file 'food': No such file or directory"

</blockquote>

C の sprintf(3)と同様に、文字列は静的メソッド String#format(String,Object...) String.formatを使用して書式設定できます。

<blockquote>

// Format a string containing a date.
              import java.util.Calendar;
              import java.util.GregorianCalendar;
              import static java.util.Calendar.*;

              Calendar c = new GregorianCalendar(1995, MAY, 23);
              String s = String.format("Duke's Birthday: %1$tb %1$te, %1$tY", c);
              // -> s == "Duke's Birthday: May 23, 1995"

</blockquote>

<h2>"org">Organization</h2>

この仕様は、2 つのセクションに分かれています。 最初のセクション「概要」では、基本的な書式設定の概念について説明します。 このセクションは、他のプログラミング言語で書式設定された印刷に慣れているユーザーを対象としています。 2 番目のセクション「詳細」では、特定の実装の詳細について説明します。 これは、書式設定の動作をより正確に指定する必要があるユーザーを対象としています。

<h2>"summary">Summary</h2>

このセクションでは、書式設定の概念について簡単に説明します。 正確な動作の詳細については、「詳細」セクションを参照してください。

<h3>"syntax">Format String Syntax</h3>

書式設定された出力を生成するすべてのメソッドには、 書式指定文字列 と 引数リストが必要です。 書式指定文字列は、固定テキストと 1 つ以上の埋め込みStringを含む可能性があるです。 次の例を確認してください。

<blockquote>

Calendar c = ...;
              String s = String.format("Duke's Birthday: %1$tm %1$te,%1$tY", c);

</blockquote>

この書式指定文字列は、 format メソッドの最初の引数です。 これには、引数の処理方法とテキストに挿入する場所を示す 3 つの書式指定子 "%1$tm"、"%1$te"、および "%1$tY" が含まれています。 書式指定文字列の残りの部分は、 "Dukes Birthday: " およびその他のスペースや句読点を含む固定テキストです。

引数リストは、書式指定文字列の後にメソッドに渡されるすべての引数で構成されます。 上記の例では、引数リストはサイズ 1 で、 java.util.Calendar Calendar オブジェクト cで構成されています。

<ul>

<li> 一般型、文字型、数値型の書式指定子には、次の構文があります。

<blockquote>

%[argument_index$][flags][width][.precision]conversion

</blockquote>

省略可能 なargument_index は、引数リスト内の引数の位置を示す 10 進整数です。 最初の引数は "1$" で参照され、2 番目の引数は "2$" などによって参照されます。

省略可能な フラグ は、出力形式を変更する文字のセットです。 有効なフラグのセットは、変換によって異なります。

省略可能な 幅 は、出力に書き込まれる最小文字数を示す正の 10 進整数です。

省略可能 な有効桁数 は、通常、文字数を制限するために使用される負以外の 10 進整数です。 具体的な動作は、変換によって異なります。

必要な 変換 は、引数の書式設定方法を示す文字です。 特定の引数に対して有効な変換のセットは、引数のデータ型によって異なります。

<li> 日付と時刻を表すために使用される型の書式指定子には、次の構文があります。

<blockquote>

%[argument_index$][flags][width]conversion

</blockquote>

省略可能な argument_index、 フラグ 、および 幅 は、上記のように定義されます。

必要な 変換 は 2 文字シーケンスです。 最初の文字は 't' または 'T'です。 2 番目の文字は、使用する形式を示します。 これらの文字は GNU date および POSIX strftime(3c)で定義されているものと似ていますが、まったく同じではありません。

<li> 引数に対応しない書式指定子には、次の構文があります。

<blockquote>

%[flags][width]conversion

</blockquote>

省略可能な フラグ と 幅 は、上記のように定義されています。

必要な 変換 は、出力に挿入する内容を示す文字です。

</ul>

<h3> 変換 </h3>

変換は次のカテゴリに分類されます。

<ol>

<li><b>General</b> - 任意の引数型に適用できます

<li><b>Character</b> - Unicode 文字を表す基本型 ( char、 Character、 byte、 Byte、 short、 Short) に適用できます。 この変換は、intが IntegerCharacter#isValidCodePointlitrue<b>Numeric</b を返すときに、>型と<型にも適用できます。>

<ol>

<li><b>Integral</b> - byte、Java Byte、short、Short、int、Integer、long、Long、java.math.BigInteger BigInteger (ただし、charまたはCharacterではない) の整数型に適用できます。

<li><b>浮動小数点</b> - float、Float、double、Double、およびjava.math.BigDecimal BigDecimal</ol のJava浮動小数点型に適用できます>

<li><b>Date/Time</b> - 日付または時刻をエンコードできるJava型 (long、Long、Calendar、Date、および TemporalAccessor TemporalAccessor<li><b>Percent</b> - リテラル '%' ('\u0025') を生成する場合があります。

<li><b>Line Separator</b> - プラットフォーム固有の行区切り記号を生成します

</ol>

カテゴリ General、 Character、 Numeric、 Integral 、 Date/Time の変換の場合、特に指定しない限り、引数 arg が null場合、結果は "null" になります。

次の表に、サポートされている変換の概要を示します。 大文字 (つまり、 'B'、 'H'、 'S'、 'C'、 'X'、 'E'、 'G'、 'A'、および 'T') で示される変換は、対応する小文字の変換文字の変換と同じですが、結果は一般的な java.util.Locale Localeの規則に従って大文字に変換される点が異なります。 インスタンスの構築時、またはそのメソッド呼び出しのパラメーターとして明示的なロケールが指定されていない場合は、 java.util.Locale.Category#FORMAT default locale が使用されます。

<table class="striped"><caption style="display:none">genConv</caption><thead><tr><th scope="col" style="vertical-align:bottom"> Conversion <th scope="col" style="vertical-align:bottom"> 引数カテゴリ <th scope="col" style="vertical-align:bottom"> Description </thead><tbody><tr><th scope="row" style="vertical-align:top">'b', 'B'<td style="vertical-align:top"一般的な>td<>引数 arg がnullの場合、結果は "false" になります。 arg がbooleanまたはBooleanの場合、結果はString#valueOf(boolean) String.valueOf(arg)によって返される文字列になります。 それ以外の場合、結果は "true" になります。

<tr><th scope="row" style="vertical-align:top">'h', 'H'<td style="vertical-align:top"> general <td> 結果は、 Integer.toHexString(arg.hashCode())を呼び出すことによって取得されます。

<tr><th scope="row" style="vertical-align:top">'s', 'S'<td style="vertical-align:top"> general <td>arg が Formattableを実装している場合は、 Formattable#formatTo arg.formatTo が呼び出されます。 それ以外の場合、結果は arg.toString()を呼び出すことによって取得されます。

<tr><th scope="row" style="vertical-align:top">'c', 'C'<td style="vertical-align:top"> character <td> 結果は Unicode 文字です

<tr><th scope="row" style="vertical-align:top">'d'<td style="vertical-align:top"> 整数 <td> 結果は 10 進整数として書式設定されます

<tr><th scope="row" style="vertical-align:top">'o'<td style="vertical-align:top"> 整数 <td> 結果は 8 進数で書式設定されます

<tr><th scope="row" style="vertical-align:top">'x', 'X'<td style="vertical-align:top"> 整数 <td> 結果は 16 進数の整数として書式設定されます

<tr><th scope="row" style="vertical-align:top">'e', 'E'<td style="vertical-align:top"> 浮動小数点 <td> 結果は、コンピューター化された科学的表記で 10 進数として書式設定されます

<tr><th scope="row" style="vertical-align:top">'f'<td style="vertical-align:top"> 浮動小数点 <td> 結果は 10 進数として書式設定されます

<tr><th scope="row" style="vertical-align:top">'g', 'G'<td style="vertical-align:top"> 浮動小数点 <td> 結果は、四捨五入後の精度と値に応じて、コンピューター化された指数表記または 10 進形式を使用して書式設定されます。

<tr><th scope="row" style="vertical-align:top">'a', 'A'<td style="vertical-align:top"> 浮動小数点 <td> 結果は、符号と指数を持つ 16 進数の浮動小数点数として書式設定されます。 この変換は<></b>BigDecimal引数カテゴリにあるにもかかわらず、型でサポートされます。

<tr><th scope="row" style="vertical-align:top">'t', 'T'<td style="vertical-align:top"> date/time <td> 日時変換文字のプレフィックス。 日付/時刻変換を参照してください。

<tr><th scope="row" style="vertical-align:top">'%'<td style="vertical-align:top"> percent <td> 結果はリテラル '%' ('\u0025') です

<tr><th scope="row" style="vertical-align:top">'n'<td style="vertical-align:top"> line separator <td> 結果はプラットフォーム固有の行区切り記号です

</tbody></table>

変換として明示的に定義されていない文字は無効であり、将来の拡張機能用に予約されています。

<h3>"dt">Date/Time Conversions</h3>

次の日時変換サフィックス文字は、 't' および 'T' 変換に対して定義されます。 型は GNU date および POSIX strftime(3c)で定義されているものと似ていますが、完全には同じではありません。 Java固有の機能にアクセスするための追加の変換の種類が用意されています (たとえば、2 秒以内のミリ秒の'L')。

書式設定には、次の変換文字が使用されます。

<table class="striped"><caption style="display:none">time</caption><tbody><tr><th scope="row" style="vertical-align:top">'H'<td> 必要に応じて先頭に 0 を付けた 2 桁の数字で書式設定された、24 時間制の時刻の時刻 。 00 - 23。

<tr><th scope="row" style="vertical-align:top">'I'<td> hour for the 12-hour, formatted as two digits with a leading zero as necessary, e. 01 - 12.

<tr><th scope="row" style="vertical-align:top">'k'<td> 24 時間制の時刻 (つまり、 0 - 23)。

<tr><th scope="row" style="vertical-align:top">'l'<td> hour for the 12-hour clock,つまり、 1 - 12。

<tr><th scope="row" style="vertical-align:top">'M'<td> 必要に応じて先頭に 0 を付けた 2 桁の数字 (つまり、 00 - 59) で書式設定された時間内の分。

<tr><th scope="row" style="vertical-align:top">'S'<td> 秒(秒)、必要に応じて先頭に 0 を付けた 2 桁の数字 (つまり、 00 - 60 ("60" は、うるう秒をサポートするために必要な特別な値) として書式設定されます。

<tr><th scope="row" style="vertical-align:top">'L'<td> 必要に応じて先頭にゼロが付いた 3 桁の 2 桁目のミリ秒 (つまり、 000 - 999)。

<tr><th scope="row" style="vertical-align:top">'N'<td> nanosecond in the second, formatted as nine digits with leading zeros as necessary, e. 000000000 - 999999999.

<tr><th scope="row" style="vertical-align:top">'p'<td> ロケール固有の java.text.DateFormatSymbols#getAmPmStrings の午前または午後のマーカー (小文字など)"am" または "pm" です。 変換プレフィックス 'T' 使用すると、この出力が大文字になります。

<tr><th scope="row" style="vertical-align:top">'z'<td>RFC 822 スタイルの数値タイム ゾーン オフセット (たとえば、 -0800)。 この値は、夏時間に必要に応じて調整されます。 long、Long、およびDateの場合、使用されるタイム ゾーンは、Java仮想マシンのこのインスタンスの TimeZone#getDefault() 既定のタイム ゾーンです。

<tr><th scope="row" style="vertical-align:top">'Z'<td> タイム ゾーンの省略形を表す文字列。 この値は、夏時間に必要に応じて調整されます。 long、Long、およびDateの場合、使用されるタイム ゾーンは、Java仮想マシンのこのインスタンスの TimeZone#getDefault() 既定のタイム ゾーンです。 フォーマッタのロケールは、引数のロケール (存在する場合) よりも優先されます。

<tr><th scope="row" style="vertical-align:top">'s'<td> 1970 年 1 月 1 日から UTC 00:00:00 開始したエポックの開始からの秒数 (つまり、Long.MIN_VALUE/1000にLong.MAX_VALUE/1000)。

<tr><th scope="row" style="vertical-align:top">'Q'<td> 1970 年 1 月 1 日以降のエポックの開始から UTC 00:00:00ミリ秒 (つまり、Long.MIN_VALUEにLong.MAX_VALUE)。

</tbody></table>

日付の書式設定には、次の変換文字が使用されます。

<table class="striped"><caption style="display:none">date</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'B'<td> ロケール固有の java.text.DateFormatSymbols#getMonths full month name ( "January"、 "February"など)。

<tr><th scope="row" style="vertical-align:top">'b'<td> ロケール固有の java.text.DateFormatSymbols#getShortMonths 省略された月の名前 (例: "Jan"、 "Feb")。

<tr><th scope="row" style="vertical-align:top">'h'<td>'b'と同じです。

<tr><th scope="row" style="vertical-align:top">'A'<td> java.text.DateFormatSymbols#getWeekdays day of the week, 例: "Sunday","Monday"<tr><th scope="row" style="vertical-align:top">'a'<td> java.text.DateFormatSymbols#getShortWeekdays day of the week, 例: "Sun"、"Mon"<tr><th scope="row" style="vertical-align:top">'C'<td> 4 桁の年を100で除算は、必要に応じて先頭に 0 を付けた 2 桁の数字で書式設定されます。つまり、00 - 99<tr><th scope="row" style="vertical-align:top">'Y'<td> Year。必要に応じて先頭に 0 が付いた 4 桁以上の数字で書式設定されます 。たとえば、グレゴリオ暦の CE 0092等しい92。

<tr><th scope="row" style="vertical-align:top">'y'<td> 年の最後の 2 桁の数字。必要に応じて先頭にゼロ (つまり、 00 - 99) で書式設定されます。

<tr><th scope="row" style="vertical-align:top">'j'<td> 年の日。グレゴリオ暦の 001 - 366 など、必要に応じて先頭にゼロが付いた 3 桁の数字で書式設定されます。

<tr><th scope="row" style="vertical-align:top">'m'<td> Month。必要に応じて先頭にゼロが付いた 2 桁の形式 (つまり、 01 - 13)。

<tr><th scope="row" style="vertical-align:top">'d'<td> day of month, formatted as two digits with leading zeros as necessary, e. 01 - 31<tr><th scope="row" style="vertical-align:top">'e'<td> Day of month, formatted as two digits, e. 1 - 31.

</tbody></table>

次の変換文字は、一般的な日付/時刻構成の書式設定に使用されます。

<table class="striped"><caption style="display:none">composites</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'R'<td>"%tH:%tM"<tr><th scope="row" style="vertical-align:top">'T'<td> 24 時間クロック用に書式設定された時刻を "%tH:%tM:%tS"として書式設定した時刻。

<tr><th scope="row" style="vertical-align:top">'r'<td>"%tI:%tM:%tS %Tp"として 12 時間のクロックに書式設定された時刻。 午前または午後のマーカー ('%Tp') の場所はロケールによって異なる場合があります。

<tr><th scope="row" style="vertical-align:top">'D'<td>"%tm/%td/%ty" 形式の日付。

<tr><th scope="row" style="vertical-align:top">'F'<td>ISO 8601 complete date formatted as "%tY-%tm-%td".

<tr><th scope="row" style="vertical-align:top">'c'<td>"%ta %tb %td %tT %tZ %tY" として書式設定された日付と時刻 (例: "Sun Jul 20 16:17:00 EDT 1969")。

</tbody></table>

日付/時刻変換サフィックスとして明示的に定義されていない文字は無効であり、将来の拡張機能用に予約されています。

<h3> フラグ </h3>

次の表は、サポートされているフラグをまとめたものです。 y は、指定された引数型に対してフラグがサポートされていることを意味します。

<table class="striped"><caption style="display:none">genConv</caption><thead><tr><th scope="col" style="vertical-align:bottom"> フラグ <th scope="col" style="vertical-align:bottom" > General <th scope="col" style="vertical-align:bottom"> Character <th scope="col" style="vertical-align:bottom"> Integer <th scope="col" style="vertical-align:bottom"> Floating Point <th scope="col" style="vertical-align:bottom"> Date/Time <th scope="col" style="vertical-align:bottom"> Description </thead><tbody><tr><th scope="row"> '-' <td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top;> y <td style="text-align:center; vertical-align:top"> y <td style="text-align:center;vertical-align:top"> y <td> 結果は左揃えになります。

<tr><th scope="row"> '#' <td style="text-align:center; vertical-align:top" > y^/sup<td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> y³<td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> - <td> 変換依存の代替フォームを使用する必要があります。

<tr><th scope="row"> '+' <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> y⁴<td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> - <td> 結果には常に符号が含まれます。

<tr><th scope="row"> ' >' <td style="text-align:center;vertical-align:top"> - <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> y⁴<td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> - <td> 結果には正の値の先頭のスペースが含まれます

<tr><th scope="row"> '0' <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> - <td> 結果はゼロ埋め込みになります

<tr><th scope="row"> ',' <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> y²<td style="text-align:center; vertical-align:top"> y<sup>/sup<><td style="text-align:center; vertical-align:top"> - <td>結果には、ロケール固有の java.text.DecimalFormatSymbols#getGroupingSeparator グループ区切り記号<tr><th scope="row"> '(' <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> y<sup>/sup<><td style="text-align:center; vertical-align:top"> y⁵<tddstyle="text-align:center"> - <td> 結果は負の数をかっこで囲みます

</tbody></table>

¹Formattableの定義によって異なります。

²'d' 変換のみ。

³'o'、 'x'、および 'X' 変換の場合のみ。

⁴'d'、'o'、'x'、'X'、java.math.BigInteger BigInteger、'd'、byte、およびByteに適用されるshortまたはShortに適用されるint、Integer、long、およびLong変換の場合。

⁵'e'、 'E'、 'f'、 'g'、および 'G' 変換の場合のみ。

フラグとして明示的に定義されていない文字は無効であり、将来の拡張機能用に予約されています。

<h3> Width </h3>

幅は、出力に書き込まれる最小文字数です。 行区切り記号の変換では、幅は適用されません。指定された場合は、例外がスローされます。

<h3> Precision </h3>

一般的な引数型の場合、有効桁数は出力に書き込まれる最大文字数です。

浮動小数点変換 'a'、 'A'、 'e'、 'E'、および 'f' の場合、有効桁数は基数の後の桁数です。 変換が 'g' または 'G'の場合、有効桁数は丸め後の結果の大きさの合計桁数になります。

文字、整数、日付/時刻の引数の型と、パーセントおよび行区切り記号の変換の場合、有効桁数は適用されません。有効桁数が指定されている場合は、例外がスローされます。

<h3> 引数インデックス </h3>

引数インデックスは、引数リスト内の引数の位置を示す 10 進整数です。 最初の引数は "1$" で参照され、2 番目の引数は "2$" などによって参照されます。

位置によって引数を参照するもう 1 つの方法は、 '<' ('\u003c') フラグを使用することです。これにより、前の書式指定子の引数が再利用されます。 たとえば、次の 2 つのステートメントは同じ文字列を生成します。

<blockquote>

Calendar c = ...;
              String s1 = String.format("Duke's Birthday: %1$tm %1$te,%1$tY", c);

              String s2 = String.format("Duke's Birthday: %1$tm %<te,%<tY", c);

</blockquote>

<hr><h2>"detail">Details</h2>

このセクションでは、条件と例外、サポートされているデータ型、ローカライズ、フラグ、変換、およびデータ型間の相互作用など、書式設定の動作の詳細を提供することを目的としています。 書式設定の概念の概要については、「概要」を参照してください。

変換、日付/時刻変換サフィックス、またはフラグとして明示的に定義されていない文字は無効であり、将来の拡張機能用に予約されています。 このような文字を書式指定文字列で使用すると、 UnknownFormatConversionException または UnknownFormatFlagsException がスローされます。

書式指定子に無効な値を持つ幅または有効桁数が含まれている場合、またはサポートされていない場合は、それぞれ IllegalFormatWidthException または IllegalFormatPrecisionException がスローされます。 同様に、引数インデックスの値が 0 の場合、 IllegalFormatExceptionになります。

書式指定子に対応する引数に適用できない変換文字が含まれている場合は、 IllegalFormatConversionException がスローされます。

有効桁数の値は、0 から Integer#MAX_VALUE までの範囲である必要があります。それ以外の場合は、IllegalFormatPrecisionExceptionがスローされます。

width の値は、1 から Integer#MAX_VALUE までの範囲である必要があります。それ以外の場合は、IllegalFormatWidthExceptionがスローされます。幅は負の値を持っているように見えますが、負の符号はフラグです。 たとえば、書式指定文字列"%-20s"幅は 20 で、フラグは "-" です。

インデックスの値は、1 ~ Integer#MAX_VALUEの範囲である必要があります。それ以外の場合は、IllegalFormatExceptionがスローされます。

指定されたすべての例外は、formatのいずれかのFormatterメソッドと、formatやString#format(String,Object...) String.formatなどのjava.io.PrintStream#printf(String,Object...) PrintStream.printf便利なメソッドによってスローされる可能性があります。

カテゴリ General、 Character、 Numeric、 Integral 、 Date/Time の変換の場合、特に指定しない限り、引数 arg が null場合、結果は "null" になります。

大文字 (つまり、 'B'、 'H'、 'S'、 'C'、 'X'、 'E'、 'G'、 'A'、および 'T') で示される変換は、対応する小文字の変換文字の変換と同じですが、結果は一般的な java.util.Locale Localeの規則に従って大文字に変換される点が異なります。 インスタンスの構築時、またはそのメソッド呼び出しのパラメーターとして明示的なロケールが指定されていない場合は、 java.util.Locale.Category#FORMAT default locale が使用されます。

<h3>"dgen">General</h3>

次の一般的な変換は、任意の引数の型に適用できます。

<table class="striped"><caption style="display:none">dgConv</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'b'<td style="vertical-align:top">'\u0062'<td>trueによって返される "false" または "Boolean#toString(boolean)" のいずれかを生成します。

引数が null場合、結果は "false" になります。 引数が boolean または Booleanの場合、結果は String#valueOf(boolean) String.valueOf()によって返される文字列になります。 それ以外の場合、結果は "true" になります。

'#' フラグを指定すると、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'B'<td style="vertical-align:top">'\u0042'<td>'b'の大文字のバリアント。

<tr><th scope="row" style="vertical-align:top">'h'<td style="vertical-align:top">'\u0068'<td> オブジェクトのハッシュ コード値を表す文字列を生成します。

結果は、 Integer.toHexString(arg.hashCode())を呼び出すことによって取得されます。

'#' フラグを指定すると、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'H'<td style="vertical-align:top">'\u0048'<td>'h'の大文字のバリアント。

<tr><th scope="row" style="vertical-align:top">'s'<td style="vertical-align:top">'\u0073'<td> 文字列を生成します。

引数が Formattableを実装する場合は、その Formattable#formatTo formatTo メソッドが呼び出されます。 それ以外の場合、結果は引数の toString() メソッドを呼び出すことによって取得されます。

'#' フラグが指定され、引数がFormattableでない場合は、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'S'<td style="vertical-align:top">'\u0053'<td>'s'の大文字のバリアント。

</tbody></table>

次の "dFlags">フラグは、一般的な変換に適用されます。

<table class="striped"><caption style="display:none">dFlags</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'-'<td style="vertical-align:top">'\u002d'<td> Left は出力を正当化します。 フィールドの最小幅を埋めるために必要に応じて、変換された値の末尾にスペース ('\u0020') が追加されます。 幅が指定されていない場合は、 MissingFormatWidthException がスローされます。 このフラグが指定されていない場合、出力は右揃えになります。

<tr><th scope="row" style="vertical-align:top">'#'<td style="vertical-align:top">'\u0023'<td> 出力で代替フォームを使用する必要があります。 フォームの定義は、変換によって指定されます。

</tbody></table>

"genWidth">width は、出力に書き込まれる最小文字数です。 変換後の値の長さが幅より小さい場合、出力は、合計文字数が幅と等しくなるまで、 '  ' ('\u0020') によって埋め込まれます。 パディングは既定で左側にあります。 '-' フラグが指定されている場合、パディングは右側に表示されます。 幅が指定されていない場合は、最小値はありません。

有効桁数は、出力に書き込まれる最大文字数です。 精度は幅の前に適用されるため、幅が有効桁数より大きい場合でも、出力は precision 文字に切り捨てられます。 有効桁数が指定されていない場合、文字数に明示的な制限はありません。

<h3>"dchar">Character</h3>

この変換は、 char と Characterに適用できます。 また、byteがByteを返すときに、short、Short、int、Integer、Character#isValidCodePoint、trueの型にも適用できます。 false返された場合は、IllegalFormatCodePointExceptionがスローされます。

<table class="striped"><caption style="display:none">charConv</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'c'<td style="vertical-align:top">'\u0063'<td> Unicode 文字表現で説明されているように、引数を Unicode 文字として書式設定します。 引数が補助文字を表す場合は、複数の 16 ビット char を指定できます。

'#' フラグを指定すると、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'C'<td style="vertical-align:top">'\u0043'<td>'c'の大文字のバリアント。

</tbody></table>

全般変換に定義されている '-' フラグが適用されます。 '#' フラグを指定すると、FormatFlagsConversionMismatchExceptionがスローされます。

幅は、一般変換の場合と同じように定義されます。

有効桁数は適用されません。 有効桁数を指定すると、 IllegalFormatPrecisionException がスローされます。

<h3>"dnum">Numeric</h3>

数値変換は、次のカテゴリに分類されます。

<ol>

<li><b>Byte、Short、Integer、Long</b><li><b>BigInteger</b><li><b>Float および Double</b><li><b>BigDecimal</b></ol>

数値型は、次のアルゴリズムに従って書式設定されます。

<b>"L10nAlgorithm"> 数値ローカリゼーション アルゴリズム</b>

整数部、小数部、指数部 (データ型に応じて) の数字が取得されると、次の変換が適用されます。

<ol>

<li> 文字列内の各桁の 文字 d は、現在のロケールの java.text.DecimalFormatSymbols#getZeroDigit() ゼロ桁z に対して計算されたロケール固有の数字 ( d - '0'>+ z.

<li> 小数点区切り記号が存在する場合は、ロケール固有の java.text.DecimalFormatSymbols#getDecimalSeparator 小数点区切り記号が置き換えられます。

<li>',' ('\u002c') "L10nGroup">フラグが指定されている場合、ロケール固有の java.text.DecimalFormatSymbols#getGroupingSeparator グループ化区切り記号は、文字列の整数部分を最下位から最上位の数字までスキャンし、ロケールの java.text.DecimalFormat#getGroupingSize() グループ化サイズで定義された間隔で区切り記号を挿入することによって挿入されます。

<li>'0' フラグが指定されている場合、文字列の長さが要求されたフィールド幅と等しくなるまで、ロケール固有の java.text.DecimalFormatSymbols#getZeroDigit() の 0 桁が符号文字の後(存在する場合)、最初のゼロ以外の数字の前に挿入されます。

<li> 値が負の値で、 '(' フラグが指定されている場合は、 '(' ('\u0028') が付加され、 ')' ('\u0029') が追加されます。

<li> 値が負の値 (または浮動小数点の負のゼロ) であり、 '(' フラグが指定されていない場合は、 '-' ('\u002d') が先頭に付加されます。

<li>'+' フラグが指定され、値が正またはゼロ (または浮動小数点正のゼロ) の場合は、 '+' ('\u002b') が先頭に付加されます。

</ol>

値が NaN または正の無限大の場合、リテラル文字列 "NaN" または "Infinity" がそれぞれ出力されます。 値が負の無限大の場合、 '(' フラグが指定されている場合、出力は "(Infinity)" になります。それ以外の場合、出力は "-Infinity" になります。 これらの値はローカライズされません。

"dnint"><b> Byte、Short、Integer、Long </b>

次の変換は、 byte、 Byte、 short、 Short、 int と Integer、 long、および Longに適用できます。

<table class="striped"><caption style="display:none">IntConv</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'d'<td style="vertical-align:top">'\u0064'<td> 引数を 10 進整数として書式設定します。 ローカリゼーション アルゴリズムが適用されます。

'0' フラグが指定され、値が負の場合、符号の後にゼロパディングが発生します。

'#' フラグが指定されている場合は、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'o'<td style="vertical-align:top">'\u006f'<td> 引数を 8 進数の整数として書式設定します。 ローカライズは適用されません。

x が負の値の場合、結果は、2<up>n</sup> を追加して生成される符号なし値になります。nは、Byte#SIZE Byte、Short#SIZE Short、Integer#SIZE Integer、または Long#SIZE Long クラスの静的なSIZE フィールドによって返される型のビット数です。

'#' フラグが指定されている場合、出力は常に基数インジケーター '0'で始まります。

'0' フラグが指定されている場合、出力には、符号の指示に従ってフィールド幅に先行ゼロが埋め込まれます。

'('場合は、'+'、'  '、または','フラグが指定されると、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'x'<td style="vertical-align:top">'\u0078'<td> 引数を 16 進数の整数として書式設定します。 ローカライズは適用されません。

x が負の値の場合、結果は、2<up>n</sup> を追加して生成される符号なし値になります。nは、Byte#SIZE Byte、Short#SIZE Short、Integer#SIZE Integer、または Long#SIZE Long クラスの静的なSIZE フィールドによって返される型のビット数です。

'#' フラグが指定されている場合、出力は常に基数インジケーター "0x"で始まります。

'0' フラグが指定されている場合、出力は基数インジケーターまたは符号 (存在する場合) の後に先頭にゼロが付いたフィールド幅に埋め込まれます。

'('、'  '、'+'、または','フラグが指定されると、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'X'<td style="vertical-align:top">'\u0058'<td>'x'の大文字のバリアント。 数値を表す文字列全体は、 'x' (存在する場合) とすべての 16 進数 'a' - 'f' ('\u0061' - '\u0066') を含む String#toUpperCase 大文字に変換されます。

</tbody></table>

変換が'o'、'x'、または'X'で、'#'フラグと'0'フラグの両方が指定されている場合、結果には基数インジケーター (8 進数と'0'の場合は"0x"、16 進数の場合は"0X")、ゼロの数 (幅に基づく)、値が含まれます。

'-' フラグが指定されていない場合、スペースの埋め込みは符号の前に行われます。

次の "intFlags">フラグは、数値整数変換に適用されます。

<table class="striped"><caption style="display:none">intFlags</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'+'<td style="vertical-align:top">'\u002b'<td> すべての正の数値に正の符号を含める必要があります。 このフラグが指定されていない場合は、負の値にのみ符号が含まれます。

'+'フラグと'  ' フラグの両方が指定されている場合は、IllegalFormatFlagsExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'  '<td style="vertical-align:top">'\u0020'<td> 出力に負以外の値に対して 1 つの余分なスペース ('\u0020') を含める必要があります。

'+'フラグと'  ' フラグの両方が指定されている場合は、IllegalFormatFlagsExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'0'<td style="vertical-align:top">'\u0030'<td> NaN または infinity を変換する場合を除き、先頭の java.text.DecimalFormatSymbols#getZeroDigit ゼロを最小フィールド幅に埋め込む必要があります。 幅が指定されていない場合は、 MissingFormatWidthException がスローされます。

'-'フラグと'0' フラグの両方が指定されている場合は、IllegalFormatFlagsExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">','<td style="vertical-align:top">'\u002c'<td> ローカリゼーション アルゴリズムの "group" セクションで説明されているように、ロケール固有の java.text.DecimalFormatSymbols#getGroupingSeparator グループ区切り記号を含める出力が必要です。

<tr><th scope="row" style="vertical-align:top">'('<td style="vertical-align:top">'\u0028'<td>'(' ('\u0028') の前に出力を追加し、 ')' ('\u0029') を負の値に追加する必要があります。

</tbody></table>

"intdFlags">フラグが指定されていない場合、既定の書式設定は次のようになります。

<ul>

<li> 出力は width<li 内で右揃え> 負の数は '-' で始まります ('\u002d')

<li> 正の数値とゼロには、符号または余分な先頭スペースは含まれません

<li> グループ化区切り記号は含まれません

</ul>

"intWidth">width は、出力に書き込まれる最小文字数です。 これには、記号、数字、グループ区切り記号、基数インジケーター、かっこが含まれます。 変換後の値の長さが幅より小さい場合、出力は、文字数の合計が width になるまでスペース ('\u0020') で埋め込まれます。 パディングは既定で左側にあります。 '-'フラグが指定されている場合、パディングは右側にあります。 幅が指定されていない場合は、最小値はありません。

有効桁数は適用されません。 有効桁数を指定すると、 IllegalFormatPrecisionException がスローされます。

"dnbint"><b> BigInteger </b>

次の変換は、 java.math.BigIntegerに適用できます。

<table class="striped"><caption style="display:none">bIntConv</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'d'<td style="vertical-align:top">'\u0064'<td> 出力を 10 進整数として書式設定する必要があります。 ローカリゼーション アルゴリズムが適用されます。

'#' フラグが指定されている場合は、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'o'<td style="vertical-align:top">'\u006f'<td> 出力を 8 進数の整数として書式設定する必要があります。 ローカライズは適用されません。

x が負の場合、結果は '-' ('\u002d') で始まる符号付き値になります。 プリミティブ型とは異なり、明示的なデータ型サイズを想定しないと、符号なし同等の値を作成できないため、この型に対して署名付き出力が許可されます。

x が正またはゼロで、'+' フラグが指定されている場合、結果は '+' ('\u002b') で始まります。

'#' フラグが指定されている場合、出力は常にプレフィックス'0'で始まります。

'0' フラグが指定されている場合、出力には、符号の指示に従ってフィールド幅に先行ゼロが埋め込まれます。

',' フラグが指定されている場合は、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'x'<td style="vertical-align:top">'\u0078'<td> 16 進数の整数として出力を書式設定する必要があります。 ローカライズは適用されません。

x が負の場合、結果は '-' ('\u002d') で始まる符号付き値になります。 プリミティブ型とは異なり、明示的なデータ型サイズを想定しないと、符号なし同等の値を作成できないため、この型に対して署名付き出力が許可されます。

x が正またはゼロで、'+' フラグが指定されている場合、結果は '+' ('\u002b') で始まります。

'#' フラグが指定されている場合、出力は常に基数インジケーター "0x"で始まります。

'0' フラグが指定されている場合、出力は基数インジケーターまたは符号 (存在する場合) の後に先頭にゼロが付いたフィールド幅に埋め込まれます。

',' フラグが指定されている場合は、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'X'<td style="vertical-align:top">'\u0058'<td>'x'の大文字のバリアント。 数値を表す文字列全体は、 'x' (存在する場合) とすべての 16 進数 'a' - 'f' ('\u0061' - '\u0066') を含む String#toUpperCase 大文字に変換されます。

</tbody></table>

変換が'o'、'x'、または'X'で、'#'フラグと'0'フラグの両方が指定されている場合、結果には基本インジケーター (8 進数と'0'の場合は"0x"、16 進数の場合は"0X")、ゼロの数 (幅に基づく)、値が含まれます。

'0' フラグが指定され、値が負の場合、符号の後にゼロパディングが発生します。

'-' フラグが指定されていない場合、スペースの埋め込みは符号の前に行われます。

Byte、Short、Integer、Long に定義されているすべてのフラグが適用されます。 フラグが指定されていない場合の既定の動作は、Byte、Short、Integer、Long の場合と同じです。

幅の指定は、Byte、Short、Integer、Long に定義されているのと同じです。

有効桁数は適用されません。 有効桁数を指定すると、 IllegalFormatPrecisionException がスローされます。

"dndec"><b> Float および Double</b>

次の変換は、 float、 Float、 double 、および Doubleに適用できます。

<table class="striped"><caption style="display:none">floatConv</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'e'<td style="vertical-align:top">'\u0065'<td> "scientific">computerized scientific notation. ローカリゼーション アルゴリズムが適用されます。

大きさ m の書式設定は、その値によって異なります。

m が NaN または無限の場合、リテラル文字列 "NaN" または "Infinity" がそれぞれ出力されます。 これらの値はローカライズされません。

m が正のゼロまたは負のゼロの場合、指数は"+00"されます。

それ以外の場合、結果は引数の符号と大きさ (絶対値) を表す文字列になります。 符号の書式設定は、ローカリゼーション アルゴリズムで説明します。 大きさ m の書式設定は、その値によって異なります。

n を 10supn/sup <= m < のような一意の整数にします。 10supn+1/sup; 次に、数学的に正確な m と 10supn/sup を 1 <= a < にします。10. その後、大きさは a の整数部分として表され、その後に小数点区切り記号が続き、その後に a の小数部を表す 10 進数が続き、その後に小文字のロケール固有の java.text.DecimalFormatSymbols#getExponentSeparator 指数区切り記号 (例: 'e')、指数の符号が続き、 n が 10 進整数として表現されます。 メソッド Long#toString(long, int)によって生成され、少なくとも 2 桁を含むようにゼロ埋め込み。

m または a の小数部の結果の桁数は、有効桁数と等しくなります。 有効桁数が指定されていない場合、既定値は 6。 有効桁数が、それぞれ Float#toString(float) または Double#toString(double) によって返される文字列の小数点の後に表示される桁数より小さい場合、値は java.math.RoundingMode#HALF_UP 丸め半分のアルゴリズムを使用して丸められます。 それ以外の場合は、有効桁数に達するためにゼロを追加できます。 値の正規表現には、必要に応じて Float#toString(float) または Double#toString(double) を使用します。

',' フラグを指定すると、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'E'<td style="vertical-align:top">'\u0045'<td>'e'の大文字のバリアント。 指数記号は、大文字ロケール固有の java.text.DecimalFormatSymbols#getExponentSeparator 指数区切り記号 (例: 'E') になります。

<tr><th scope="row" style="vertical-align:top">'g'<td style="vertical-align:top">'\u0067'<td> 以下に説明するように、出力を一般的な科学的表記で書式設定する必要があります。 ローカリゼーション アルゴリズムが適用されます。

精度の丸め後、結果の大きさ m の書式設定は、その値によって異なります。

m が 10^-4 より大きく、10^precision より小さい場合は、10 進形式で表されます。

m が 10^-4 または 10^precision 以上の場合は、コンピューター化された科学的表記で表されます。

m の有効桁数の合計は、有効桁数と等しくなります。 有効桁数が指定されていない場合、既定値は 6。 精度が 0の場合は、 1されます。

'#' フラグが指定されている場合は、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'G'<td style="vertical-align:top">'\u0047'<td>'g'の大文字のバリアント。

<tr><th scope="row" style="vertical-align:top">'f'<td style="vertical-align:top">'\u0066'<td> "decimal">decimal 形式を使用して出力を書式設定する必要があります。 ローカリゼーション アルゴリズムが適用されます。

結果は、引数の符号と大きさ (絶対値) を表す文字列になります。 符号の書式設定は、ローカリゼーション アルゴリズムで説明します。 大きさ m の書式設定は、その値によって異なります。

m NaN または infinite の場合、リテラル文字列 "NaN" または "Infinity" がそれぞれ出力されます。 これらの値はローカライズされません。

この大きさは 、m の整数部分として書式設定され、先頭にゼロが付けず、その後に小数点区切り記号が続き、 m の小数部を表す 1 つ以上の 10 進数が続きます。

m または a の小数部の結果の桁数は、有効桁数と等しくなります。 有効桁数が指定されていない場合、既定値は 6。 有効桁数が、それぞれ Float#toString(float) または Double#toString(double) によって返される文字列の小数点の後に表示される桁数より小さい場合、値は java.math.RoundingMode#HALF_UP 丸め半分のアルゴリズムを使用して丸められます。 それ以外の場合は、有効桁数に達するためにゼロを追加できます。 値の正規表現には、必要に応じて Float#toString(float) または Double#toString(double) を使用します。

<tr><th scope="row" style="vertical-align:top">'a'<td style="vertical-align:top">'\u0061'<td> 出力を 16 進数の指数形式で書式設定する必要があります。 ローカライズは適用されません。

結果は、引数 x の符号と大きさ (絶対値) を表す文字列になります。

x が負または負のゼロの値の場合、結果は '-' ('\u002d') で始まります。

x が正または正のゼロの値で、'+' フラグが指定されている場合、結果は '+' ('\u002b') で始まります。

大きさ m の書式設定は、その値によって異なります。

<ul>

<li> 値が NaN または無限の場合、リテラル文字列 "NaN" または "Infinity" がそれぞれ出力されます。

<li>m が 0 の場合は、文字列 "0x0.0p0"で表されます。

<li>m が正規化された表現を持つ double 値である場合、部分文字列は仮数フィールドと指数フィールドを表すために使用されます。 仮数は、 "0x1." 文字の後に残りの部分を分数として 16 進数で表します。 指数は、指数値に対して'p'を呼び出すことによって生成されるかのように、'\u0070' (Integer#toString(int) Integer.toString) の後に偏りのない指数の 10 進文字列で表されます。 有効桁数が指定されている場合、値は指定された 16 進数の数に丸められます。

<li>m が非正規表現を持つ double 値の場合、有効桁数が 1 から 12 の範囲に指定されていない限り、意味は文字 '0x0.' で表され、その後に残りの部分の 16 進数表現が分数として、指数が 'p-1022'で表されます。 有効桁数が間隔 [1,  内にある場合12]、非正規値は、 '0x1.'文字で始まり、有効桁数の 16 進数に丸められ、それに応じて指数が調整されるように正規化されます。 非正規仮数には、0 以外の数字が少なくとも 1 つ必要であることに注意してください。

</ul>

'('または','フラグが指定されている場合は、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'A'<td style="vertical-align:top">'\u0041'<td>'a'の大文字のバリアント。 数値を表す文字列全体は、 'x' ('\u0078') と 'p' ('\u0070' およびすべての 16 進数 'a' - 'f' ('\u0061' - '\u0066') を含む大文字に変換されます。

</tbody></table>

Byte、Short、Integer、Long に定義されているすべてのフラグが適用されます。

'#' フラグが指定されている場合、小数点区切り記号は常に存在します。

"floatdFlags">フラグが指定されていない場合、既定の書式設定は次のようになります。

<ul>

<li> 出力は width<li 内で右揃えです> 負の数値は '-'<li で始まり> 正の数と正のゼロには符号や余分な先頭スペースは含まれません

<li> グループ化区切り記号は含まれません

<li> 小数点記号は、その後に数字が続く場合にのみ表示されます。

</ul>

"floatDWidth">width は、出力に書き込まれる最小文字数です。 これには、任意の符号、数字、グループ化区切り記号、小数点区切り記号、指数記号、基数インジケーター、かっこ、および必要に応じて無限大と NaN を表す文字列が含まれます。 変換後の値の長さが幅より小さい場合、出力は、文字数の合計が width になるまでスペース ('\u0020') で埋め込まれます。 パディングは既定で左側にあります。 '-'フラグが指定されている場合、パディングは右側にあります。 幅が指定されていない場合は、最小値はありません。

"floatDPrec">conversion が 'e'、 'E' 、または 'f'の場合、有効桁数は小数点区切り記号の後の桁数になります。 有効桁数が指定されていない場合は、 6と見なされます。

変換が 'g' または 'G'の場合、有効桁数は丸めた後の結果の大きさの有効桁数の合計です。 有効桁数が指定されていない場合、既定値は 6。 精度が 0の場合は、 1されます。

変換が 'a' または 'A'の場合、有効桁数は基数ポイントの後の 16 進数の桁数になります。 有効桁数が指定されていない場合は、 Double#toHexString(double) によって返されるすべての数字が出力されます。

"dnbdec"><b> BigDecimal </b>

次の変換は、 java.math.BigDecimal BigDecimal適用できます。

<table class="striped"><caption style="display:none">floatConv</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'e'<td style="vertical-align:top">'\u0065'<td> "bscientific">computerized scientific notation を使用して出力を書式設定する必要があります。 ローカリゼーション アルゴリズムが適用されます。

大きさ m の書式設定は、その値によって異なります。

m が正のゼロまたは負のゼロの場合、指数は"+00"されます。

それ以外の場合、結果は引数の符号と大きさ (絶対値) を表す文字列になります。 符号の書式設定は、ローカリゼーション アルゴリズムで説明します。 大きさ m の書式設定は、その値によって異なります。

n を 10supn/sup <= m < のような一意の整数にします。 10supn+1/sup; 次に、数学的に正確な m と 10supn/sup を 1 <= a < にします。10. その後、大きさは 、a の整数部分として表され、1 つの 10 進数として表され、その後に小数点区切り記号の後に a の小数部を表す 10 進数字が続き、指数記号 'e' ('\u0065')、指数の符号、10 進整数としての n の表現が続きます Long#toString(long, int) 少なくとも 2 桁の数字を含むように、0 を埋め込みます。

m または a の小数部の結果の桁数は、有効桁数と等しくなります。 有効桁数が指定されていない場合、既定値は 6。 有効桁数が小数点の右側の桁数より小さい場合、値は java.math.RoundingMode#HALF_UP 丸め半分のアルゴリズムを使用して丸められます。 それ以外の場合は、有効桁数に達するためにゼロを追加できます。 値の正規表現には、 BigDecimal#toString()を使用します。

',' フラグを指定すると、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'E'<td style="vertical-align:top">'\u0045'<td>'e'の大文字のバリアント。 指数記号は 'E' ('\u0045') になります。

<tr><th scope="row" style="vertical-align:top">'g'<td style="vertical-align:top">'\u0067'<td> 以下に説明するように、出力を一般的な科学的表記で書式設定する必要があります。 ローカリゼーション アルゴリズムが適用されます。

精度の丸め後、結果の大きさ m の書式設定は、その値によって異なります。

m が 10^-4 より大きく、10^precision より小さい場合は、10 進形式で表されます。

m が 10^-4 または 10^precision 以上の場合は、コンピューター化された科学的表記で表されます。

m の有効桁数の合計は、有効桁数と等しくなります。 有効桁数が指定されていない場合、既定値は 6。 精度が 0の場合は、 1されます。

'#' フラグが指定されている場合は、FormatFlagsConversionMismatchExceptionがスローされます。

<tr><th scope="row" style="vertical-align:top">'G'<td style="vertical-align:top">'\u0047'<td>'g'の大文字のバリアント。

<tr><th scope="row" style="vertical-align:top">'f'<td style="vertical-align:top">'\u0066'<td> "bdecimal">decimal 形式を使用して出力を書式設定する必要があります。 ローカリゼーション アルゴリズムが適用されます。

結果は、引数の符号と大きさ (絶対値) を表す文字列になります。 符号の書式設定は、ローカリゼーション アルゴリズムで説明します。 大きさ m の書式設定は、その値によって異なります。

この大きさは 、m の整数部分として書式設定され、先頭にゼロが付けず、その後に小数点区切り記号が続き、 m の小数部を表す 1 つ以上の 10 進数が続きます。

m または a の小数部の結果の桁数は、有効桁数と等しくなります。 有効桁数が指定されていない場合、既定値は 6。 有効桁数が小数点の右側の桁数より小さい場合、値は java.math.RoundingMode#HALF_UP 丸め半分のアルゴリズムを使用して丸められます。 それ以外の場合は、有効桁数に達するためにゼロを追加できます。 値の正規表現には、 BigDecimal#toString()を使用します。

</tbody></table>

Byte、Short、Integer、Long に定義されているすべてのフラグが適用されます。

'#' フラグが指定されている場合、小数点区切り記号は常に存在します。

フラグが指定されていない場合の既定の動作は、Float と Double の場合と同じです。

幅と精度の指定は、Float と Double に定義されているのと同じです。

<h3>"ddt">Date/Time</h3>

この変換は、 long、 Long、 Calendar、 Date 、 TemporalAccessor TemporalAccessor<table class="striped"><caption style="display:none">DTConv</caption><tbody に適用できます。>

<tr><th scope="row" style="vertical-align:top">'t'<td style="vertical-align:top">'\u0074'<td> 日時変換文字のプレフィックス。 <tr><th scope="row" style="vertical-align:top">'T'<td style="vertical-align:top">'\u0054'<td>'t'の大文字のバリアント。

</tbody></table>

次の日付と時刻の変換文字サフィックスは、 't' 変換と 'T' 変換に対して定義されています。 型は GNU date および POSIX strftime(3c)で定義されているものと似ていますが、完全には同じではありません。 Java固有の機能にアクセスするための追加の変換の種類が用意されています (たとえば、2 秒以内のミリ秒の'L')。

書式設定には、次の変換文字が使用されます。

<table class="striped"><caption style="display:none">time</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'H'<td style="vertical-align:top">'\u0048'<td> 必要に応じて先頭にゼロが付いた 2 桁の数字 (つまり、 00 - 23) として書式設定された 24 時間の時刻の時間。 00 は午前 0 時に対応します。

<tr><th scope="row" style="vertical-align:top">'I'<td style="vertical-align:top">'\u0049'<td> hour for the 12-hour clock, formatted as a leading zero as necessary, e. 01 - 12. 01 は 1 時 (午前または午後) に対応します。

<tr><th scope="row" style="vertical-align:top">'k'<td style="vertical-align:top">'\u006b'<td> hour of the day for the 24-hour clock, つまり、 0 - 23. 0 は午前 0 時に対応します。

<tr><th scope="row" style="vertical-align:top">'l'<td style="vertical-align:top">'\u006c'<td> hour for the 12-hour clock, つまり、 1 - 12. 1 は 1 時 (午前または午後) に対応します。

<tr><th scope="row" style="vertical-align:top">'M'<td style="vertical-align:top">'\u004d'<td> 必要に応じて先頭にゼロが付いた 2 桁の 1 時間以内の分 (つまり、 00 - 59)。

<tr><th scope="row" style="vertical-align:top">'S'<td style="vertical-align:top">'\u0053'<td> 秒(秒)、必要に応じて先頭にゼロが付いた 2 桁の数字 (つまり、 00 - 60 ("60" は、うるう秒をサポートするために必要な特別な値) として書式設定されます。

<tr><th scope="row" style="vertical-align:top">'L'<td style="vertical-align:top">'\u004c'<td> 必要に応じて先頭にゼロが付いた 3 桁の 2 桁目内のミリ秒 (つまり、 000 - 999)。

<tr><th scope="row" style="vertical-align:top">'N'<td style="vertical-align:top">'\u004e'<td> 必要に応じて先頭にゼロが付いた 9 桁のナノ秒 (つまり、 000000000 - 999999999) で書式設定されます。この値の精度は、基になるオペレーティング システムまたはハードウェアの解像度によって制限されます。

<tr><th scope="row" style="vertical-align:top">'p'<td style="vertical-align:top">'\u0070'<td> ロケール固有の java.text.DateFormatSymbols#getAmPmStrings の午前または午後のマーカー (小文字など)"am" または "pm" です。 変換プレフィックス 'T' 使用すると、この出力が大文字になります。 ( 'p' では小文字の出力が生成されることに注意してください。これは、大文字の出力を生成する GNU date や POSIX strftime(3c) とは異なります。

<tr><th scope="row" style="vertical-align:top">'z'<td style="vertical-align:top">'\u007a'<td>RFC 822 スタイルの GMT からの数値タイム ゾーン オフセット (例: -0800)。 この値は、夏時間に必要に応じて調整されます。 long、Long、およびDateの場合、使用されるタイム ゾーンは、Java仮想マシンのこのインスタンスの TimeZone#getDefault() 既定のタイム ゾーンです。

<tr><th scope="row" style="vertical-align:top">'Z'<td style="vertical-align:top">'\u005a'<td> タイム ゾーンの省略形を表す文字列。 この値は、夏時間に必要に応じて調整されます。 long、Long、およびDateの場合、使用されるタイム ゾーンは、Java仮想マシンのこのインスタンスの TimeZone#getDefault() 既定のタイム ゾーンです。 フォーマッタのロケールは、引数のロケール (存在する場合) よりも優先されます。

<tr><th scope="row" style="vertical-align:top">'s'<td style="vertical-align:top">'\u0073'<td> UTC 00:00:00 1970 年 1 月 1 日以降のエポックの開始からの秒数(つまり、Long.MIN_VALUE/1000にLong.MAX_VALUE/1000)。

<tr><th scope="row" style="vertical-align:top">'Q'<td style="vertical-align:top">'\u004f'<td> UTC の 197 00:00:000 年 1 月 1 日以降のエポックの開始からミリ秒 (つまり、Long.MIN_VALUEにLong.MAX_VALUE)。 この値の精度は、基になるオペレーティング システムまたはハードウェアの解像度によって制限されます。

</tbody></table>

日付の書式設定には、次の変換文字が使用されます。

<table class="striped"><caption style="display:none">date</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'B'<td style="vertical-align:top">'\u0042'<td> ロケール固有の java.text.DateFormatSymbols#getMonths full month name (例: "January", "February")。

<tr><th scope="row" style="vertical-align:top">'b'<td style="vertical-align:top">'\u0062'<td> ロケール固有の java.text.DateFormatSymbols#getShortMonths 省略形の月名 ( "Jan"、 "Feb"など)。

<tr><th scope="row" style="vertical-align:top">'h'<td style="vertical-align:top">'\u0068'<td>'b'と同じです。

<tr><th scope="row" style="vertical-align:top">'A'<td style="vertical-align:top">'\u0041'<td> java.text.DateFormatSymbols#getWeekdays day of the week, たとえば、"Sunday"、"Monday"<tr><th scope="row" style="vertical-align:top">'a'<td style="vertical-align:top">'\u0061'<td> java.text.DateFormatSymbols#getShortWeekdays 曜日のロケール固有の短い名前 (例: "Sun"、"Mon"<tr><th scope="row" style="vertical-align:top">'C'<td style="vertical-align:top">'\u0043'<td> 4 桁の年を100で除算し、 必要に応じて先頭に 0 が付いた 2 桁の数字として書式設定されます。つまり、00 - 99<tr><th scope="row" style="vertical-align:top">'Y'<td style="vertical-align:top">'\u0059'<td> Year。必要に応じて先頭にゼロが付いた 4 桁以上に書式設定されます。たとえば、グレゴリオ暦の ce 0092等しい92。

<tr><th scope="row" style="vertical-align:top">'y'<td style="vertical-align:top">'\u0079'<td> 年の最後の 2 桁は、必要に応じて先頭にゼロ (つまり、 00 - 99) で書式設定されます。

<tr><th scope="row" style="vertical-align:top">'j'<td style="vertical-align:top">'\u006a'<td> Day of year, formatted as three digits with leading zeros as necessary, 例: 001 - 366 for the Gregorian calendar. 001 は、年の最初の日に対応します。

<tr><th scope="row" style="vertical-align:top">'m'<td style="vertical-align:top">'\u006d'<td> Month, formatted as two digits with leading zeros as required, つまり、 01 - 13, where "01" is the first month of the year and ("13" is a special value required to support lunar calendars).

<tr><th scope="row" style="vertical-align:top">'d'<td style="vertical-align:top">'\u0064'<td> Day of month, formatted as two digits with leading zeros as necessary, e. 01 - 31, where "01" is the first day of the month.

<tr><th scope="row" style="vertical-align:top">'e'<td style="vertical-align:top">'\u0065'<td> Day of month, formatted as two digits, すなわち 1 - 31 where "1" is the first day of the month.

</tbody></table>

次の変換文字は、一般的な日付/時刻構成の書式設定に使用されます。

<table class="striped"><caption style="display:none">composites</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'R'<td style="vertical-align:top">'\u0052'<td> 24 時間制の時刻が "%tH:%tM"<tr として書式設定されました>< 1 番目の scope="row" style="vertical-align:top">'T'<td style="vertical-align:top">'\u0054'<td> 24 時間制の時刻を "%tH:%tM:%tS"として書式設定します。

<tr><th scope="row" style="vertical-align:top">'r'<td style="vertical-align:top">'\u0072'<td> 12 時間時計用に "%tI:%tM:%tS %Tp"形式の時刻。 午前または午後のマーカー ('%Tp') の場所はロケールによって異なる場合があります。

<tr><th scope="row" style="vertical-align:top">'D'<td style="vertical-align:top">'\u0044'<td>"%tm/%td/%ty" 形式の日付。

<tr><th scope="row" style="vertical-align:top">'F'<td style="vertical-align:top">'\u0046'<td>ISO 8601 complete date formatted as "%tY-%tm-%td".

<tr><th scope="row" style="vertical-align:top">'c'<td style="vertical-align:top">'\u0063'<td>"%ta %tb %td %tT %tZ %tY" として書式設定された日付と時刻 (例: "Sun Jul 20 16:17:00 EDT 1969")。

</tbody></table>

全般変換に定義されている '-' フラグが適用されます。 '#' フラグを指定すると、FormatFlagsConversionMismatchExceptionがスローされます。

幅は、出力に書き込まれる最小文字数です。 変換後の値の長さが width より小さい場合、出力は、文字数の合計が width になるまでスペース ('\u0020') で埋め込まれます。 パディングは既定で左側にあります。 '-'フラグが指定されている場合、パディングは右側にあります。 幅が指定されていない場合は、最小値はありません。

有効桁数は適用されません。 有効桁数を指定すると、 IllegalFormatPrecisionException がスローされます。

<h3>"dper">Percent</h3>

変換はどの引数にも対応していません。

<table class="striped"><caption style="display:none">DTConv</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'%'<td> 結果はリテラル '%' ('\u0025') です。

幅は、 '%'を含む出力に書き込まれる最小文字数です。 変換後の値の長さが width より小さい場合、出力は、文字数の合計が width になるまでスペース ('\u0020') で埋め込まれます。 パディングは左側にあります。 width が指定されていない場合は、 '%' のみが出力されます。

全般変換に定義されている '-' フラグが適用されます。 他のフラグが指定されている場合は、 IllegalFormatFlagsException がスローされます。

有効桁数は適用されません。 有効桁数を指定すると、 IllegalFormatPrecisionException がスローされます。

</tbody></table>

<h3>"dls">Line Separator</h3>

変換はどの引数にも対応していません。

<table class="striped"><caption style="display:none">DTConv</caption><tbody>

<tr><th scope="row" style="vertical-align:top">'n'<td>System#lineSeparator()によって返されるプラットフォーム固有の行区切り記号。

</tbody></table>

フラグ、幅、および有効桁数は適用されません。 IllegalFormatFlagsException、IllegalFormatWidthException、IllegalFormatPrecisionExceptionが指定されている場合は、それぞれスローされます。

<h3>"dpos">Argument Index</h3>

書式指定子は、次の 3 つの方法で引数を参照できます。

<ul>

<li>Explicit インデックス作成 は、書式指定子に引数インデックスが含まれている場合に使用されます。 引数インデックスは、引数リスト内の引数の位置を示す 10 進整数です。 最初の引数は "1$" で参照され、2 番目の引数は "2$" などによって参照されます。引数は複数回参照できます。

例えば次が挙げられます。

<blockquote>

formatter.format("%4$s %3$s %2$s %1$s %4$s %3$s %2$s %1$s",
                               "a", "b", "c", "d")
              // -> "d c b a d c b a"

</blockquote>

<li>Relative インデックス作成 は、書式指定子に '<' ('\u003c') フラグが含まれている場合に使用されます。これにより、前の書式指定子の引数が再利用されます。 前の引数がない場合は、 MissingFormatArgumentException がスローされます。

<blockquote>

formatter.format("%s %s %<s %<s", "a", "b", "c", "d")
               // -> "a b b b"
               // "c" and "d" are ignored because they are not referenced

</blockquote>

<li>Ordinary インデックス 作成は、書式指定子に引数インデックスも '<' フラグも含まれている場合に使用されます。 通常のインデックス作成を使用する各書式指定子には、明示的または相対インデックス作成で使用されるインデックスに依存しない、連続する暗黙的なインデックスが引数リストに割り当てられます。

<blockquote>

formatter.format("%s %s %s %s", "a", "b", "c", "d")
              // -> "a b c d"

</blockquote>

</ul>

次に例を示す、すべての形式のインデックス作成を使用する書式指定文字列を含めることもできます。

<blockquote>

formatter.format("%2$s %s %<s %s", "a", "b", "c", "d")
              // -> "b a a b"
              // "c" and "d" are ignored because they are not referenced

</blockquote>

引数の最大数は、<cite>Java仮想マシン仕様</引用>で定義されているJava配列の最大次元によって制限されます。 引数インデックスが使用可能な引数に対応していない場合は、 MissingFormatArgumentException がスローされます。

書式指定子よりも多くの引数がある場合、余分な引数は無視されます。

特に指定しない限り、このクラスのメソッドまたはコンストラクターに null 引数を渡すと、 NullPointerException がスローされます。

1\.5 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

名前	説明
Formatter()	新しいフォーマッタを構築します。
Formatter(File, Charset, Locale)	指定したファイル、文字セット、およびロケールを使用して新しいフォーマッタを構築します。
Formatter(File, String, Locale)	指定したファイル、文字セット、およびロケールを使用して新しいフォーマッタを構築します。
Formatter(File, String)	指定したファイルと文字セットを使用して、新しいフォーマッタを構築します。
Formatter(File)	指定したファイルを使用して新しいフォーマッタを構築します。
Formatter(IAppendable, Locale)	指定した変換先とロケールを使用して、新しいフォーマッタを構築します。
Formatter(IAppendable)	指定した変換先を持つ新しいフォーマッタを構築します。
Formatter(Locale)	指定したロケールを持つ新しいフォーマッタを構築します。
Formatter(PrintStream)	指定した印刷ストリームを使用して新しいフォーマッタを構築します。
Formatter(Stream, Charset, Locale)	指定した出力ストリーム、文字セット、およびロケールを使用して、新しいフォーマッタを構築します。
Formatter(Stream, String, Locale)	指定した出力ストリーム、文字セット、およびロケールを使用して、新しいフォーマッタを構築します。
Formatter(Stream, String)	指定した出力ストリームと文字セットを使用して、新しいフォーマッタを構築します。
Formatter(Stream)	指定した出力ストリームを使用して新しいフォーマッタを構築します。
Formatter(String, Charset, Locale)	指定したファイル名、文字セット、およびロケールを持つ新しいフォーマッタを構築します。
Formatter(String, String, Locale)	指定したファイル名、文字セット、およびロケールを持つ新しいフォーマッタを構築します。
Formatter(String, String)	指定したファイル名と文字セットを持つ新しいフォーマッタを構築します。
Formatter(String)	指定したファイル名を持つ新しいフォーマッタを構築します。

プロパティ

名前	説明
Class	この Objectのランタイム クラスを返します。 (継承元 Object)
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
JniIdentityHashCode	相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。 (継承元 Object)
JniManagedPeerState	printf スタイルの書式指定文字列のインタープリター。 (継承元 JavaObject)
JniPeerMembers	printf スタイルの書式指定文字列のインタープリター。
PeerReference	このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object)
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object)
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object)

メソッド

名前	説明
Clone()	このオブジェクトのコピーを作成して返します。 (継承元 Object)
Close()	このフォーマッタを閉じます。
Construct(JniObjectReference, JniObjectReferenceOptions)	printf スタイルの書式指定文字列のインタープリター。 (継承元 JavaObject)
Dispose()	このJava ピアによって保持されているリソースを解放します。 (継承元 Object)
Dispose(Boolean)	このJava ピアによって保持されているリソースを解放します。 (継承元 Object)
DisposeUnlessReferenced()	printf スタイルの書式指定文字列のインタープリター。 (継承元 JavaObject)
Equals(Object)	printf スタイルの書式指定文字列のインタープリター。 (継承元 JavaObject)
Equals(Object)	他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object)
Flush()	このフォーマッタをフラッシュします。
Format(Locale, String, Object[])	指定した書式指定文字列と引数を使用して、書式設定された文字列をこのオブジェクトの変換先に書き込みます。
Format(String, Object[])	指定した書式指定文字列と引数を使用して、書式設定された文字列をこのオブジェクトの変換先に書き込みます。
GetHashCode()	オブジェクトのハッシュ コード値を返します。 (継承元 Object)
IoException()	このフォーマッタのIOExceptionによって最後にスローされたAppendableを返します。
JavaFinalize()	古い. オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object)
Locale()	このフォーマッタの構築によって設定されたロケールを返します。
Notify()	このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object)
NotifyAll()	このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object)
Out()	出力先を返します。
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	printf スタイルの書式指定文字列のインタープリター。 (継承元 JavaObject)
ToArray<T>()	このJava配列ラッパーからマネージド配列を作成します。 (継承元 Object)
ToString()	オブジェクトの文字列形式を返します。 (継承元 Object)
UnregisterFromRuntime()	相互運用ランタイムからこのJava ピアの登録を解除します。 (継承元 Object)
Wait()	現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)
Wait(Int64)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)

明示的なインターフェイスの実装

名前	説明
IJavaPeerable.Disposed()	printf スタイルの書式指定文字列のインタープリター。 (継承元 JavaObject)
IJavaPeerable.Finalized()	printf スタイルの書式指定文字列のインタープリター。 (継承元 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	printf スタイルの書式指定文字列のインタープリター。 (継承元 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	printf スタイルの書式指定文字列のインタープリター。 (継承元 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	printf スタイルの書式指定文字列のインタープリター。 (継承元 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	printf スタイルの書式指定文字列のインタープリター。 (継承元 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	printf スタイルの書式指定文字列のインタープリター。

拡張メソッド

名前	説明
FlushAsync(IFlushable)	printf スタイルの書式指定文字列のインタープリター。
GetJniTypeName(IJavaPeerable)	インスタンス selfの型の JNI 名を取得します。
JavaAs<TResult>(IJavaPeerable)	selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。
JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	printf スタイルの書式指定文字列のインタープリター。
TryJavaCast<TResult>(IJavaPeerable, TResult)	selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。