Decimal.Floor(Decimal) Methode

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Rundet eine angegebene Decimal-Zahl auf die nächste Ganzzahl in Richtung minus unendlich.

public:
 static System::Decimal Floor(System::Decimal d);
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

Parameter

d
Decimal

Hierbei handelt es sich um den zu rundenden Wert.

Gibt zurück

Decimal

Wenn d einen Teil mit Bruchzahlen enthält, die nächste ganze Decimal-Zahl in Richtung minus unendlich, die kleiner als d ist.

- oder -

Wenn d keinen Teil mit Bruchzahlen aufweist, wird d unverändert zurückgegeben. Beachten Sie, dass die Methode einen Ganzzahlwert vom Typ Decimal zurückgibt.

Implementiert

Floor(TSelf)

Beispiele

Im folgenden Beispiel wird die Floor -Methode veranschaulicht und mit der Ceiling -Methode kontrastiert.

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

Hinweise

Das Verhalten dieser Methode folgt IEEE Standard 754, Abschnitt 4. Diese Art von Rundung wird manchmal als Rundung in Richtung negative Unendlichkeit bezeichnet. Mit anderen Worten, wenn d positiv ist, wird jede Bruchkomponente abgeschnitten. Wenn d negativ ist, führt das Vorhandensein einer bruchbehafteten Komponente dazu, dass sie auf die kleinere ganze Zahl gerundet wird. Der Betrieb dieser Methode unterscheidet sich von der Methode, die Ceiling die Rundung in Richtung positive Unendlichkeit unterstützt.

Gilt für:

Weitere Informationen