BigDecimalオブジェクト
コンポーネント情報 | |
---|---|
version | 8.0.15 |
変更が不可能な、任意精度の符号付き10進数です。BigDecimal は、任意精度のスケールなしの整数値と、32ビット整数のスケールで構成されます。
0または正の場合、スケールは小数点以下の桁数です。負の場合、スケールなしの数値に、スケールの正負を逆にした値を指数とする10の累乗を乗算します。
詳細については、java の java.math.BigDecimal のAPIドキュメントを参照してください。
0または正の場合、スケールは小数点以下の桁数です。負の場合、スケールなしの数値に、スケールの正負を逆にした値を指数とする10の累乗を乗算します。
詳細については、java の java.math.BigDecimal のAPIドキュメントを参照してください。
コンストラクタの概要
BigDecimal (BigInteger val ) BigInteger を BigDecimal に変換します。 |
BigDecimal (BigInteger val , MathContext mc ) コンテキスト設定に従った丸めを使用して、BigInteger を BigDecimal に変換します。 |
BigDecimal (BigInteger unscaledVal , Number scale ) BigInteger のスケールなしの値と Number のスケールを BigDecimal に変換します。 |
BigDecimal (BigInteger unscaledVal , Number scale , MathContext mc ) コンテキスト設定に従った丸めを使用して、BigInteger のスケールなしの値と Number のスケールを BigDecimal に変換します。 |
BigDecimal (Number val ) Number を Number のバイナリ浮動小数点値の正確な 10 進数表現である BigDecimal に変換します。 |
BigDecimal (Number val , MathContext mc ) コンテキスト設定に従った丸めを使用して、Number を BigDecimal に変換します。 |
BigDecimal (String val ) BigDecimal の文字列表現を BigDecimal に変換します。 |
BigDecimal (String val , MathContext mc ) BigDecimal の文字列表現を BigDecimal に変換し、コンテキスト設定に従った丸めを使用して、同じ文字列を BigDecimal(String) コンストラクタとして受け取ります。 |
メソッドの概要
返却値の型 | メソッド名 |
---|---|
BigDecimal | abs () 値がこの BigDecimal の絶対値でスケールが this.scale() である BigDecimal を返します。 |
BigDecimal | abs (MathContext mc ) コンテキスト設定に従った丸めを使用して、値がこの BigDecimal の絶対値である BigDecimal を返します。 |
BigDecimal | add (BigDecimal augend ) 値が (this + augend) でスケールが max(this.scale(), augend.scale()) である BigDecimal を返します。 |
BigDecimal | add (BigDecimal augend , MathContext mc ) コンテキスト設定に従った丸めを使用して、値が (this + augend) である BigDecimal を返します。 |
Number | compareTo (BigDecimal val ) この BigDecimal を指定された BigDecimal と比較します。 |
Array | divideAndRemainder (BigDecimal divisor ) divideToIntegralValue の結果とそれに続く2つのオペランドの remainder の結果を含む、2要素の BigDecimal配列 を返します。 |
Array | divideAndRemainder (BigDecimal divisor , MathContext mc ) コンテキスト設定に従った丸めを使用して計算された divideToIntegralValue の結果と、 2つのオペランドの remainder の結果を含む、2要素の BigDecimal 配列を返します。 |
BigDecimal | divideToIntegralValue (BigDecimal divisor ) 値が丸められた商 (this / divisor) の整数部である BigDecimal を返します。 |
BigDecimal | divideToIntegralValue (BigDecimal divisor , MathContext mc ) 値が (this / divisor) の整数部である BigDecimal を返します。 |
BigDecimal | divide (BigDecimal divisor ) 値が (this / divisor) で優先スケールが (this.scale() - divisor.scale()) である BigDecimal を返します。 |
BigDecimal | divide (BigDecimal divisor , MathContext mc ) コンテキスト設定に従った丸めを使用して、値が (this / divisor) である BigDecimal を返します。 |
BigDecimal | divide (BigDecimal divisor , Number scale , RoundingMode roundingMode ) 値が (this / divisor) で、スケールが指定されたものである BigDecimal を返します。 |
BigDecimal | divide (BigDecimal divisor , RoundingMode roundingMode ) 値が (this / divisor) でスケールが this.scale() である BigDecimal を返します。 |
Boolean | equals (Object x ) この BigDecimal と指定された Object が同じかどうか比較します。 |
BigDecimal | max (BigDecimal val ) この BigDecimal と val の最大値を返します。 |
BigDecimal | min (BigDecimal val ) この BigDecimal と val の最小値を返します。 |
BigDecimal | movePointLeft (Number n ) 小数点を n 桁左へ移動してこれに等しい BigDecimal を返します。 |
BigDecimal | movePointRight (Number n ) 小数点を n 桁右へ移動してこれに等しい BigDecimal を返します。 |
BigDecimal | multiply (BigDecimal multiplicand ) 値が (this × multiplicand) でスケールが (this.scale() + multiplicand.scale()) である BigDecimal を返します。 |
BigDecimal | multiply (BigDecimal multiplicand , MathContext mc ) コンテキスト設定に従った丸めを使用して、値が (this × multiplicand) である BigDecimal を返します。 |
BigDecimal | negate () 値が (-this) で スケールが this.scale() である BigDecimal を返します。 |
BigDecimal | negate (MathContext mc ) コンテキスト設定に従った丸めを使用して、値が (-this) である BigDecimal を返します。 |
Number | numberValue () この BigDecimal を Number に変換します。 |
BigDecimal | pow (Number n ) 値が (thisn) である BigDecimal を返します。 |
BigDecimal | pow (Number n , MathContext mc ) コンテキスト設定に従った丸めを使用して、値が (thisn) である BigDecimal を返します。 |
Number | precision () この BigDecimal の精度を返します。 |
BigDecimal | remainder (BigDecimal divisor ) 値が (this % divisor) である BigDecimal を返します。 |
BigDecimal | remainder (BigDecimal divisor , MathContext mc ) コンテキスト設定に従った丸めを使用して、値が (this % divisor) である BigDecimal を返します。 |
BigDecimal | round (MathContext mc ) MathContext 設定に従って丸められた BigDecimal を返します。 |
BigDecimal | scaleByPowerOfTen (Number n ) 数値が (this * 10n) に等しい BigDecimal を返します。 |
Number | scale () この BigDecimal のスケールを返します。 |
BigDecimal | setScale (Number newScale , RoundingMode roundingMode ) スケールが指定された値であり、かつスケールなしの値が、この BigDecimal のスケールなしの値と、総体値を維持できる適当な 10 の累乗の積または商により決定される BigDecimal を返します。 |
Number | signum () この BigDecimal の符号要素を返します。 |
BigDecimal | stripTrailingZeros () 数値はこれに等しいが、末尾の0が表現から削除された BigDecimal を返します。 |
BigDecimal | subtract (BigDecimal subtrahend ) 値が (this - subtrahend) でスケールが max(this.scale(), subtrahend.scale()) である BigDecimal を返します。 |
BigDecimal | subtract (BigDecimal subtrahend , MathContext mc ) コンテキスト設定に従った丸めを使用して、値が (this - subtrahend) である BigDecimal を返します。 |
BigInteger | toBigIntegerExact () この BigDecimal を BigInteger に変換し、失われた情報がないかどうかを確認します。 |
BigInteger | toBigInteger () この BigDecimal を BigInteger に変換します。 |
String | toPlainString () 指数フィールドなしで、この BigDecimal の文字列表現を返します。 |
BigInteger | unscaledValue () 値がこの BigDecimal のスケールなしの値である BigInteger を返します。 |
BigDecimal | valueOf (Number val ) static値が指定された Number の値と等しい BigDecimal を返します。 |
コンストラクタの詳細
BigDecimal (BigInteger val )
BigInteger を BigDecimal に変換します。
BigDecimal のスケールは 0 です。
パラメータ
|
BigDecimal (BigInteger val , MathContext mc )
コンテキスト設定に従った丸めを使用して、BigInteger を BigDecimal に変換します。
BigDecimal のスケールは 0 です。
パラメータ
|
BigDecimal (BigInteger unscaledVal , Number scale )
BigInteger のスケールなしの値と Number のスケールを BigDecimal に変換します。
BigDecimalの値は (unscaledVal × 10-scale) です。
パラメータ
|
BigDecimal (BigInteger unscaledVal , Number scale , MathContext mc )
コンテキスト設定に従った丸めを使用して、BigInteger のスケールなしの値と Number のスケールを BigDecimal に変換します。
BigDecimalの値は (unscaledVal × 10-scale) であり、precision と丸めモード設定に従って丸められます。
パラメータ
|
BigDecimal (Number val )
Number を Number のバイナリ浮動小数点値の正確な 10 進数表現である BigDecimal に変換します。
返された BigDecimal のスケールは、(10scale × val) が整数となるような最小値です。
パラメータ
|
BigDecimal (Number val , MathContext mc )
コンテキスト設定に従った丸めを使用して、Number を BigDecimal に変換します。
BigDecimal のスケールは、(10scale × val) が整数であるような最小値です。
パラメータ
|
BigDecimal (String val )
BigDecimal の文字列表現を BigDecimal に変換します。
文字列表現は、任意の符号「+」(「¥u002B」) または「-」(「¥u002D」) と、それに続く 0 桁以上の 10 進数字 (「整数部」) の列で構成され、任意で小数部または指数が付随します。
パラメータ
|
BigDecimal (String val , MathContext mc )
BigDecimal の文字列表現を BigDecimal に変換し、コンテキスト設定に従った丸めを使用して、同じ文字列を BigDecimal(String) コンストラクタとして受け取ります。
パラメータ
|
メソッドの詳細
BigDecimal abs ()
値がこの BigDecimal の絶対値でスケールが this.scale() である BigDecimal を返します。
返却値
|
BigDecimal abs (MathContext mc )
コンテキスト設定に従った丸めを使用して、値がこの BigDecimal の絶対値である BigDecimal を返します。
パラメータ
返却値
|
BigDecimal add (BigDecimal augend )
値が (this + augend) でスケールが max(this.scale(), augend.scale()) である BigDecimal を返します。
パラメータ
返却値
|
BigDecimal add (BigDecimal augend , MathContext mc )
コンテキスト設定に従った丸めを使用して、値が (this + augend) である BigDecimal を返します。
どちらかの数値が 0 で精度設定が 0 以外である場合、必要に応じて丸められたほかの数値が結果として使用されます。
パラメータ
返却値
|
Number compareTo (BigDecimal val )
この BigDecimal を指定された BigDecimal と比較します。
このメソッドでは、値は等しいがスケールが異なる2つの BigDecimal オブジェクト(たとえば、2.0と2.00)が等しいと見なされます。
パラメータ
返却値
|
Array divideAndRemainder (BigDecimal divisor )
divideToIntegralValue の結果とそれに続く2つのオペランドの remainder の結果を含む、2要素の BigDecimal配列 を返します。
パラメータ
返却値
|
Array divideAndRemainder (BigDecimal divisor , MathContext mc )
コンテキスト設定に従った丸めを使用して計算された divideToIntegralValue の結果と、 2つのオペランドの remainder の結果を含む、2要素の BigDecimal 配列を返します。
パラメータ
返却値
|
BigDecimal divideToIntegralValue (BigDecimal divisor )
値が丸められた商 (this / divisor) の整数部である BigDecimal を返します。
結果の優先スケールは (this.scale() - divisor.scale()) です。
パラメータ
返却値
|
BigDecimal divideToIntegralValue (BigDecimal divisor , MathContext mc )
値が (this / divisor) の整数部である BigDecimal を返します。
正確な商の整数部は丸めモードに依存しないため、丸めモードはこのメソッドにより返される値に影響を及ぼしません。
パラメータ
返却値
|
BigDecimal divide (BigDecimal divisor )
値が (this / divisor) で優先スケールが (this.scale() - divisor.scale()) である BigDecimal を返します。
パラメータ
返却値
|
BigDecimal divide (BigDecimal divisor , MathContext mc )
コンテキスト設定に従った丸めを使用して、値が (this / divisor) である BigDecimal を返します。
パラメータ
返却値
|
BigDecimal divide (BigDecimal divisor , Number scale , RoundingMode roundingMode )
値が (this / divisor) で、スケールが指定されたものである BigDecimal を返します。
丸めを行い、指定したスケールで結果を生成する必要がある場合は、指定した丸めモードが適用されます。
パラメータ
返却値
|
BigDecimal divide (BigDecimal divisor , RoundingMode roundingMode )
値が (this / divisor) でスケールが this.scale() である BigDecimal を返します。
丸めを行い、特定のスケールで結果を生成する必要がある場合は、指定された丸めモードが適用されます。
パラメータ
返却値
|
Boolean equals (Object x )
この BigDecimal と指定された Object が同じかどうか比較します。
パラメータ
返却値
|
BigDecimal max (BigDecimal val )
この BigDecimal と val の最大値を返します。
パラメータ
返却値
|
BigDecimal min (BigDecimal val )
この BigDecimal と val の最小値を返します。
パラメータ
返却値
|
BigDecimal movePointLeft (Number n )
小数点を n 桁左へ移動してこれに等しい BigDecimal を返します。
n が負でない場合は、スケールに n を単に加算します。 n が負の場合は、movePointRight(-n) に等しくなります。 この呼出しによって返される BigDecimal は、値 (this × 10-n) およびスケール max(this.scale() + n, 0) となります。
パラメータ
返却値
|
BigDecimal movePointRight (Number n )
小数点を n 桁右へ移動してこれに等しい BigDecimal を返します。
n が負でない場合は、スケールから n を単に減算します。n が負の場合は、movePointLeft(-n) に等しくなります。 この呼出しによって返される BigDecimal は、値 (this × 10n) およびスケール max(this.scale() - n, 0) となります。
パラメータ
返却値
|
BigDecimal multiply (BigDecimal multiplicand )
値が (this × multiplicand) でスケールが (this.scale() + multiplicand.scale()) である BigDecimal を返します。
パラメータ
返却値
|
BigDecimal multiply (BigDecimal multiplicand , MathContext mc )
コンテキスト設定に従った丸めを使用して、値が (this × multiplicand) である BigDecimal を返します。
パラメータ
返却値
|
BigDecimal negate ()
値が (-this) で スケールが this.scale() である BigDecimal を返します。
返却値
|
BigDecimal negate (MathContext mc )
コンテキスト設定に従った丸めを使用して、値が (-this) である BigDecimal を返します。
パラメータ
返却値
|
Number numberValue ()
この BigDecimal を Number に変換します。
この変換により、BigDecimal 値の精度に関する情報が失われる可能性があります。
返却値
|
BigDecimal pow (Number n )
値が (thisn) である BigDecimal を返します。
パラメータ
返却値
|
BigDecimal pow (Number n , MathContext mc )
コンテキスト設定に従った丸めを使用して、値が (thisn) である BigDecimal を返します。
パラメータ
返却値
|
Number precision ()
この BigDecimal の精度を返します。
精度とは、スケールなしの値の桁数のことです。
返却値
|
BigDecimal remainder (BigDecimal divisor )
値が (this % divisor) である BigDecimal を返します。
剰余は、this.subtract(this.divideToIntegralValue(divisor).multiply(divisor)) で得られます。これはモジュロ演算ではない(負の結果が可能)であることに留意してください。
パラメータ
返却値
|
BigDecimal remainder (BigDecimal divisor , MathContext mc )
コンテキスト設定に従った丸めを使用して、値が (this % divisor) である BigDecimal を返します。
MathContext 設定は、剰余の計算に使用する暗黙的な除算に影響を及ぼします。定義の示すとおり、剰余の計算自体は正確です。そのため、剰余は mc.getPrecision() よりも多くの桁を含む可能性があります。 剰余は、this.subtract(this.divideToIntegralValue(divisor, mc).multiply(divisor)) で得られます。これはモジュロ演算ではない(負の結果が可能)であることに留意してください。
パラメータ
返却値
|
BigDecimal round (MathContext mc )
MathContext 設定に従って丸められた BigDecimal を返します。
精度設定が 0 の場合、丸めは実行されません。
パラメータ
返却値
|
BigDecimal scaleByPowerOfTen (Number n )
数値が (this * 10n) に等しい BigDecimal を返します。
結果のスケールは (this.scale() - n) です。
パラメータ
返却値
|
Number scale ()
この BigDecimal のスケールを返します。
0 または正の場合、スケールは小数点以下の桁数です。負の場合、スケールなしの数値に、スケールの正負を逆にした値を指数とする 10 の累乗を乗算します。たとえば、-3 のスケールでは、スケールなしの値に 1000 が乗算されます。
返却値
|
BigDecimal setScale (Number newScale , RoundingMode roundingMode )
スケールが指定された値であり、かつスケールなしの値が、この BigDecimal のスケールなしの値と、総体値を維持できる適当な 10 の累乗の積または商により決定される BigDecimal を返します。
スケールが演算で減らされる場合、スケールなしの値は(乗算ではなく)除算する必要があり、値が変わる可能性があります。この場合、指定した丸めモードが除算に適用されます。
パラメータ
返却値
|
Number signum ()
この BigDecimal の符号要素を返します。
返却値
|
BigDecimal stripTrailingZeros ()
数値はこれに等しいが、末尾の0が表現から削除された BigDecimal を返します。
返却値
|
BigDecimal subtract (BigDecimal subtrahend )
値が (this - subtrahend) でスケールが max(this.scale(), subtrahend.scale()) である BigDecimal を返します。
パラメータ
返却値
|
BigDecimal subtract (BigDecimal subtrahend , MathContext mc )
コンテキスト設定に従った丸めを使用して、値が (this - subtrahend) である BigDecimal を返します。
パラメータ
返却値
|
BigInteger toBigIntegerExact ()
この BigDecimal を BigInteger に変換し、失われた情報がないかどうかを確認します。
この BigDecimal に 0 以外の小数部がある場合、例外がスローされます。
返却値
|
BigInteger toBigInteger ()
この BigDecimal を BigInteger に変換します。
この変換により、BigDecimal 値の精度に関する情報が失われる可能性があります。
返却値
|
String toPlainString ()
指数フィールドなしで、この BigDecimal の文字列表現を返します。
返却値
|
BigInteger unscaledValue ()
値がこの BigDecimal のスケールなしの値である BigInteger を返します。
返却値
|
BigDecimal valueOf (Number val )
static
値が指定された Number の値と等しい BigDecimal を返します。
パラメータ
返却値
|