Apex 開発者ガイド
jDecimal クラス
丸めモード
丸めモードでは、精度を破棄する数値操作の丸め動作を指定します。
各丸めモードでは、丸められた結果の返される再下位の桁を計算する方法を示します。次に、roundingMode の有効な値を示します。
Decimal のメソッド
Decimal のメソッドは次のとおりです。
divide(divisor, scale, roundingMode)
この decimal を指定した除数で除算し、スケール (指定したスケールを使用した結果の小数点以下の桁数) を設定し、必要に応じて丸めモードを使用して値を丸めます。
署名
public Decimal divide(Decimal divisor, Integer scale, System.RoundingMode roundingMode)
パラメータ
- divisor
- 型: Decimal
- scale
- 型: Integer
- roundingMode
- 型: System.RoundingMode
戻り値
型: Decimal
例
format()
コンテキストユーザのロケールを使用して、decimal の string 値を返します。
署名
public String format()
戻り値
型: String
使用方法
指数が必要な場合、科学的記数法が使用されます。
例
precision()
decimal の桁数の合計を返します。
署名
public Integer precision()
戻り値
型: Integer
例
たとえば、小数値が 123.45 の場合、precision は 5 を返します。小数値が 123.123 の場合、precision は 6 を返します。
round()
decimal の丸められた近似値を返します。数値は、均等丸めモードを使用して、「最も近い近似値」である整数に丸められます。ただし、両方の近似値が等距離にある場合は、このモードでは偶数の近似値に丸められます。
署名
public Long round()
戻り値
型: Long
使用方法
この丸めモードは、連続する計算に対して繰り返し適用される場合、統計的に累積エラーを最小化します。
例
round(roundingMode)
decimal の丸められた近似値を返します。数値は、丸めモードで指定された丸めモードを使用して、小数点以下の桁数 0 に丸められます。
署名
public Long round(System.RoundingMode roundingMode)
パラメータ
- roundingMode
- 型: System.RoundingMode
戻り値
型: Long
setScale(scale)
必要に応じて均等丸めモードを使用して、指定された小数点以下の桁数に拡大・縮小します。均等丸めモードでは、「最も近い近似値」に丸められます。2 つの近似値が等距離にある場合は、偶数の近似値に丸められます。
署名
public Decimal setScale(Integer scale)
パラメータ
- scale
- 型: Integer
-
scale の値は、–33 ～ 33 です。scale の値が負の場合は、スケールなしの値に 10 のマイナス scale 乗が乗算されます。たとえば、この操作後、d の値は 4*10^3 になります。
戻り値
型: Decimal
使用方法
decimal のスケールを明示的に設定しない場合、decimal が作成された項目がスケールを決定します。
- decimal がクエリの一部として作成される場合、スケールはクエリから返される項目のスケールに基づきます。
- decimal が string から作成される場合、スケールは string の小数点以下の桁の文字数となります。
- 小数値が小数以外の数値から作成される場合は、この数値が最初に文字列に変換されます。その後、小数点以下の桁数を使用してスケールが設定されます。
例
setScale(scale, roundingMode)
必要に応じて指定した丸めモードを使用して、Decimal のスケールを指定した小数点以下の桁数に設定します。
署名
public Decimal setScale(Integer scale, System.RoundingMode roundingMode)
パラメータ
- scale
- 型: Integer
-
scale の値は、–33 ～ 33 です。scale の値が負の場合は、スケールなしの値に 10 のマイナス scale 乗が乗算されます。たとえば、この操作後、d の値は 4*10^3 になります。
- roundingMode
- 型: System.RoundingMode
戻り値
型: Decimal
使用方法
decimal のスケールを明示的に設定しない場合、decimal が作成された項目がスケールを決定します。
- decimal がクエリの一部として作成される場合、スケールはクエリから返される項目のスケールに基づきます。
- decimal が string から作成される場合、スケールは string の小数点以下の桁の文字数となります。
- 小数値が小数以外の数値から作成される場合は、この数値が最初に文字列に変換されます。その後、小数点以下の桁数を使用してスケールが設定されます。