Decimal.Floor(Decimal) 方法

定義

命名空間:

System

組件:

System.Runtime.dll

來源:

Decimal.cs

將指定的 Decimal 數字往負無限大方向捨入為最接近的整數。

public:
 static System::Decimal Floor(System::Decimal d) = System::Numerics::IFloatingPoint<System::Decimal>::Floor;

public static decimal Floor (decimal d);

static member Floor : decimal -> decimal

Public Shared Function Floor (d As Decimal) As Decimal

參數

d

Decimal

要捨入的值。

傳回

Decimal

如果 d 具有小數部分，則為往負無限大方向，小於 d 的下一個 Decimal 整數。

-或-

如果 d 不具有小數部分，則傳回的 d 不變更。 請注意，方法會傳回 Decimal 類型的整數值。

實作

Floor(TSelf)

範例

下列範例說明 Floor 方法，並與 方法對比 Ceiling 。

using System;

public class Example
{
   public static void Main()
   {
      decimal[] values = {12.6m, 12.1m, 9.5m, 8.16m, .1m, -.1m,  -1.1m,
                          -1.9m, -3.9m};
      Console.WriteLine("{0,-8} {1,10} {2,10}\n",
                        "Value", "Ceiling", "Floor");
      foreach (decimal value in values)
      Console.WriteLine("{0,-8} {1,10} {2,10}", value,
                        Decimal.Ceiling(value), Decimal.Floor(value));
   }
}
// The example displays the following output:
//       Value       Ceiling      Floor
//
//       12.6             13         12
//       12.1             13         12
//       9.5              10          9
//       8.16              9          8
//       0.1               1          0
//       -0.1              0         -1
//       -1.1             -1         -2
//       -1.9             -1         -2
//       -3.9             -3         -4

open System

let values = 
    [ 12.6m; 12.1m; 9.5m; 8.16m; 0.1m; -0.1m;  -1.1m; -1.9m; -3.9m ]

printfn "%-8s %10s %10s\n" "Value" "Ceiling" "Floor"

for value in values do
    printfn $"%-8O{value} %10O{Decimal.Ceiling value} %10O{Decimal.Floor value}"

// The example displays the following output:
//       Value       Ceiling      Floor
//
//       12.6             13         12
//       12.1             13         12
//       9.5              10          9
//       8.16              9          8
//       0.1               1          0
//       -0.1              0         -1
//       -1.1             -1         -2
//       -1.9             -1         -2
//       -3.9             -3         -4

Module Example
   Public Sub Main()
      Dim values() As Decimal = {12.6d, 12.1d, 9.5d, 8.16d, .1d, -.1d,  
                                 -1.1d, -1.9d, -3.9d}
      Console.WriteLine("{0,-8} {1,10} {2,10}", 
                        "Value", "Ceiling", "Floor")
      Console.WriteLine()
      For Each value As Decimal In values
      Console.WriteLine("{0,-8} {1,10} {2,10}", value,
                        Decimal.Ceiling(value), Decimal.Floor(value))
      Next                                     
   End Sub
End Module
' The example displays the following output:
'       Value       Ceiling      Floor
'       
'       12.6             13         12
'       12.1             13         12
'       9.5              10          9
'       8.16              9          8
'       0.1               1          0
'       -0.1              0         -1
'       -1.1             -1         -2
'       -1.9             -1         -2
'       -3.9             -3         -4

備註

此方法的行為遵循 IEEE Standard 754 第 4 節。 這種四捨五入有時稱為四捨五入為負無限大。 換句話說，如果 d 為正數，則會截斷任何小數部分。 如果 d 為負數，則任何小數部分的存在都會使它四捨五入為較小的整數。 這個方法的作業與 方法不同 Ceiling ，其支援四捨五入為正無限大。

另請參閱

• Round(Decimal, Int32)
• Truncate(Decimal)
• Ceiling(Decimal)
• Floor(Decimal)