BigDecimal.Format 方法

[Android.Runtime.Register("format", "(II)Ljava/lang/String;", "GetFormat_IIHandler", ApiSince=24)]
public virtual string? Format(int before, int after);

[<Android.Runtime.Register("format", "(II)Ljava/lang/String;", "GetFormat_IIHandler", ApiSince=24)>]
abstract member Format : int * int -> string
override this.Format : int * int -> string

參數

傳回

String表示此 BigDecimal的 A，依據指定參數排列

屬性

RegisterAttribute

備註

回傳 String 此 BigDecimal表示，並依照版面參數修改。

此方法作為原語，供更進階類別 DecimalFormat 使用，例如，能對結果進行區域敏感編輯。 它所提供的格式化層級是 BigDecimal 類別中不可或缺的一部分，因為它對 BigDecimal 算術的計算與四捨五入規則敏感且必須遵守。 然而，如果該函式在其他地方有提供，則可能會從此類別中移除。

兩種方法 format 的參數皆為型別 int。 任何參數的值為 -1 表示該參數應使用預設動作或值。

參數 和 beforeafter分別指定了整數部分和小數位所使用的字元數。 不使用指數符號。 如果任一參數為 -1（表示預設動作），所用字元數將恰好等同於該部分所需的字元數。

before 必須是正數;如果它大於容納整數部分所需的尺寸，該部分會在左側填充空白，長度為所需長度。 如果 before 不夠大以包含整數部分（包括負數的符號），則會拋出例外。

after 必須是非負數;若大小與小數點不相同，則會將數字四捨五入（或加零）以符合。 將 為 指定 0 after 會使該數字被四捨五入為整數（即沒有小數點或小數點）。 四捨五入法將是預設的。 MathContext.ROUND_HALF_UP

其他捨入方法及指數符號的使用，可透過使用 #format(int,int,int,int,int,int)選擇。 使用雙參數形式的方法效果與使用六參數形式完全相同，且最後四個參數皆為-1。

Java 文件 android.icu.math.BigDecimal.format(int, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

[Android.Runtime.Register("format", "(IIIIII)Ljava/lang/String;", "GetFormat_IIIIIIHandler", ApiSince=24)]
public virtual string? Format(int before, int after, int explaces, int exdigits, int exformint, Android.Icu.Math.RoundOptions exround);

[<Android.Runtime.Register("format", "(IIIIII)Ljava/lang/String;", "GetFormat_IIIIIIHandler", ApiSince=24)>]
abstract member Format : int * int * int * int * int * Android.Icu.Math.RoundOptions -> string
override this.Format : int * int * int * int * int * Android.Icu.Math.RoundOptions -> string

參數

傳回

String表示此 BigDecimal的 A，依據指定參數排列

屬性

RegisterAttribute

備註

回傳 String 此 BigDecimal表示，經版面參數修改並允許指數符號。

此方法作為原語，供更進階類別 DecimalFormat 使用，例如，能對結果進行區域敏感編輯。 它所提供的格式化層級是 BigDecimal 類別中不可或缺的一部分，因為它對 BigDecimal 算術的計算與四捨五入規則敏感且必須遵守。 然而，如果該函式在其他地方有提供，則可能會從此類別中移除。

參數皆為型別 int。 任何參數的值為 -1 表示該參數應使用預設動作或值。

前兩個參數（before和after）分別指定了整數部分和小數點的字元數，定義為。#format(int,int) 如果這兩者中有任一 -1（表示預設動作），所用字元數將正好等同於該部分所需的字元數。

其餘參數則控制指數符號與四捨五入的使用。 三個（、explaces、 exdigits和 exform）控制結果的指數部分。 如前所述，這些參數的預設動作可透過 -1 選擇。

explaces 必須是正數;它設定了指數部分可使用的位數（指數符號後的位數），預設（當 explaces -1時）會使用所需數量。 若 explaces 非 −1，則總預留空間給指數;若不需要（例如指數為 0），則 explaces會附加 +2 個空白。 （此設計保留了單寬字型中格式相似數字的垂直對齊。）若 explaces 不 -1 且不夠大以容納指數，則拋出例外。

exdigits 設定了指數符號的觸發點。 若在任何四捨五入前，小數點前所需的位數超過 exdigits，或結果的絕對值小於 0.000001，則使用指數型，前提是已指定。exdigits 當為 -1 時 exdigits ，則永遠不會使用指數符號。 若 對 指定 exdigits為 0，則總是使用指數符號，除非指數為 0。

exform 設定指數符號的形式（如有需要）。 它可能是 MathContext#SCIENTIFICMathContext#ENGINEERING或 。 若要求後者的工程型態，整數部分before 可能需要最多三位數（若為負則加符號）。 否則只需一個數字（若為負則加號）。

最後，第六個參數 exround選擇了要使用的捨入演算法，且必須是類別中一個以 開頭ROUND_ 的公開常數MathContext所指示的值之一。 預設值ROUND_HALF_UP（）也可依舊使用值 -1 選擇。

特殊值 MathContext.ROUND_UNNECESSARY 可用來偵測非零數字是否被丟棄——若 exround 有此值，則若格式化時非零數字會被捨棄（四捨五入），則會拋出 a ArithmeticException 。

Java 文件 android.icu.math.BigDecimal.format(int, int, int, int, int, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。