C#のMath.Ceiling()メソッドとは？切り上げ処理の使い方とサンプルコード

C#のMath.Ceiling()メソッドは、指定した数値以上となる最小の整数値を返すメソッドです。いわゆる「切り上げ」処理を行いたい場合に使用され、decimal型とdouble型の両方に対応しています。

構文

Math.Ceiling()メソッドの構文は以下の通りです。

public static decimal Ceiling(decimal val);
public static double Ceiling(double val);

1つ目の構文では引数 val にdecimal型の数値を指定し、戻り値もdecimal型となります。2つ目の構文では引数 val にdouble型の数値を指定し、戻り値はdouble型になります。

使用例1：decimal型の場合

まずはdecimal型の値に対してMath.Ceiling()メソッドを使用する例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        decimal val1 = 9.99M;
        decimal val2 = -5.10M;
        Console.WriteLine("Result = " + Math.Ceiling(val1));
        Console.WriteLine("Result = " + Math.Ceiling(val2));
    }
}

出力結果

上記のコードを実行すると、以下のような出力が得られます。

Result = 10
Result = -5

9.99は切り上げられて10になり、負の値である-5.10は「指定した数値以上の最小の整数」である-5が返される点に注目してください。つまり、負の数の場合でも「ゼロ方向への切り上げ」とは異なり、あくまでその数値以上で最も近い整数が返されます。

使用例2：double型の場合

続いて、double型の値に対してMath.Ceiling()メソッドを使用する例です。

using System;
public class Demo {
    public static void Main(){
        double val1 = 3.1;
        double val2 = 55.99;
        double val3 = -55.99;
        Console.WriteLine("Result = " + Math.Ceiling(val1));
        Console.WriteLine("Result = " + Math.Ceiling(val2));
        Console.WriteLine("Result = " + Math.Ceiling(val3));
    }
}

出力結果

このコードを実行すると、次の出力が得られます。

Result = 4
Result = 56
Result = -55

3.1は4に、55.99は56に切り上げられました。一方、-55.99に対しては-55が返されています。これは、-55.99以上の整数の中で最小のものが-55だからです。

まとめ

Math.Ceiling()メソッドは、正の数・負の数に関わらず「指定した数値以上の最小の整数値」を返します。小数点以下の切り上げ処理を行う際には、Math.Floor()（切り捨て）やMath.Round()（四捨五入）との違いを理解しておくと、意図した計算結果を得やすくなります。