Math.Floor メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した数以下の数のうち、最大の整数値を返します。
オーバーロード
| Floor(Double) |
指定した倍精度浮動小数点数以下の数のうち、最大の整数値を返します。 |
| Floor(Decimal) |
指定した 10 進数以下の数のうち、最大の整数値を返します。 |
注釈
このメソッドの動作は、IEEE Standard 754 セクション 4 に従います。 このような丸めは、負の無限大に向かって丸めと呼ばれることもあります。
Floor(Double)
指定した倍精度浮動小数点数以下の数のうち、最大の整数値を返します。
public:
static double Floor(double d);public static double Floor (double d);static member Floor : double -> doublePublic Shared Function Floor (d As Double) As Doubleパラメーター
- d
- Double
倍精度浮動小数点数。
戻り値
d 以下の最大の整数値。 d が NaN、NegativeInfinity、PositiveInfinity のいずれかに等しい場合は、その値が返されます。
例
次の例では、 メソッドを Math.Floor(Double) 示し、 メソッドと Ceiling(Double) 比較します。
double[] values = {7.03, 7.64, 0.12, -0.12, -7.1, -7.6};
Console.WriteLine(" Value Ceiling Floor\n");
foreach (double value in values)
Console.WriteLine("{0,7} {1,16} {2,14}",
value, Math.Ceiling(value), Math.Floor(value));
// The example displays the following output to the console:
// Value Ceiling Floor
//
// 7.03 8 7
// 7.64 8 7
// 0.12 1 0
// -0.12 0 -1
// -7.1 -7 -8
// -7.6 -7 -8
// The ceil and floor functions may be used instead.
let values =
[ 7.03; 7.64; 0.12; -0.12; -7.1; -7.6 ]
printfn " Value Ceiling Floor\n"
for value in values do
printfn $"{value,7} {Math.Ceiling value,16} {Math.Floor value,14}"
// The example displays the following output to the console:
// Value Ceiling Floor
//
// 7.03 8 7
// 7.64 8 7
// 0.12 1 0
// -0.12 0 -1
// -7.1 -7 -8
// -7.6 -7 -8
Dim values() As Double = {7.03, 7.64, 0.12, -0.12, -7.1, -7.6}
Console.WriteLine(" Value Ceiling Floor")
Console.WriteLine()
For Each value As Double In values
Console.WriteLine("{0,7} {1,16} {2,14}", _
value, Math.Ceiling(value), Math.Floor(value))
Next
' The example displays the following output to the console:
' Value Ceiling Floor
'
' 7.03 8 7
' 7.64 8 7
' 0.12 1 0
' -0.12 0 -1
' -7.1 -7 -8
' -7.6 -7 -8
注釈
このメソッドの動作は、IEEE Standard 754 セクション 4 に従います。 このような丸めは、負の無限大に向かって丸めと呼ばれることもあります。 つまり、 が正の場合 d 、小数部分は切り捨てられます。 が負の場合 d 、小数部が存在すると、小さい整数に丸められます。 このメソッドの動作は、正の無限大への Ceiling 丸めをサポートする メソッドとは異なります。
Visual Basic 15.8 以降では、メソッドによって Floor 返された値を 整数変換関数のいずれかに渡す場合、または によって返される Floor Double 値が Option Strict が Off に設定された整数に自動的に変換される場合、Double から整数への変換のパフォーマンスが最適化されます。 この最適化によって、コードをより速く実行できます。大きい数値の整数型への変換を行うコードでは、最大で 2 倍速くなります。 次の例は、このような最適化された変換を示しています。
Dim d1 As Double = 1043.75133
Dim i1 As Integer = CInt(Math.Floor(d1)) ' Result: 1043
Dim d2 As Double = 7968.4136
Dim i2 As Integer = CInt(Math.Floor(d2)) ' Result: 7968
こちらもご覧ください
適用対象
Floor(Decimal)
指定した 10 進数以下の数のうち、最大の整数値を返します。
public:
static System::Decimal Floor(System::Decimal d);public static decimal Floor (decimal d);static member Floor : decimal -> decimalPublic Shared Function Floor (d As Decimal) As Decimalパラメーター
- d
- Decimal
10 進数。
戻り値
d 以下の最大の整数値。 このメソッドは、Decimal 型の整数値を返すことに注意してください。
例
次の例では、 メソッドを Math.Floor(Decimal) 示し、 メソッドと Ceiling(Decimal) 比較します。
decimal[] values = {7.03m, 7.64m, 0.12m, -0.12m, -7.1m, -7.6m};
Console.WriteLine(" Value Ceiling Floor\n");
foreach (decimal value in values)
Console.WriteLine("{0,7} {1,16} {2,14}",
value, Math.Ceiling(value), Math.Floor(value));
// The example displays the following output to the console:
// Value Ceiling Floor
//
// 7.03 8 7
// 7.64 8 7
// 0.12 1 0
// -0.12 0 -1
// -7.1 -7 -8
// -7.6 -7 -8
// The ceil and floor functions may be used instead.
let values =
[ 7.03m; 7.64m; 0.12m; -0.12m; -7.1m; -7.6m ]
printfn " Value Ceiling Floor\n"
for value in values do
printfn $"{value,7} {Math.Ceiling value,16} {Math.Floor value,14}"
// The example displays the following output to the console:
// Value Ceiling Floor
//
// 7.03 8 7
// 7.64 8 7
// 0.12 1 0
// -0.12 0 -1
// -7.1 -7 -8
// -7.6 -7 -8
Dim values() As Decimal = {7.03d, 7.64d, 0.12d, -0.12d, -7.1d, -7.6d}
Console.WriteLine(" Value Ceiling Floor")
Console.WriteLine()
For Each value As Decimal In values
Console.WriteLine("{0,7} {1,16} {2,14}", _
value, Math.Ceiling(value), Math.Floor(value))
Next
' The example displays the following output to the console:
' Value Ceiling Floor
'
' 7.03 8 7
' 7.64 8 7
' 0.12 1 0
' -0.12 0 -1
' -7.1 -7 -8
' -7.6 -7 -8
注釈
このメソッドの動作は、IEEE Standard 754 セクション 4 に従います。 このような丸めは、負の無限大に向かって丸めと呼ばれることもあります。 つまり、 が正の場合 d 、小数部分は切り捨てられます。 が負の場合 d 、小数部が存在すると、小さい整数に丸められます。 このメソッドの動作は、正の無限大への Ceiling 丸めをサポートする メソッドとは異なります。