RoundingMode 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
規定能捨棄精確度的數值運算的 四捨五入策略 。
[Android.Runtime.Register("java/math/RoundingMode", DoNotGenerateAcw=true)]
public sealed class RoundingMode : Java.Lang.Enum[<Android.Runtime.Register("java/math/RoundingMode", DoNotGenerateAcw=true)>]
type RoundingMode = class
inherit Enum- 繼承
- 屬性
備註
規定能捨棄精確度的數值運算的 四捨五入策略 。 每種四捨五入模式都表示如何計算四捨五入結果中回傳的最低有效位。 若回傳的數字少於代表精確數字結果所需的數字，則被捨棄的數字將被稱為 棄置分數 ，無論這些數字對數字值的貢獻如何。 換句話說，若以數值來看，捨棄的分數絕對值可能大於一。
每種四捨五入模式描述都會列出在該四捨五入模式下，不同兩位小數值如何四捨五入為一位數小數值。 表格中的結果欄可透過建立 BigDecimal 指定值的數字，形成 MathContext 一個適當設定的物件（precision 設 1為 ，且 roundingMode 設為該四捨五入模式），並以 BigDecimal#round round 適當的 MathContext呼叫該數字 來得到。 以下為一份總結表，顯示所有捨入模式的四捨五入運算結果。
<table class=“條紋”>caption<b><不同捨入模式>下的捨入運算摘要/b</caption><>thead<>tr<th scope=“col” rowspan=“2”><輸入編號/>th<scope = “col”colspan=8><將輸入輸入為單一數字的結果，採用給定的捨入模式>/th<>tr style=“vertical-align：top”<>th<>UP/th th/th<>th<>DOWN/th th/th th<></th>CEILING<><th>FLOOR</th><th>HALF_UP</th><th/th th>HALF_DOWN</th><th>HALF_EVEN</th th><>/th/th/UNNECESSARY<thead><><tbody style=“text-align：right”>
<TR><TH 瞄準鏡=“row”5.5></th><TD>6</TDD><>TD 5</TD><>6</TD><>TD 5</TDD><TD>6/TD<><> TD 5</TD><>TD 6<><>/TD TD 投擲ArithmeticException< /TD><tr><th 瞄準鏡=“row”2.5></th><TD>< 3/TD><TD>2</TD 3>/TD<>TD<2/ TD><>2/<達陣><>3</達陣><>2</TD><TD>2</TD><TD>投擲 ArithmeticException</TD><TH><瞄準鏡=“row”>1.6</th><TD>< 2/TD><>1</TD><>TD 2</TD TD 1/TD 2/TD><>TD 1</TD><>2</TD><>TD 2/TD TD 2</><><TD><>TD 投擲 ArithmeticException</TDTR TH 瞄準鏡=「row」>1.1</th><>TD<2>/TDD<><TD 1>/TDD<><TD 2>/TDD<><TD 1>/TDD<>TD 1/TDD<><> TD<1/TDD TD 1>/<><>TD<><TD 投擲 ></TD>ArithmeticExceptionTR<TH 瞄準鏡=「row」>1.0</th><>TD<1>/TDD TD<><><1/TDD><TD>1</TDD><TD>1</TDD><TD>1</TDD TD 1/TDD><TD>1</TDD><TD>1/TDD<><TD 1></TD TD 1/TD><TH>瞄準鏡=“row”<-1.0></th><TD-1></TD-1><></TD-1><>/TD-1/TD-1/TD-1</TD><> TD-1<><><></結束><TD-1></TD-1><>/TD-1<><>/TD TD-1</TD><TH><瞄準鏡=“row”>-1.1</th><TD-2></TD-1><>/TD-1<><>/TD TD-2</TD-1><>/TD-1/TD<>TD-2<>/TD-1<></TD TD-1>/TD-1<><></TD><TD>投擲 ArithmeticException</TDD>TR TH 瞄準鏡=“row”<-1.6></th><TD-2></TD-1><>/TD-1</TD><><TD-2><></TD><TD-2>/TD-2</TD><> TD-2<><><><>/TD TD 投擲 <>/TDArithmeticException<TR TH>瞄準鏡=“row”<-2.5></th><TD-3></TD TD><><-2/TD-2><>/TD-3<><></TD-3><>/TD-2/TD-2<><>/TD TD-2<><>/TD<>< TD>投擲<> /TDArithmeticException<tr>TH 瞄準鏡=“row”-<5.5></th><TD-6></TD-5><>/TD-5/TD-5</TD-5/TD-5><>/TD-5/TD<>< TD-6></TD><><TD-6></TD-5><></TD-6><></TD><TD>投擲ArithmeticException< /TD/><Tbody></桌子>
此設計enum旨在取代基於整數的捨入模常數列舉（BigDecimalBigDecimal#ROUND_UP、 BigDecimal#ROUND_DOWN，等）。
已在1.5中新增。
Java 文件 java.math.RoundingMode。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
屬性
| 名稱 | Description |
|---|---|
| Ceiling |
將四捨五入模式轉為向正無限大四捨五入。 |
| Class |
回傳此 |
| DeclaringClass |
回傳對應該 enum 常數的 enum 型別的 Class 物件。 (繼承來源 Enum) |
| Down |
四捨五入模式，將數值四捨五入至零。 |
| Floor |
將四捨五入模式轉為向負無限大四捨五入。 |
| HalfDown |
四捨五入模式，數值向最近鄰四捨五入。 |
| HalfEven |
四捨五入模式，數值向最近鄰四捨五入。 |
| HalfUp |
四捨五入模式，數值向最近鄰四捨五入。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
規定能捨棄精確度的數值運算的 四捨五入策略 。 (繼承來源 JavaObject) |
| JniPeerMembers |
這類人能獲得JNI同儕會員。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Enum) |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Enum) |
| Unnecessary |
捨入模式中，捨入運算會拋出 ArithmeticException，表示必須捨入，也就是無法精確表示該值的情況。 |
| Up |
四捨五入模式，正值向正無限大四捨五入，負值向負無限大四捨五入。 |
方法
| 名稱 | Description |
|---|---|
| Clone() |
丟出 CloneNotSupportedException。 (繼承來源 Enum) |
| CompareTo(Object) |
將此枚舉與指定的物件比較以取得順序。 (繼承來源 Enum) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
規定能捨棄精確度的數值運算的 四捨五入策略 。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
規定能捨棄精確度的數值運算的 四捨五入策略 。 (繼承來源 JavaObject) |
| Equals(Object) |
規定能捨棄精確度的數值運算的 四捨五入策略 。 (繼承來源 JavaObject) |
| Equals(Object) |
若指定物件等於此枚舉常數，則回傳為真。 (繼承來源 Enum) |
| GetHashCode() |
回傳此枚舉常數的雜湊碼。 (繼承來源 Enum) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Name() |
回傳這個枚舉常數的名稱，完全與其枚舉宣告中所宣告的一樣。 (繼承來源 Enum) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Ordinal() |
回傳此枚舉常數的序數（其在枚舉宣告中的位置，初始常數被賦予序數為零）。 (繼承來源 Enum) |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
規定能捨棄精確度的數值運算的 四捨五入策略 。 (繼承來源 JavaObject) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| ValueOf(RoundOptions) |
回傳 |
| ValueOf(String) |
回傳帶有指定名稱的枚舉常數。 |
| Values() |
以宣告順序回傳列舉常數。 |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
規定能捨棄精確度的數值運算的 四捨五入策略 。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
規定能捨棄精確度的數值運算的 四捨五入策略 。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
規定能捨棄精確度的數值運算的 四捨五入策略 。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
規定能捨棄精確度的數值運算的 四捨五入策略 。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
規定能捨棄精確度的數值運算的 四捨五入策略 。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
規定能捨棄精確度的數值運算的 四捨五入策略 。 (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
規定能捨棄精確度的數值運算的 四捨五入策略 。 (繼承來源 Enum) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
規定能捨棄精確度的數值運算的 四捨五入策略 。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |