Math.Ceiling Método

public:
 static System::Decimal Ceiling(System::Decimal d);

public static decimal Ceiling (decimal d);

static member Ceiling : decimal -> decimal

Public Shared Function Ceiling (d As Decimal) As Decimal

Parámetros

Devoluciones

Decimal

Valor entero más pequeño que es mayor o igual que d.The smallest integral value that is greater than or equal to d. Tenga en cuenta que este método devuelve un valor Decimal en lugar de un tipo entero.Note that this method returns a Decimal instead of an integral type.

Ejemplos

En el ejemplo siguiente se muestra el Math.Ceiling(Decimal) método y se contrasta con el Floor(Decimal) método.The following example illustrates the Math.Ceiling(Decimal) method and contrasts it with the Floor(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

Comentarios

El comportamiento de este método sigue el estándar IEEE 754, sección 4.The behavior of this method follows IEEE Standard 754, section 4. Este tipo de redondeo a veces se denomina redondeo hacia el infinito positivo.This kind of rounding is sometimes called rounding toward positive infinity. En otras palabras, si d es positivo, la presencia de cualquier componente fraccionario hace que d se redondee al siguiente entero más alto.In other words, if d is positive, the presence of any fractional component causes d to be rounded to the next highest integer. Si d es negativo, la operación de redondeo hace que se descarte cualquier componente fraccionario de d .If d is negative, the rounding operation causes any fractional component of d to be discarded. La operación de este método difiere del Floor(Decimal) método, que admite el redondeo hacia el infinito negativo.The operation of this method differs from the Floor(Decimal) method, which supports rounding toward negative infinity.

Consulte también

• Round
• Floor(Decimal)

public:
 static double Ceiling(double a);

public static double Ceiling (double a);

static member Ceiling : double -> double

Public Shared Function Ceiling (a As Double) As Double

Parámetros

Devoluciones

Double

Valor entero más pequeño que es mayor o igual que a.The smallest integral value that is greater than or equal to a. Si a es igual que NaN, NegativeInfinity o PositiveInfinity, se devuelve ese valor.If a is equal to NaN, NegativeInfinity, or PositiveInfinity, that value is returned. Tenga en cuenta que este método devuelve un valor Double en lugar de un tipo entero.Note that this method returns a Double instead of an integral type.

Ejemplos

En el ejemplo siguiente se muestra el Math.Ceiling(Double) método y se contrasta con el Floor(Double) método.The following example illustrates the Math.Ceiling(Double) method and contrasts it with the Floor(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

Comentarios

El comportamiento de este método sigue el estándar IEEE 754, sección 4.The behavior of this method follows IEEE Standard 754, section 4. Este tipo de redondeo a veces se denomina redondeo hacia el infinito positivo.This kind of rounding is sometimes called rounding toward positive infinity. En otras palabras, si a es positivo, la presencia de cualquier componente fraccionario hace que a se redondee al siguiente entero más alto.In other words, if a is positive, the presence of any fractional component causes a to be rounded to the next highest integer. Si a es negativo, la operación de redondeo hace que se descarte cualquier componente fraccionario de a .If a is negative, the rounding operation causes any fractional component of a to be discarded. La operación de este método difiere del Floor(Double) método, que admite el redondeo hacia el infinito negativo.The operation of this method differs from the Floor(Double) method, which supports rounding toward negative infinity.

A partir de Visual Basic 15,8, se optimiza el rendimiento de la conversión de doble a entero si se pasa el valor devuelto por el Ceiling método a cualquiera de las funciones de conversión integral, o si el valor Double devuelto por Ceiling se convierte automáticamente en un entero con Option Strict establecida en OFF.Starting with Visual Basic 15.8, the performance of Double-to-integer conversion is optimized if you pass the value returned by the Ceiling method to the any of the integral conversion functions, or if the Double value returned by Ceiling is automatically converted to an integer with Option Strict set to Off. Esta optimización permite que el código se ejecute más rápido, hasta el doble de rápido para código que realiza un gran número de conversiones a tipos enteros.This optimization allows code to run faster -- up to twice as fast for code that does a large number of conversions to integer types. En el ejemplo siguiente se muestran estas conversiones optimizadas:The following example illustrates such optimized conversions:

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

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

Consulte también

• Round
• Floor(Double)