CompactDecimalFormat 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
以簡潔（縮寫）符號格式化數字，例如「1.
[Android.Runtime.Register("android/icu/text/CompactDecimalFormat", ApiSince=24, DoNotGenerateAcw=true)]
public class CompactDecimalFormat : Android.Icu.Text.DecimalFormat[<Android.Runtime.Register("android/icu/text/CompactDecimalFormat", ApiSince=24, DoNotGenerateAcw=true)>]
type CompactDecimalFormat = class
inherit DecimalFormat- 繼承
- 屬性
備註
數字格式化為簡潔（縮寫）符號，例如「1.2K」而非「1200」。
<強烈>重要：</強烈> 強烈建議新用戶看看是否 NumberFormatter 符合他們的使用情境。 雖然尚未被棄用，但此類別 CompactDecimalFormat 僅提供向下相容性。
<人資>
CompactDecimalFormat 產生縮寫數字，適合在有限空間環境中顯示。 例如，「Hits： 1.2B」而非「Hits： 1,200,000,000'。 格式會依照指定語言適用，例如「1,2 Mrd」。 德語。
對於小於1000兆的數字（小於10^15，例如123,456,789,012,345），結果會是支援語言的縮寫。 然而，結果有時可能超過7個字元，例如當有合併標記或薄字元時。 在這種情況下，字型的視覺寬度仍應較短。
預設是有兩個高位數。 建立後，若設定超過三個有效位數（以 setMaximumSignificantDigits 為例），或為固定數字數（以 setMaximumIntegerDigits 或 setMaximumFractionDigits 設定），結果可能會更寬。
「short」風格也能格式化貨幣金額，例如「$1.2M」取代「$1,200,000.00」（英文）或「5.3 Mio」。 「€」取代「5.300,000,00 €」（德文）。 關於較長格式的在地化資料尚未在 Unicode CLDR 中提供。 因此，嘗試用「長型」格式格式化貨幣金額時，會產生 UnsupportedOperationException。
目前不支援負數與解析，會產生 UnsupportedOperationException。 不支援重設圖案的前綴或後綴;方法呼叫會被忽略。
請注意，像是設定小數點數這類重要方法，將從 DecimalFormat 上移至 NumberFormat。
Java 文件 android.icu.text.CompactDecimalFormat。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| CompactDecimalFormat(IntPtr, JniHandleOwnership) |
以簡潔（縮寫）符號格式化數字，例如「1. |
欄位
| 名稱 | Description |
|---|---|
| Accountingcurrencystyle |
已淘汰.
<strong>[icu]</strong> Constant 用來指定以貨幣符號表示貨幣的格式，例如：「（$3. (繼承來源 NumberFormat) |
| Cashcurrencystyle |
已淘汰.
<strong>[icu]</strong> Constant 用來指定貨幣現金格式，使用貨幣 ISO 代碼來表示貨幣，例如：「NT$3」而非「NT$3」。 (繼承來源 NumberFormat) |
| Currencystyle |
已淘汰.
<strong>[icu]</strong> Constant 用以指定一般的貨幣格式。 (繼承來源 NumberFormat) |
| FractionField |
已淘汰.
場常數用於建構 FieldPosition 物件。 (繼承來源 NumberFormat) |
| IntegerField |
已淘汰.
場常數用於建構 FieldPosition 物件。 (繼承來源 NumberFormat) |
| Integerstyle |
已淘汰.
<強[>icu]</strong> 常數用來指定整數格式。 (繼承來源 NumberFormat) |
| Isocurrencystyle |
已淘汰.
<strong>[icu]</strong> Constant 用來指定使用貨幣 ISO 代碼來表示貨幣的貨幣格式，例如：「USD3。 (繼承來源 NumberFormat) |
| MinimumGroupingDigitsAuto |
<strong>[icu]</strong> 常數 for for |
| MinimumGroupingDigitsMin2 |
<strong>[icu]</strong> 常數 for |
| Numberstyle |
已淘汰.
<強[>icu]</強> 常數用來指定格式的正規數。 (繼承來源 NumberFormat) |
| PadAfterPrefix |
已淘汰.
<strong>[icu]</strong> 常數用於 |
| PadAfterSuffix |
已淘汰.
<strong>[icu]</strong> 常數表示 |
| PadBeforePrefix |
已淘汰.
<strong>[icu]</strong> 常數用於 |
| PadBeforeSuffix |
已淘汰.
<strong>[icu]</strong> 常數，表示 |
| Percentstyle |
已淘汰.
<strong>[icu]</strong> 常數用來指定一種格式以顯示百分比。 (繼承來源 NumberFormat) |
| Pluralcurrencystyle |
已淘汰.
<strong>[icu]</strong> Constant 用來指定貨幣格式，使用貨幣長名稱並複數格式表示貨幣，例如「3. (繼承來源 NumberFormat) |
| Scientificstyle |
已淘汰.
<strong>[icu]</strong> 常數用來指定一種格式以顯示科學數字。 (繼承來源 NumberFormat) |
| Standardcurrencystyle |
已淘汰.
<strong>[icu]</strong> 常數用來指定使用貨幣符號來表示貨幣的格式，例如「$3. (繼承來源 NumberFormat) |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Currency |
回傳 |
| CurrencyPluralInfo |
<strong>[icu]</strong> 回傳目前的 CurrencyPluralInfo 實例。 -或- <strong>[icu]</strong> 設定 CurrencyPluralInfo 的自訂實例。 (繼承來源 DecimalFormat) |
| CurrencyUsage |
[加護病房]回傳貨幣金額四捨五入的策略。 (繼承來源 DecimalFormat) |
| DecimalFormatSymbols |
回傳此格式器所使用的十進位格式符號副本。 -或- 設定此格式化器所使用的十進位符號。 (繼承來源 DecimalFormat) |
| DecimalPatternMatchRequired |
<strong>[icu]</strong> 回傳小數點是否必須符合模式。 -或- <強[icu]>/強<>強解析<：>/strong< 此方法用於><要求>/em<><或em forbid>/em<，字串中不存在小數點（預設為停用）。> (繼承來源 DecimalFormat) |
| DecimalSeparatorAlwaysShown |
回傳是否顯示整數上的十進位分隔符。 -或- <強>分隔符：</強>分隔符 若十進位分隔符（emen-US中的 </>em< 中的一個週期>）是否顯示在整數上。 (繼承來源 DecimalFormat) |
| ExponentSignAlwaysShown |
<strong>[icu]</strong> 回傳符號（加號或減號）是否總是以科學記號法印刷。 -或- <強>[icu]</強><強>科學記號法：</強>集合 在科學記號中，指數中是否必須顯示符號（加或負）。 (繼承來源 DecimalFormat) |
| FormatWidth |
回傳格式化輸出的最小字元數。 -or- <強填充>：</strong> 設定格式化管線輸出字串的最小寬度。 (繼承來源 DecimalFormat) |
| GroupingSize |
回傳正在使用的主要群組大小。 -或- <強分>組：</strong> 設定在格式化大數字時所使用的主要分組大小（分組分隔符之間的距離）。 (繼承來源 DecimalFormat) |
| GroupingUsed |
若使用此格式的分組，則會回傳真值。 -或- 設定在此格式中是否使用分組。 (繼承來源 NumberFormat) |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
以簡潔（縮寫）符號格式化數字，例如「1. (繼承來源 JavaObject) |
| JniPeerMembers |
以簡潔（縮寫）符號格式化數字，例如「1. |
| MathContext |
<強力>[重症監護室]</強> 力 將被使用者回傳 |
| MathContextICU |
<強力>[重症監護室]</強> 力 將被使用者回傳 |
| MaximumFractionDigits |
回傳數字分數部分允許的最大位數。 -或- 設定數字分數部分中允許的最大位數。 (繼承來源 NumberFormat) |
| MaximumIntegerDigits |
回傳數字整數部分允許的最大位數。 -或- 設定數字整數部分允許的最大位數。 (繼承來源 NumberFormat) |
| MaximumSignificantDigits |
<strong>[icu]</strong> 回傳顯示的有效最大有效位數。 -或- <strong>[icu]/<strong><強 強 四>捨五入與數字限制：</strong> 設定顯示的最大有效位數。 (繼承來源 DecimalFormat) |
| MinimumExponentDigits |
<strong>[icu]</strong> 回傳科學符號中指數中印出的最少數字數。 -或- <strong>[icu]</strong><strong>科學符號：</strong> 設定指數中最少要印出的數字數。 (繼承來源 DecimalFormat) |
| MinimumFractionDigits |
回傳數字分數部分中允許的最小位數。 -或- 設定數字分數部分中允許的最小位數。 (繼承來源 NumberFormat) |
| MinimumGroupingDigits |
<strong>[icu]</strong> 回傳觸發分組前的最小位數。 -或- <strong>[icu]</strong> 設定第一個分組分隔符之前必須出現的最小數字數，以便列印分組分隔符。 (繼承來源 DecimalFormat) |
| MinimumIntegerDigits |
回傳數字整數部分允許的最小位數。 -或- 設定數字整數部分允許的最小數字數。 (繼承來源 NumberFormat) |
| MinimumSignificantDigits |
<strong>[icu]</strong> 回傳顯示的有效最低有效位數。 -或- <strong[icu]>/strong<>強 四<捨五入與數字限制：>/strong< 設定顯示的有效位數最少>數量。 (繼承來源 DecimalFormat) |
| Multiplier |
回傳數字在格式化前所施加的乘數。 -或- 設定一個數字，用於格式化前乘所有數字。 (繼承來源 DecimalFormat) |
| NegativePrefix |
<strong>Affixes：</strong> 取得目前用於格式化數字的負前綴字串。 -或- <強字>綴：</strong> 將字串置於負數前。 (繼承來源 DecimalFormat) |
| NegativeSuffix |
<強字>綴：</strong> 獲得目前用於格式化數字的負後綴字串。 -或- <強詞>綴：</strong> 將字串設為附加負數。 (繼承來源 DecimalFormat) |
| PadCharacter |
<強[>重症監護室]</強> 力 返回用於填充的角色。 -或- <強>[icu]</強><強>Padding：</strong> 設定用於填充比寬 |
| PadPosition |
<strong>[icu]</strong> 回傳用於輔助的姿勢。 -或- <強[>icu]/<強><力強 Padding>：</strong> 設定當寬度低於指定 |
| ParseBigDecimal |
回傳是否 |
| ParseCaseSensitive |
<strong>[icu]</strong> 回傳在解析時是否強制大小寫（大寫/小寫）相符。 -或- <strong>[icu]</strong> 指定解析是否應該要求字句在詞綴、指數分隔符和貨幣代碼上匹配。 (繼承來源 DecimalFormat) |
| ParseIntegerOnly |
如果此格式僅解析數字為整數，則回傳為真。 -或- 設定解析時是否忽略數字的分數部分（預設為 false）。 (繼承來源 NumberFormat) |
| ParseMaxDigits |
總是回傳1000，這是ICU 59之前的預設值。 (繼承來源 DecimalFormat) |
| ParseNoExponent |
<strong>[icu]/<strong> 回傳解析時是否忽略指數。 -或- <strong>[icu]</strong> 指定遇到指數分隔符時是否停止解析。 (繼承來源 DecimalFormat) |
| ParseStrict |
<strong>[icu]</strong> 回傳是否實施嚴格解析。 -或- <強[>icu]</strong> 集合，是否實施嚴格語法分析。 (繼承來源 NumberFormat) |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| PositivePrefix |
<strong>Affixes：</strong> 取得目前用於格式化數字的正面前綴字串。 -或- <強詞>綴：</強> 將字串置於正數前。 (繼承來源 DecimalFormat) |
| PositiveSuffix |
<強字>綴：</strong> 獲得目前用於數字格式化的正字尾字串。 -或- <強詞>綴：</strong> 設定字串附加於正數。 (繼承來源 DecimalFormat) |
| RoundingIncrement |
<strong>[icu]</strong> 回傳被四捨五入的數字遞增。 -或- <強[>icu]</strong><強 強 四>捨五入與數字限制：</strong> 設定一個增量或區間，數字四捨五入。 (繼承來源 DecimalFormat) |
| RoundingMode |
回傳此數字格式中使用的四捨五入模式。 -或- 設定此數字格式中使用的四捨五入模式。 (繼承來源 NumberFormat) |
| ScientificNotation |
<strong>[icu]/<strong> 回傳此格式化器是否啟用科學（指數）符號。 -或- <strong[icu]>/strong<>strong Scientific<Notation：>/strong< 集合 判斷此格式化器是否應該以科學（指數）符號>列印。 (繼承來源 DecimalFormat) |
| SecondaryGroupingSize |
<strong>[icu]</strong> 回傳當時使用的次要分組大小。 -或- <強[icu]>/強<>強分<組：>/strong< 設定次要分組大小（第一個分隔符之後分組分隔符之間的距離），用於格式化大數字>時。 (繼承來源 DecimalFormat) |
| SignAlwaysShown |
<strong>[icu]</strong> 回傳符號是否顯示在正數上。 -或- 設定是否總是在正數上顯示加號（em en</em> 中的<>「+」）。 (繼承來源 DecimalFormat) |
| ThresholdClass |
以簡潔（縮寫）符號格式化數字，例如「1. |
| ThresholdType |
以簡潔（縮寫）符號格式化數字，例如「1. |
方法
| 名稱 | Description |
|---|---|
| ApplyLocalizedPattern(String) |
將給定字串轉換為標準符號，然後用 |
| ApplyPattern(String) |
解析給定的模式字串，並覆寫該模式字串中指定的設定。 (繼承來源 DecimalFormat) |
| AreSignificantDigitsUsed() |
<strong>[icu]</strong> 回傳是否使用有效位數進行四捨五入。 (繼承來源 DecimalFormat) |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 _Format) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
以簡潔（縮寫）符號格式化數字，例如「1. (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
以簡潔（縮寫）符號格式化數字，例如「1. (繼承來源 JavaObject) |
| Equals(Object) |
以簡潔（縮寫）符號格式化數字，例如「1. (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| Format(BigDecimal, StringBuffer, FieldPosition) |
[加護病房]格式化為加護病房的大十進位。 (繼承來源 DecimalFormat) |
| Format(BigDecimal, StringBuffer, FieldPosition) |
[加護病房]格式為大十進制。 (繼承來源 DecimalFormat) |
| Format(BigDecimal) |
方便格式化大十進制的方法。 (繼承來源 NumberFormat) |
| Format(BigDecimal) |
<強>[重症監護室]</強力> 便利方法來格式化加護病房大十進位。 (繼承來源 NumberFormat) |
| Format(BigInteger, StringBuffer, FieldPosition) |
[加護病房]格式為大整數。 (繼承來源 DecimalFormat) |
| Format(BigInteger) |
<強[>icu]</strong> 便利方法來格式化一個大整數。 (繼承來源 NumberFormat) |
| Format(CurrencyAmount, StringBuffer, FieldPosition) |
<強力>[iccu]</強格式> 貨幣金額。 (繼承來源 NumberFormat) |
| Format(CurrencyAmount) |
<強>[icu]</strong> 便利性方法來格式化貨幣金額。 (繼承來源 NumberFormat) |
| Format(Double, StringBuffer, FieldPosition) |
格式的專業化。 (繼承來源 DecimalFormat) |
| Format(Double) |
格式的專業化。 (繼承來源 NumberFormat) |
| Format(Int64, StringBuffer, FieldPosition) |
格式的專業化。 (繼承來源 DecimalFormat) |
| Format(Int64) |
格式的專業化。 (繼承來源 NumberFormat) |
| Format(Object, StringBuffer, FieldPosition) |
格式化一個數字，並將所得文字附加到給定的字串緩衝區。 (繼承來源 NumberFormat) |
| Format(Object) |
格式化物件以產生字串。 (繼承來源 _Format) |
| FormatToCharacterIterator(Object) |
格式化物件產生 |
| GetContext(DisplayContext+Type) |
[加護病房]取得格式化器的 DisplayContext 值，針對指定的 DisplayContext.Type，例如 CAPITALIZATION。 (繼承來源 NumberFormat) |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| GetInstance(Locale, CompactDecimalFormat+CompactStyle) |
注意：新用戶強烈建議使用 NumberFormatter 而非 NumberFormat。 |
| GetInstance(ULocale, CompactDecimalFormat+CompactStyle) |
注意：新用戶強烈建議使用 NumberFormatter 而非 NumberFormat。 |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Parse(String, ParsePosition) |
若可能，回傳 Long （例如範圍在 [Long.MIN_VALUE， Long.MAX_VALUE] 範圍內且無小數）;否則，會回傳另一種類型，例如大十進位、大整數或雙倍。 (繼承來源 DecimalFormat) |
| Parse(String) |
從給定字串的開頭解析文字以產生一個數字。 (繼承來源 NumberFormat) |
| ParseCurrency(ICharSequence, ParsePosition) |
將給定字串中的文字解析為 CurrencyAmount。 (繼承來源 NumberFormat) |
| ParseCurrency(String, ParsePosition) |
將給定字串中的文字解析為 CurrencyAmount。 (繼承來源 NumberFormat) |
| ParseObject(String, ParsePosition) |
從字串中解析文字以產生一個數字。 (繼承來源 NumberFormat) |
| ParseObject(String) |
解析給定字串開頭的文字以產生物件。 (繼承來源 _Format) |
| SetContext(DisplayContext) |
<strong>[icu]</strong> 在格式化器中設定特定的 DisplayContext 值，例如 CAPITALIZATION_FOR_STANDALONE。 (繼承來源 NumberFormat) |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
以簡潔（縮寫）符號格式化數字，例如「1. (繼承來源 JavaObject) |
| SetRoundingIncrement(BigDecimal) |
<強[>iccu]</強強><四>捨五入與數字限制：</強> 超載 |
| SetRoundingIncrement(Double) |
<強[>iccu]</強強><四>捨五入與數字限制：</強> 超載 |
| SetSignificantDigitsUsed(Boolean) |
<強[>icu]</強><強 四>捨五入與數字限制：</強> 是否應使用有效數字來四捨五入。 (繼承來源 DecimalFormat) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToLocalizedPattern() |
呼叫 |
| ToPattern() |
將此格式化物件序列化為十進位格式模式字串。 (繼承來源 DecimalFormat) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
以簡潔（縮寫）符號格式化數字，例如「1. (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
以簡潔（縮寫）符號格式化數字，例如「1. (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
以簡潔（縮寫）符號格式化數字，例如「1. (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
以簡潔（縮寫）符號格式化數字，例如「1. (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
以簡潔（縮寫）符號格式化數字，例如「1. (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
以簡潔（縮寫）符號格式化數字，例如「1. (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
以簡潔（縮寫）符號格式化數字，例如「1. (繼承來源 _Format) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
以簡潔（縮寫）符號格式化數字，例如「1. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |