NumberFormat クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
<strong>[icu enhancement]</strong> ICU の java.text.NumberFormat の置き換え。
[Android.Runtime.Register("android/icu/text/NumberFormat", ApiSince=24, DoNotGenerateAcw=true)]
public abstract class NumberFormat : Android.Icu.Text.UFormat[<Android.Runtime.Register("android/icu/text/NumberFormat", ApiSince=24, DoNotGenerateAcw=true)>]
type NumberFormat = class
inherit UFormat- 継承
- 派生
- 属性
注釈
<strong>[icu enhancement]</strong> ICU の java.text.NumberFormat の置き換え。 ICU に固有のメソッド、フィールド、およびその他の機能には、"<strong>[icu]</strong>' というラベルが付けられます。
<strong>IMPORTANT:</strong> 新しいユーザーは、 NumberFormatter がユース ケースに適合するかどうかを確認することを強くお勧めします。 非推奨ではありませんが、このクラス NumberFormat は java.text.NumberFormat の互換性のためにのみ提供されます。
<hr>
NumberFormat は、すべての数値形式の抽象基本クラスです。 このクラスは、数値を書式設定および解析するためのインターフェイスを提供します。
NumberFormat には、数値形式を持つロケールとその名前を決定するためのメソッドも用意されています。
NumberFormat は、任意のロケールの数値の書式設定と解析に役立ちます。 コードは、小数点、桁区切り記号、または使用される特定の 10 進数のロケール規則、または数値形式が 10 進数であるかどうかに完全に依存しません。
現在のロケールの数値を書式設定するには、ファクトリ クラスメソッドの 1 つを使用します: <blockquote>
myString = NumberFormat.getInstance().format(myNumber);
</blockquote> 複数の数値を書式設定する場合は、書式を取得して複数回使用する方が効率的であるため、システムはローカル言語と国の規則に関する情報を複数回フェッチする必要はありません。 <blockquote>
NumberFormat nf = NumberFormat.getInstance();
for (int i = 0; i < a.length; ++i) {
output.println(nf.format(myNumber[i]) + "; ");
}
</blockquote> 別のロケールの数値を書式設定するには、 getInstanceの呼び出しで指定します。
<blockquote>
NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);
</blockquote>NumberFormat を使用して数値を解析することもできます: <blockquote>
myNumber = nf.parse(myString);
</blockquote> 通常の数値形式を取得するには、 getInstance または getNumberInstance を使用します。 整数の数値形式を取得するには、 getIntegerInstance を使用します。
getCurrencyInstanceを使用して通貨番号の形式を取得します。 また、 getPercentInstance を使用して、パーセンテージを表示する形式を取得します。 一部のファクトリ メソッドは、NumberFormat のサブクラス内にあります。 この形式では、0.53 のような分数は 53%として表示されます。
ICU 4.2 以降では、パラメーターとして 'style' を渡すことで getInstance() を使用して正しいインスタンスを取得できます。 たとえば、getInstance(...NUMBERSTYLE) を使用して通常の数値形式を取得します。getInstance(...PERCENTSTYLE) を使用してパーセンテージを表示する形式を取得します。getInstance(...SCIENTIFICSTYLE) を使用して、科学番号を表示するための形式を取得します。getInstance(...INTEGERSTYLE) を使用して整数の数値形式を取得します。getInstance(...CURRENCYSTYLE) を使用して通貨番号の形式を取得します。通貨が記号 ("$3.00" など) で表されます。 getInstance(...ISOCURRENCYSTYLE) を使用して通貨番号の形式を取得します。通貨は ISO コード ("USD3.00" など) で表されます。 getInstance(...PLURALCURRENCYSTYLE) を使用して通貨番号形式を取得します。通貨は、複数形の完全な名前で表されます 。たとえば、"3.00 US ドル" や "1.00 US ドル" です。
setMinimumFractionDigitsなどのメソッドを使用して数値の表示を制御することもできます。 書式や解析をさらに制御する場合や、ユーザーにより多くの制御をユーザーに与える場合は、ファクトリ メソッドから取得した NumberFormat を DecimalFormatにキャストしてみてください。 これはロケールの大部分で機能します。あなたが珍しいものに遭遇した場合に備えて、 try ブロックに入れることを忘れないでください。
NumberFormat は、一部のコントロールが書式設定で機能し、他のコントロールが解析に使用できるように設計されています。 これらの各制御メソッドの詳細な説明を次に示します。
setParseIntegerOnly : 解析にのみ影響します 。true の場合は "3456.78" ->3456 (および false の場合は '6' の直後に解析位置を残します)、"3456.78" ->3456.78 (および '8' の直後の解析位置から離れる) これは書式設定に依存しません。 小数点の後に数字がない可能性がある小数点を表示しない場合は、DecimalFormat で setDecimalSeparatorAlwaysShown を使用します。
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>
<h3>Synchronization</h3>
通常、数値形式は同期されません。 スレッドごとに個別のフォーマット インスタンスを作成することをお勧めします。 複数のスレッドが同時に形式にアクセスする場合は、外部で同期する必要があります。
<h4>DecimalFormat</h4>
DecimalFormat は NumberFormat の具象実装であり、NumberFormat API は基本的に DecimalFormat の API からの抽象化です。 この API の詳細については、DecimalFormat を参照してください。
DecimalFormat を参照してください。java.text.ChoiceFormat を参照してください。
このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。
コンストラクター
| 名前 | 説明 |
|---|---|
| NumberFormat() |
空のコンストラクター。 |
| NumberFormat(IntPtr, JniHandleOwnership) |
<strong>[icu enhancement]</strong> ICU の |
フィールド
| 名前 | 説明 |
|---|---|
| Accountingcurrencystyle |
古い.
<strong>[icu]</strong> 通貨記号を使用して会計用の通貨を表す形式の通貨スタイルを指定する定数(例: "($3. |
| Cashcurrencystyle |
古い.
<strong>[icu]</strong> 通貨 ISO コードを使用して通貨を表す形式の通貨現金スタイルを指定する定数。たとえば、"NT$3" ではなく "NT$3" です。 |
| Currencystyle |
古い.
<strong>[icu]</strong> 書式の一般的な通貨スタイルを指定する定数。 |
| FractionField |
古い.
FieldPosition オブジェクトの構築に使用される Field 定数。 |
| IntegerField |
古い.
FieldPosition オブジェクトの構築に使用される Field 定数。 |
| Integerstyle |
古い.
<strong>[icu]</strong> 整数のスタイル形式を指定する定数。 |
| Isocurrencystyle |
古い.
<strong>[icu]</strong> 通貨 ISO コードを使用して通貨を表す形式の通貨スタイルを指定する定数 (例: "USD3. |
| Numberstyle |
古い.
<strong>[icu]</strong> 通常の書式のスタイルを指定する定数。 |
| Percentstyle |
古い.
<strong>[icu]</strong> パーセントを表示する書式のスタイルを指定する定数。 |
| Pluralcurrencystyle |
古い.
<strong>[icu]</strong> 通貨を表すために複数形の通貨の長い名前を使用する形式の通貨スタイルを指定する定数 (例: "3. |
| Scientificstyle |
古い.
<strong>[icu]</strong> 指数値を表示する形式のスタイルを指定する定数。 |
| Standardcurrencystyle |
古い.
<strong>[icu]</strong> 通貨記号を使用して通貨を表す形式の通貨スタイルを指定する定数 (例: "$3")。 |
プロパティ
| 名前 | 説明 |
|---|---|
| Class |
この |
| Currency |
通貨金額の表示に使用する |
| CurrencyInstance |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GroupingUsed |
グループ化がこの形式で使用されている場合は true を返します。 または、グループ化をこの形式で使用するかどうかを設定します。 |
| Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
| Instance |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| IntegerInstance |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| JniIdentityHashCode |
相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。 (継承元 Object) |
| JniManagedPeerState |
<strong>[icu enhancement]</strong> ICU の |
| JniPeerMembers |
<strong>[icu enhancement]</strong> ICU の |
| MaximumFractionDigits |
数値の分数部分で許容される最大桁数を返します。 または、数値の分数部分で許容される最大桁数を設定します。 |
| MaximumIntegerDigits |
数値の整数部分で許容される最大桁数を返します。 または、数値の整数部分で許容される最大桁数を設定します。 |
| MinimumFractionDigits |
数値の分数部分で許容される最小桁数を返します。 または、数値の分数部分で許容される最小桁数を設定します。 |
| MinimumIntegerDigits |
数値の整数部分で許容される最小桁数を返します。 または、数値の整数部分で許容される最小桁数を設定します。 |
| NumberInstance |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| ParseIntegerOnly |
この形式で数値を整数としてのみ解析する場合は true を返します。 または、解析時に数値の分数部分を無視するかどうかを設定します (既定値は false)。 |
| ParseStrict |
<strong>[icu]</strong> 厳密な解析が有効かどうかを返します。 または、 <strong>[icu]</strong> 厳密な解析が有効かどうかを設定します。 |
| PeerReference |
このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object) |
| PercentInstance |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| RoundingMode |
この NumberFormat で使用される丸めモードを返します。 または、この NumberFormat で使用される丸めモードを設定します。 |
| ScientificInstance |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| ThresholdClass |
<strong>[icu enhancement]</strong> ICU の |
| ThresholdType |
<strong>[icu enhancement]</strong> ICU の |
メソッド
| 名前 | 説明 |
|---|---|
| Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 _Format) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
<strong>[icu enhancement]</strong> ICU の |
| Dispose() |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| Dispose(Boolean) |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| DisposeUnlessReferenced() |
<strong>[icu enhancement]</strong> ICU の |
| Equals(Object) |
<strong>[icu enhancement]</strong> ICU の |
| Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
| Format(BigDecimal, StringBuffer, FieldPosition) |
<strong>[icu]</strong> ICU BigDecimal を書式設定します。 |
| Format(BigDecimal, StringBuffer, FieldPosition) |
<strong>[icu]</strong> BigDecimal を書式設定します。 |
| Format(BigDecimal) |
BigDecimal を書式設定する便利なメソッドです。 |
| Format(BigDecimal) |
<strong>[icu]</strong> ICU BigDecimal を書式設定する便利なメソッドです。 |
| Format(BigInteger, StringBuffer, FieldPosition) |
<strong>[icu]</strong> BigInteger を書式設定します。 |
| Format(BigInteger) |
<strong>[icu]</strong> BigInteger を書式設定する便利なメソッドです。 |
| Format(CurrencyAmount, StringBuffer, FieldPosition) |
<strong>[icu]</strong> CurrencyAmount を書式設定します。 |
| Format(CurrencyAmount) |
<strong>[icu]</strong> CurrencyAmount を書式設定する便利なメソッドです。 |
| Format(Double, StringBuffer, FieldPosition) |
形式の特殊化。 |
| Format(Double) |
形式の特殊化。 |
| Format(Int64, StringBuffer, FieldPosition) |
形式の特殊化。 |
| Format(Int64) |
形式の特殊化。 |
| Format(Object, StringBuffer, FieldPosition) |
数値を書式設定し、結果のテキストを指定された文字列バッファーに追加します。 |
| Format(Object) |
文字列を生成するオブジェクトを書式設定します。 (継承元 _Format) |
| FormatToCharacterIterator(Object) |
|
| GetAvailableLocales() |
NumberFormats を使用できるロケールの一覧を返します。 |
| GetContext(DisplayContext+Type) |
[icu]指定した DisplayContext.Type のフォーマッタの DisplayContext 値 (大文字化など) を取得します。 |
| GetCurrencyInstance(Locale) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetCurrencyInstance(ULocale) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
| GetInstance(Locale, NumberFormatStyles) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetInstance(Locale) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetInstance(NumberFormatStyles) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetInstance(ULocale, NumberFormatStyles) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetInstance(ULocale) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetIntegerInstance(Locale) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetIntegerInstance(ULocale) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetNumberInstance(Locale) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetNumberInstance(ULocale) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetPattern(ULocale, Int32) |
指定されたロケールと選択肢のパターンを返します。 |
| GetPercentInstance(Locale) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetPercentInstance(ULocale) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetScientificInstance(Locale) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| GetScientificInstance(ULocale) |
<strong>NOTE:</strong> 新しいユーザーは、NumberFormat ではなく |
| JavaFinalize() |
古い.
オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
| Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
| NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
| Parse(String, ParsePosition) |
可能な場合は Long を返します (e. |
| Parse(String) |
指定した文字列の先頭からテキストを解析して、数値を生成します。 |
| ParseCurrency(ICharSequence, ParsePosition) |
指定された文字列のテキストを CurrencyAmount として解析します。 |
| ParseCurrency(String, ParsePosition) |
指定された文字列のテキストを CurrencyAmount として解析します。 |
| ParseObject(String, ParsePosition) |
文字列からテキストを解析して数値を生成します。 |
| ParseObject(String) |
指定された文字列の先頭からテキストを解析して、オブジェクトを生成します。 (継承元 _Format) |
| SetContext(DisplayContext) |
<strong>[icu]</strong> フォーマッタで特定の DisplayContext 値 (CAPITALIZATION_FOR_STANDALONEなど) を設定します。 |
| SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
<strong>[icu enhancement]</strong> ICU の |
| 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() |
<strong>[icu enhancement]</strong> ICU の |
| IJavaPeerable.Finalized() |
<strong>[icu enhancement]</strong> ICU の |
| IJavaPeerable.JniObjectReferenceControlBlock |
<strong>[icu enhancement]</strong> ICU の |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
<strong>[icu enhancement]</strong> ICU の |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
<strong>[icu enhancement]</strong> ICU の |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
<strong>[icu enhancement]</strong> ICU の |
| IJavaPeerable.UnregisterFromRuntime() |
<strong>[icu enhancement]</strong> ICU の |
拡張メソッド
| 名前 | 説明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
インスタンス |
| JavaAs<TResult>(IJavaPeerable) |
|
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
<strong>[icu enhancement]</strong> ICU の |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
|