NumberFormat クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
NumberFormat は、すべての数値形式の抽象基本クラスです。
[Android.Runtime.Register("java/text/NumberFormat", DoNotGenerateAcw=true)]
public abstract class NumberFormat : Java.Text._Format
[<Android.Runtime.Register("java/text/NumberFormat", DoNotGenerateAcw=true)>]
type NumberFormat = class
inherit _Format
- 継承
- 派生
- 属性
注釈
NumberFormat は、すべての数値形式の抽象基本クラスです。 このクラスは、数値を書式設定および解析するためのインターフェイスを提供します。
NumberFormat には、数値形式を持つロケールとその名前を決定するためのメソッドも用意されています。
NumberFormat は、任意のロケールの数値の書式設定と解析に役立ちます。 コードは、小数点、桁区切り記号、または使用される特定の 10 進数のロケール規則、または数値形式が 10 進数であるかどうかに完全に依存しません。
現在のロケールの数値を書式設定するには、ファクトリ クラスメソッドの 1 つを使用します: <blockquote>
{@code
myString = NumberFormat.getInstance().format(myNumber);
}
</blockquote> 複数の数値を書式設定する場合は、書式を取得して複数回使用する方が効率的であるため、システムはローカル言語と国の規則に関する情報を複数回フェッチする必要はありません。 <blockquote>
{@code
NumberFormat nf = NumberFormat.getInstance();
for (int i = 0; i < myNumber.length; ++i) {
output.println(nf.format(myNumber[i]) + "; ");
}
}
</blockquote> 別のロケールの数値を書式設定するには、 getInstanceの呼び出しで指定します。
<blockquote>
{@code
NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);
}
</blockquote>
ロケールに "nu" (数値) Unicode 拡張が含まれている場合、書式設定に使用される 10 進数または国がオーバーライドされます。
NumberFormatを使用して数値を解析することもできます:<blockquote>
{@code
myNumber = nf.parse(myString);
}
</blockquote> 通常の数値形式を取得するには、 getInstance または getNumberInstance を使用します。 整数の数値形式を取得するには、 getIntegerInstance を使用します。
getCurrencyInstanceを使用して通貨番号の形式を取得します。
getCompactNumberInstanceを使用して、数値を短い形式で書式設定するコンパクトな数値形式を取得します。 たとえば、2000は"2K"でjava.util.Locale#US US localeとして書式設定できます。
getPercentInstanceを使用して、パーセンテージを表示する形式を取得します。 この形式では、0.53 のような分数は 53%として表示されます。
setMinimumFractionDigitsなどのメソッドを使用して数値の表示を制御することもできます。 フォーマットや解析をさらに制御したい場合や、ユーザーに制御を与えたい場合は、ファクトリ メソッドから取得した NumberFormat を、使用するファクトリ メソッドに応じて DecimalFormat または CompactNumberFormat にキャストしてみてください。 これはロケールの大部分で機能します。あなたが珍しいものに遭遇した場合に備えて、 try ブロックに入れることを忘れないでください。
NumberFormat と DecimalFormat は、一部のコントロールが書式設定で機能し、他のコントロールが解析に使用できるように設計されています。 これらの各制御メソッドの詳細な説明を次に示します。
setParseIntegerOnly : 解析にのみ影響します(true の場合は "3456.78" →false の場合は 3456 (およびインデックス 6 の直後に解析位置を残します)、"3456.78" >3456.78 (インデックス 8 の直後に解析位置を残します) これは書式設定とは無関係です。 小数点の後に数字がない可能性がある小数点を表示しない場合は、setDecimalSeparatorAlwaysShown を使用します。
setDecimalSeparatorAlwaysShown : 書式設定にのみ影響し、"#,##0.##" のようなパターン (true の場合は 3456.00 &rarr など) など、小数点の後に数字がない場合にのみ影響します。"3,456." false の場合は 3456.00 >"3456" これは解析とは無関係です。 小数点で解析を停止する場合は、setParseIntegerOnly を使用します。
parseとformatでParsePositionメソッドとFieldPositionメソッドの形式を使用して、文字列<liの一部を段階的に解析><ul><li>小数点やその他の領域を</ulに合わせることもできます> 次に例を示します。 <ol><li>配置の間隔を持つモノスペースフォントを使用している場合は、書式呼び出しでFieldPositionを渡すことができます。 とfield = INTEGER_FIELD。 出力時に、 getEndIndex は整数の最後の文字と 10 進数の間のオフセットに設定されます。 文字列の先頭に (desiredSpaceCount - getEndIndex) スペースを追加します。
<li> プロポーショナル フォントを使用している場合は、スペースで埋め込む代わりに、文字列の幅を最初から getEndIndexピクセル単位で測定します。 次に、テキストを描画する前に、ペンを (desiredPixelWidth - widthToAlignmentPoint) で移動します。 また、10 進数が存在しないが、末尾に追加の文字がある場合にも機能します。たとえば、負の数のかっこを使用します。-12 の場合は "(12)" です。
</ol>
<h2>"synchronization">Synchronization</h2>
通常、数値形式は同期されません。 スレッドごとに個別のフォーマット インスタンスを作成することをお勧めします。 複数のスレッドが同時に形式にアクセスする場合は、外部で同期する必要があります。
1.1 で追加されました。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
コンストラクター
| 名前 | 説明 |
|---|---|
| NumberFormat() |
唯一のコンストラクター。 |
| NumberFormat(IntPtr, JniHandleOwnership) |
JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。 |
フィールド
| 名前 | 説明 |
|---|---|
| FractionField |
FieldPosition オブジェクトの構築に使用される Field 定数。 |
| IntegerField |
FieldPosition オブジェクトの構築に使用される Field 定数。 |
プロパティ
| 名前 | 説明 |
|---|---|
| Class |
この |
| Currency |
通貨値を書式設定するときに、この数値形式で使用される通貨を取得します。 または、通貨値を書式設定するときに、この数値書式で使用される通貨を設定します。 |
| CurrencyInstance |
現在の既定の |
| GroupingUsed |
グループ化がこの形式で使用されている場合は true を返します。 または、グループ化をこの形式で使用するかどうかを設定します。 |
| Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
| Instance |
現在の既定の |
| IntegerInstance |
現在の既定の |
| JniIdentityHashCode |
相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。 (継承元 Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| MaximumFractionDigits |
数値の分数部分で許容される最大桁数を返します。 または、数値の分数部分で許容される最大桁数を設定します。 |
| MaximumIntegerDigits |
数値の整数部分で許容される最大桁数を返します。 または、数値の整数部分で許容される最大桁数を設定します。 |
| MinimumFractionDigits |
数値の分数部分で許容される最小桁数を返します。 または、数値の分数部分で許容される最小桁数を設定します。 |
| MinimumIntegerDigits |
数値の整数部分で許容される最小桁数を返します。 または、数値の整数部分で許容される最小桁数を設定します。 |
| NumberInstance |
現在の既定の |
| ParseIntegerOnly |
この形式で数値を整数としてのみ解析する場合は true を返します。 または、数値を整数としてのみ解析するかどうかを設定します。 |
| PeerReference |
このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object) |
| PercentInstance |
現在の既定の |
| RoundingMode |
この NumberFormat で使用される |
| ThresholdClass |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
| ThresholdType |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
メソッド
| 名前 | 説明 |
|---|---|
| Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 _Format) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| Dispose() |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| Dispose(Boolean) |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| DisposeUnlessReferenced() |
|
| Equals(Object) |
|
| Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
| Format(Double, StringBuffer, FieldPosition) |
形式の特殊化。 |
| Format(Double) |
形式の特殊化。 |
| Format(Int64, StringBuffer, FieldPosition) |
形式の特殊化。 |
| Format(Int64) |
形式の特殊化。 |
| Format(Object, StringBuffer, FieldPosition) |
数値を書式設定し、結果のテキストを指定された文字列バッファーに追加します。 |
| Format(Object) |
文字列を生成するオブジェクトを書式設定します。 (継承元 _Format) |
| FormatToCharacterIterator(Object) |
|
| GetAvailableLocales() |
現在の既定のロケールの指数形式を返します。 |
| GetCurrencyInstance(Locale) |
指定したロケールの通貨形式を返します。 |
| GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
| GetInstance(Locale) |
指定したロケールの汎用の数値形式を返します。 |
| GetIntegerInstance(Locale) |
指定したロケールの整数形式を返します。 |
| GetNumberInstance(Locale) |
指定したロケールの汎用の数値形式を返します。 |
| GetPercentInstance(Locale) |
指定したロケールのパーセンテージ形式を返します。 |
| JavaFinalize() |
オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
| Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
| NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
| Parse(String, ParsePosition) |
可能な場合は Long を返します (e. |
| Parse(String) |
指定した文字列の先頭からテキストを解析して、数値を生成します。 |
| ParseObject(String, ParsePosition) |
文字列からテキストを解析して、 |
| ParseObject(String) |
指定された文字列の先頭からテキストを解析して、オブジェクトを生成します。 (継承元 _Format) |
| SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| 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() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniObjectReferenceControlBlock |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
| IJavaPeerable.UnregisterFromRuntime() |
|
拡張メソッド
| 名前 | 説明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
インスタンス |
| JavaAs<TResult>(IJavaPeerable) |
|
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
|