Math.Ceiling Math.Ceiling Math.Ceiling Math.Ceiling Method

Definición

Devuelve el menor valor integral mayor o igual que el número especificado.Returns the smallest integral value greater than or equal to the specified number.

Sobrecargas

Ceiling(Decimal) Ceiling(Decimal) Ceiling(Decimal) Ceiling(Decimal)

Devuelve el valor integral más pequeño que es mayor o igual que el número decimal especificado.Returns the smallest integral value that is greater than or equal to the specified decimal number.

Ceiling(Double) Ceiling(Double) Ceiling(Double) Ceiling(Double)

Devuelve el valor integral más pequeño que es mayor o igual que el número de punto flotante de precisión doble especificado.Returns the smallest integral value that is greater than or equal to the specified double-precision floating-point number.

Ejemplos

Nota

Los ejemplos de C# de este artículo se ejecutan en el ejecutor de código en línea y área de juegos de Try.NET.The C# examples in this article run in the Try.NET inline code runner and playground. Haga clic en el botón Ejecutar para ejecutar un ejemplo en una ventana interactiva.Select the Run button to run an example in an interactive window. Una vez que se ejecuta el código, puede modificar y ejecutar el código modificado si vuelve a hacer clic en Ejecutar.Once you execute the code, you can modify it and run the modified code by selecting Run again. El código modificado se ejecuta en la ventana interactiva o, si se produce un error en la compilación, en la ventana interactiva se muestran todos los mensajes de error del compilador de C#.The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

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.

Ceiling(Decimal) Ceiling(Decimal) Ceiling(Decimal) Ceiling(Decimal)

Devuelve el valor integral más pequeño que es mayor o igual que el número decimal especificado.Returns the smallest integral value that is greater than or equal to the specified decimal number.

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

d
Decimal Decimal Decimal Decimal

Número decimal.A decimal number.

Devoluciones

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 Math.Ceiling(Decimal) el 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 d que 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 d componente fraccionario de.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 método Floor(Decimal) , 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:

Ceiling(Double) Ceiling(Double) Ceiling(Double) Ceiling(Double)

Devuelve el valor integral más pequeño que es mayor o igual que el número de punto flotante de precisión doble especificado.Returns the smallest integral value that is greater than or equal to the specified double-precision floating-point number.

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

a
Double Double Double Double

Número de punto flotante de precisión doble.A double-precision floating-point number.

Devoluciones

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 Math.Ceiling(Double) el 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 a que 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 a componente fraccionario de.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 método Floor(Double) , 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 Ceiling el método a cualquiera de las funciones de conversión integralo si el valor Double devuelto Ceiling por 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:

Se aplica a