Math.Round メソッド (Double, Int32)

指定された精度の、指定値に最も近い数値を返します。

Overloads Public Shared Function Round( _
   ByVal value As Double, _   ByVal digits As Integer _) As Double
[C#]
public static double Round(doublevalue,intdigits);
[C++]
public: static double Round(doublevalue,intdigits);
[JScript]
public static function Round(
   value : double,digits : int) : double;

パラメータ

• value
  丸め対象の倍精度浮動小数点数。
• digits
  戻り値の有効桁数 (精度)。

戻り値

digits に等しい精度の、最も value に近い数値。value が 2 つの整数 (一方の整数が偶数でもう一方が奇数) の中間にある場合は偶数が返されます。value の精度が digits 未満の場合は、value は変更されずに返されます。

例外

解説

digits パラメータでは 0 ～ 15 までの戻り値の有効桁数が指定されます。 digits が 0 の場合は整数が返されます。

返すことができる整数部と小数部の桁数の合計は最大で 15 です。丸め対象の値の整数部と小数部の桁数が 15 を超える場合は、上位 15 桁が返されます。丸め対象の値の整数部と小数部の桁数が 15 以下の場合、整数部の桁および digits パラメータで指定された数の小数部の桁が返されます。

このメソッドの動作は、IEEE 規格 754、セクション 4 に従います。このような丸めは、近似値への丸めまたは銀行の丸めと呼ばれることがあります。 digits を 0 にする場合、この丸めは 0 への丸めと呼ばれることがあります。

使用例

近似値に丸められるコード例を次に示します。

 
Math.Round(3.44, 1) 'Returns 3.4.
Math.Round(3.45, 1) 'Returns 3.4.
Math.Round(3.46, 1) 'Returns 3.5.

[C#] 
Math.Round(3.44, 1); //Returns 3.4.
Math.Round(3.45, 1); //Returns 3.4.
Math.Round(3.46, 1); //Returns 3.5.

[C++] 

Math::Round(3.44, 1); //Returns 3.4.
Math::Round(3.45, 1); //Returns 3.4.
Math::Round(3.46, 1); //Returns 3.5.

[JScript] 
System.Math.Round(3.44, 1) //Returns 3.4.
System.Math.Round(3.45, 1) //Returns 3.4.
System.Math.Round(3.46, 1) //Returns 3.5.

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

Math クラス | Math メンバ | System 名前空間 | Math.Round オーバーロードの一覧 | Ceiling | Floor