メインコンテンツまでスキップ

Number.Round

丸めた数値を返します。桁数と丸めモードを指定できます。

Syntax​

Number.Round(
    number as number,
    optional digits as number,
    optional roundingMode as RoundingMode.Type
) as number

Remarks​

最も近い数に number を端数処理した結果を返します。number が null の場合、Number.Roundは null を返します。

既定では、number は最も近い整数に端数処理され、RoundingMode.ToEven (別名"銀行家の丸め") を使用して最も近い偶数に端数処理されることにより結びつきはなくなります。

ただしこれらの既定は、次のオプションのパラメーターを使用してオーバーライドできます。

  • digits:これにより、numberは指定された少数桁の数に端数処理されます。
  • roundingMode: number が端数処理された可能性のある 2 つの値の中間にある場合、既定の結びつきをなくす動作をオーバーライドします (使用可能な値については、RoundingMode.Type を参照してください).。

Examples​

Example #1​

1.234 を最も近い整数に丸めます。

Number.Round(1.234)

Result:

1

Example #2​

1.56 を最も近い整数に丸めます。

Number.Round(1.56)

Result:

2

Example #3​

1.2345 を小数点以下が 2 桁になるように丸めます。

Number.Round(1.2345, 2)

Result:

1.23

Example #4​

1.2345 を小数点以下が 3 桁になるように丸めます (切り上げ)。

Number.Round(1.2345, 3, RoundingMode.Up)

Result:

1.235

Example #5​

1.2345 を小数点以下が 3 桁になるように丸めます (切り下げ)。

Number.Round(1.2345, 3, RoundingMode.Down)

Result:

1.234

Category​

Number.Rounding