数値関数

ABS

ABS(数値)

引数の数値の絶対値を返します。戻り値の型は「整数」です。

例

ABS(${item1})

ACOS

ACOS(求める角度のコサインの値)

数値のアークコサインを返します。アークコサインとは、そのコサインが数値であるような角度のことです。

例

ACOS(${item1})

入力値 item1 は、求める角度のコサインの値を、-1 〜 1 の範囲で指定します。 戻り値の角度は、0 (ゼロ) 〜 PI の範囲のラジアンとなります。

ADD

ADD(数値,数値)

ADD(数値の文字列表現,数値の文字列表現)

引数の数を加算します。内部ではJavaが提供するBigDecimalクラスを使った演算を行います。浮動小数を含む厳密な計算に向いています。戻り値は数値の文字列表現になります。

例：

VALUE(ADD("0.001", "123.456"))

VALUE(ADD(0.001, 123.456))

VALUE(ADD(1000, "0.1"))

このように、引数に数値と文字列表現を混在させることもできます。

ADD関数の戻り値にVALUE関数を適用することで、8バイト浮動小数値に変換することができます。

ATAN

ATAN(求める角度のタンジェントの値)

数値のアークタンジェントを返します。アークタンジェントとは、そのタンジェントが数値であるような角度のことです。

例

ATAN(${item1})

入力値 item1 には、求める角度のタンジェントの値を指定します。戻り値の角度は、-PI/2 〜 PI/2 の範囲のラジアンとなります。

ATAN2

ATAN2(x座標値, y座標値)

指定された x-y 座標のアークタンジェントを返します。 アークタンジェントとは、x 軸から、原点 0 と x 座標、y 座標で表される点を結んだ直線までの角度のことです。

例

ATAN2(${item1}, ${item2})

入力値 item1, item2 には、それぞれ x 点の x 座標および y 点の y 座標を指定します。 戻り値の角度は、-PI 〜 PI (ただし -PI を除く) の範囲のラジアンとなります。

ASIN

ASIN(求める角度のサインの値)

数値のアークサインを返します。アークサインとは、そのサインが数値であるような角度のことです。

例

ASIN(${item1})

入力値 item1 は、求める角度のサインの値を -1 〜 1 の範囲で指定します。戻り値の角度は、-PI/2 〜 PI/2 の範囲のラジアンとなります。

CBRT

CBRT(数値)

引数の数値の立方根を返します。

例

CBRT(${item1})

CEILING

CEILING(数値, 基準値)

数値を基準値の倍数に近い値に切り上げます。戻り値の型は 8 バイト浮動小数点型です。

例

CEILING(${item1}, 1)

時間にも適用できます。

COS

COS(数値)

指定した角度のコサインを返します。コサインを求める角度をラジアンを単位として指定します。戻り値の型は 8 バイト浮動小数点型です。

例

COS(${item1})

COSH

COSH(双曲線余弦を求める実数)

数値の双曲線余弦 (ハイパーボリック コサイン) を返します。

例

COSH(${item1})

DEGREES

DEGREES(数値)

ラジアンを度に変換します。戻り値の型は 8 バイト浮動小数点型です。

例

DEGREES(${item1})

DIV

DIV(数値,数値,スケール[,丸めモード])

DIV(数値の文字列表現,数値の文字列表現,スケール[,丸めモード])

引数の数を徐算します。内部ではJavaが提供するBigDecimalクラスを使った演算を行います。浮動小数を含む厳密な計算に向いています。戻り値は数値の文字列表現になります。

例

VALUE(DIV(ADD(MUL(10000, "0.12"),MUL(10000, "0.34")),100,2,"HALFUP"))

上記例のように、引数に数値と文字列表現を混在させることもできます。0.12という浮動小数を表現した段階で、すでに誤差が含まれてしまうため、より確実な演算を行う場合は、浮動小数部は "0.12" というように文字列を引数とする方がよいでしょう。

スケールは小数点以下の桁数です。

丸めモードは次の表記を指定できます。省略時は HALFUP (四捨五入) になります。

DIV関数の戻り値にVALUE関数を適用することで、8バイト浮動小数値に変換することができます。

EVEN

EVEN(数値)

最も近い偶数に切り上げた値を返します。戻り値の型は整数型です。

例

EVEN(${item1})

EXP

EXP(数値)

e を底とする数値のべき乗を返します。戻り値の型は 8 バイト浮動小数点型です。

例

EXP(${item1})

FACT

FACT(数値)

数値の階乗を返します。数値に整数以外の値を指定すると、小数点以下が切り捨てられます。戻り値の型は 8 バイト整数です。

例

FACT(${item1})

FIXED

FIXED(数値, 桁数, 桁区切り)

数値を四捨五入し、ピリオド(".") とカンマ(",") から構成される文字列に変換します。 桁数は四捨五入の位置を示します。省略すると小数第三位で四捨五入します。 桁区切り部分は "true" か "false" を指定します。省略すると false とみなします。

例：3桁目で四捨五入とし、桁区切り(3桁毎に "," を挿入する）を行う。

FIXED(${item1}, 3, true)

FLOOR

FLOOR(数値, 基準値)

数値を基準値の倍数に近い値に切り下げます。戻り値の型は 8 バイト浮動小数点型です。

例

FLOOR(${item1}, 1)

時間にも適用できます。

HYPOT

HYPOT(数値1, 数値2)

中間のオーバーフローやアンダーフローなしに sqrt(x²+y²) が返されます。

例

HYPOT(${x}, ${y})

IEEEremainder

IEEEremainder(数値1, 数値2)

IEEE 754 標準に従って、2 個の引数について剰余を計算します。

例

IEEEremainder(${item1}, ${item2})

INT

INT(数値)

指定した数値を超えない最大の整数を返します。

例

INT(${item1})

LN

LN(数値)

数値の自然対数を返します。戻り値の型は 8 バイト浮動小数点型です。

例

LN(${item1})

LOG

LOG(数値)

数値の自然対数を返します。戻り値の型は 8 バイト浮動小数点型です。

例

LOG(${item1})

LOG(数値, 底)

指定された数を底とする数値の対数を返します。戻り値の型は 8 バイト浮動小数点型です。

例

LOG(${item1}, ${item2})

LOG1P

LOG1P(数値)

引数と 1 の合計の自然対数を返します。

例

LOG1P(${num})

LOG10

LOG10(数値)

10 を底とする数値の対数（常用対数）を返します。戻り値の型は 8 バイト浮動小数点型です。

例

LOG10(${item1})

MOD

MOD(数値, 除数)

数値を除数で割った余りを求めます。戻り値の型は整数型です。

例

MOD(${item1}, ${item2})

MROUND

MROUND(数値, 基準値)

数値を基準値の倍数に丸めます（四捨五入）。戻り値の型は 8 バイト浮動小数点型です。

例

MROUND(${item1}, 1)

時間にも適用できます。

MUL

MUL(数値,数値)

MUL(数値の文字列表現,数値の文字列表現)

引数の数を乗算します。内部ではJavaが提供するBigDecimalクラスを使った演算を行います。浮動小数を含む厳密な計算に向いています。戻り値は数値の文字列表現になります。

例：

VALUE(MUL("123.456", "456.789"))

VALUE(MUL(123.456, 456.789))

VALUE(MUL(1000, "0.1"))

このように、引数に数値と文字列表現を混在させることもできます。

MUL関数の戻り値にVALUE関数を適用することで、8バイト浮動小数値に変換することができます。

ODD

ODD(数値)

最も近い奇数に切り上げた値を返します。戻り値の型は整数型です。

例

ODD(${item1})

PI

PI()

円周率πの近似値である数値 3.14159265358979 を返します。この数値の精度は 15 桁です。戻り値の型は 8 バイト浮動小数点型です。

例

PI()

POWER

POWER(数値, 指数)

数値の指数乗を返します。数値、指数には整数または小数値を指定できます。戻り値の型は 8 バイト浮動小数点型です。

例

POWER(${item1}, 2)

QUOTIENT

QUOTIENT(分子, 分母)

除算の商の整数部を返します。戻り値の型は整数型です。

例

QUOTIENT(${item1}, ${item2})

RADIANS

RADIANS(数値)

度をラジアンに変換します。戻り値の型は 8 バイト浮動小数点型です。

例

RADIAN(${item1})

RAND

RAND()

0 以上で 1 より小さい乱数を発生させます。戻り値の型は 8 バイト浮動小数点型です。

例

RAND()

RANDBETWEEN

RANDBETWEEN(最小値, 最大値)

指定された範囲で一様に分布する整数の乱数を返します。戻り値の型は整数型です。

例

RANDBETWEEN(${min}, ${max})

RINT

RINT(数値)

引数の値にもっとも近く、計算上の整数に等しい double 値を返します。

例

RINT(${item1})

ROUND

ROUND(数値,桁数)

数値を四捨五入して指定された桁数にします。戻り値の型は「4バイト浮動小数点」または「8バイト浮動小数点」になります。（引数の数値の型によって、戻り値の型も自動的に決まります。）

• 桁数に正の数を指定すると、数値は小数点の右側 (小数点以下) で四捨五入され、小数点以下の桁数が桁数に等しくなります。
• 桁数に 0 を指定すると、数値は最も近い整数として四捨五入されます。
• 桁数に負の数を指定すると、数値は小数点の左側 (整数部分) の指定した桁 (1 の位を 0 とする) に四捨五入されます。

例 小数点2桁に丸める場合

ROUND(${item1}/${item2}, 2)

この関数は、演算誤差をなくすものではありません。 ROUNDと演算精度についての詳細は"計算式>基本的な書き方>演算精度"をお読みください。

ROUNDDOWN

ROUNDDOWN(数値,桁数)

数値を切り捨てて指定された桁数にします。戻り値の型は「4バイト浮動小数点」または「8バイト浮動小数点」になります。（引数の数値の型によって、戻り値の型も自動的に決まります。）

例 小数点2桁で切り捨てる場合

ROUNDDOWN(${item1}/${item2}, 2)

この関数は、演算誤差をなくすものではありません。 ROUNDと演算精度についての詳細は"計算式>基本的な書き方>演算精度"をお読みください。

ROUNDUP

ROUNDUP(数値,桁数)

数値を切り上げて指定された桁数にします。戻り値の型は「4バイト浮動小数点」または「8バイト浮動小数点」になります。（引数の数値の型によって、戻り値の型も自動的に決まります。）

例 小数点2桁に切り上げる場合

ROUNDUP(${item1}/${item2}, 2)

この関数は、演算誤差をなくすものではありません。 ROUNDと演算精度についての詳細は"計算式>基本的な書き方>演算精度"をお読みください。

SIN

SIN(数値)

指定した角度のサインを返します。サインを求める角度をラジアンを単位として指定します。戻り値の型は 8 バイト浮動小数点型です。

例

SIN(${item1})

SINH

SINH(双曲線正弦を求める実数)

数値の双曲線正弦 (ハイパーボリック サイン) を返します。

例

SINH(${item1})

SIGN

SIGN(数値)

引数の数値が正／負／ゼロかどうかを判定します。 数値が正の数のときは 1, ゼロのときは 0, 負の数のときは -1 を返します。戻り値の型は「整数」です。

例

SIGN(${item1})

SIGNUM

SIGNUM(数値)

引数の符号要素を返します。

例

SIGNUM(${item1})

SQRT

SQRT(数値)

正の平方根を返します。なお数値に負数を指定すると、NaN (無効な演算結果を意味する特殊表記）が返されます。戻り値の型は 8 バイト浮動小数点型です。

例

SQRT(${item1})

SUB

SUB(数値,数値)

SUB(数値の文字列表現,数値の文字列表現)

引数の数を減算します。内部ではJavaが提供するBigDecimalクラスを使った演算を行います。浮動小数を含む厳密な計算に向いています。戻り値は数値の文字列表現になります。

例

VALUE(SUB("123.456", "0.001"))

VALUE(SUB(123.456, 0.001))

VALUE(SUB(1000, "0.1"))

このように、引数に数値と文字列表現を混在させることもできます。

SUB関数の戻り値にVALUE関数を適用することで、8バイト浮動小数値に変換することができます。

TAN

TAN(数値)

指定した角度のタンジェントを返します。タンジェントを求める角度をラジアンを単位として指定します。戻り値の型は 8 バイト浮動小数点型です。

例

TAN(${item1})

TANH

TANH(双曲線余弦を求める実数)

数値の双曲線正接 (ハイパーボリック タンジェント) を返します。

例

TANH(${item1})

TRUNC

TRUNC(数値)

数値の小数部を切り捨てて、整数に変換します。戻り値の型は整数型です。

例

TRUNC(${item1})