Math.Floor Math.Floor Math.Floor Math.Floor Method

Definition

Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Zahl ist.Returns the largest integral value less than or equal to the specified number.

Überlädt

Floor(Double) Floor(Double) Floor(Double) Floor(Double)

Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Gleitkommazahl mit doppelter Genauigkeit ist.Returns the largest integral value less than or equal to the specified double-precision floating-point number.

Floor(Decimal) Floor(Decimal) Floor(Decimal) Floor(Decimal)

Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Dezimalzahl ist.Returns the largest integral value less than or equal to the specified decimal number.

Beispiele

Hinweis

Die C#-Beispiele in diesem Artikel werden in der Inlinecodeausführung und dem Playground von Try.NET ausgeführt.The C# examples in this article run in the Try.NET inline code runner and playground. Klicken Sie auf die Schaltfläche Ausführen, um ein Beispiel in einem interaktiven Fenster auszuführen.Select the Run button to run an example in an interactive window. Nachdem Sie den Code ausgeführt haben, können Sie ihn ändern und den geänderten Code durch erneutes Anklicken der Schaltfläche Ausführen ausführen.Once you execute the code, you can modify it and run the modified code by selecting Run again. Der geänderte Code wird entweder im interaktiven Fenster ausgeführt, oder das interaktive Fenster zeigt alle C#-Compilerfehlermeldungen an, wenn die Kompilierung fehlschlägt.The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

Hinweise

Das Verhalten dieser Methode folgt Standard IEEE-754, Abschnitt 4.The behavior of this method follows IEEE Standard 754, section 4. Diese Art der Rundung wird manchmal bezeichnet runden in Richtung minus unendlich.This kind of rounding is sometimes called rounding toward negative infinity.

Floor(Double) Floor(Double) Floor(Double) Floor(Double)

Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Gleitkommazahl mit doppelter Genauigkeit ist.Returns the largest integral value less than or equal to the specified double-precision floating-point number.

public:
 static double Floor(double d);
public static double Floor (double d);
static member Floor : double -> double
Public Shared Function Floor (d As Double) As Double

Parameter

d
Double Double Double Double

Eine Gleitkommazahl mit doppelter Genauigkeit.A double-precision floating-point number.

Gibt zurück

Die größte Ganzzahl, die kleiner oder gleich d ist.The largest integral value less than or equal to d. Wenn d gleich NaN, NegativeInfinity oder PositiveInfinity ist, wird dieser Wert zurückgegeben.If d is equal to NaN, NegativeInfinity, or PositiveInfinity, that value is returned.

Beispiele

Das folgende Beispiel veranschaulicht die Math.Floor(Double) Methode und steht im Gegensatz zu mit dem Ceiling(Double) Methode.The following example illustrates the Math.Floor(Double) method and contrasts it with the Ceiling(Double) method.

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
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

Hinweise

Das Verhalten dieser Methode folgt Standard IEEE-754, Abschnitt 4.The behavior of this method follows IEEE Standard 754, section 4. Diese Art der Rundung wird manchmal bezeichnet runden in Richtung minus unendlich.This kind of rounding is sometimes called rounding toward negative infinity. Das heißt, wenn d positiv ist, werden alle Nachkommawert wird abgeschnitten.In other words, if d is positive, any fractional component is truncated. Wenn d ist negativ ist, das Vorhandensein jede Nachkommastelle bewirkt, dass es auf die kleinere ganze Zahl gerundet werden soll.If d is negative, the presence of any fractional component causes it to be rounded to the smaller integer. Die Ausführung der Methode unterscheidet sich von der Ceiling -Methode, die unterstützt runden in Richtung plus unendlich.The operation of this method differs from the Ceiling method, which supports rounding toward positive infinity.

Visual Basic-15.8 ab, die Leistung von doppelten Werten in ganzzahlige Konvertierung wird optimiert, wenn Sie, den Rückgabewert übergeben von der Floor Methode, um eines der ganzzahligen Konvertierungsfunktionen, oder wenn der Double-Wert zurückgegebenes Floor wird automatisch in eine Ganzzahl mit Vorzeichen konvertiert Option Strict auf Off festgelegt ist.Starting with Visual Basic 15.8, the performance of Double-to-integer conversion is optimized if you pass the value returned by the Floor method to the any of the integral conversion functions, or if the Double value returned by Floor is automatically converted to an integer with Option Strict set to Off. Dank dieser Optimierung kann Code schneller ausgeführt werden. Code, der viele Ganzzahltypen konvertiert, wird bis zu doppelt so schnell ausgeführt.This optimization allows code to run faster -- up to twice as fast for code that does a large number of conversions to integer types. Das folgende Beispiel veranschaulicht diese optimierte Konvertierungen:The following example illustrates such optimized conversions:

Dim d1 As Double = 1043.75133
Dim i1 As Integer = CInt(Math.Ceiling(d1))        ' Result: 1043

Dim d2 As Double = 7968.4136
Dim i2 As Integer = CInt(Math.Ceiling(d2))        ' Result: 7968
Siehe auch

Floor(Decimal) Floor(Decimal) Floor(Decimal) Floor(Decimal)

Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Dezimalzahl ist.Returns the largest integral value less than or equal to the specified decimal number.

public:
 static System::Decimal Floor(System::Decimal d);
public static decimal Floor (decimal d);
static member Floor : decimal -> decimal
Public Shared Function Floor (d As Decimal) As Decimal

Parameter

d
Decimal Decimal Decimal Decimal

Eine Decimal-Zahl.A decimal number.

Gibt zurück

Die größte Ganzzahl, die kleiner oder gleich d ist.The largest integral value less than or equal to d. Beachten Sie, dass die Methode einen Ganzzahlwert des Typs Decimal zurückgibt.Note that the method returns an integral value of type Decimal.

Beispiele

Das folgende Beispiel veranschaulicht die Math.Floor(Decimal) Methode und steht im Gegensatz zu mit dem Ceiling(Decimal) Methode.The following example illustrates the Math.Floor(Decimal) method and contrasts it with the Ceiling(Decimal) method.

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
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

Hinweise

Das Verhalten dieser Methode folgt Standard IEEE-754, Abschnitt 4.The behavior of this method follows IEEE Standard 754, section 4. Diese Art der Rundung wird manchmal bezeichnet runden in Richtung minus unendlich.This kind of rounding is sometimes called rounding toward negative infinity. Das heißt, wenn d positiv ist, werden alle Nachkommawert wird abgeschnitten.In other words, if d is positive, any fractional component is truncated. Wenn d ist negativ ist, das Vorhandensein jede Nachkommastelle bewirkt, dass es auf die kleinere ganze Zahl gerundet werden soll.If d is negative, the presence of any fractional component causes it to be rounded to the smaller integer. Die Ausführung der Methode unterscheidet sich von der Ceiling -Methode, die unterstützt runden in Richtung plus unendlich.The operation of this method differs from the Ceiling method, which supports rounding toward positive infinity.

Siehe auch

Gilt für: