C#のDateTime.AddMinutes()メソッドの使い方を徹底解説

C#のDateTime.AddMinutes()メソッドは、現在のDateTimeインスタンスの値に指定した分数を加算するためのメソッドです。戻り値として、計算後の新しいDateTimeオブジェクトが返されます。元のDateTimeインスタンス自体は変更されない（イミュータブルである）点に注意してください。

構文

AddMinutes()メソッドの構文は以下のとおりです。

public DateTime AddMinutes (double m);

引数 m には加算する分数をdouble型で指定します。負の値を指定した場合は、その分だけ時刻が減算されます。また、加算結果が有効な日付範囲（0001年1月1日〜9999年12月31日）を超えた場合には、ArgumentOutOfRangeExceptionがスローされる点にも留意しましょう。

使用例1：分を加算する

まずは、DateTime.AddMinutes()メソッドを使って分を加算する基本的な例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        DateTime d1 = new DateTime(2019, 09, 10, 5, 15, 25);
        DateTime d2 = d1.AddMinutes(25);
        System.Console.WriteLine("Initial DateTime = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ", d1);
        System.Console.WriteLine("\nNew DateTime (After adding minutes) = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ", d2);
    }
}

出力

このプログラムを実行すると、以下のような結果が出力されます。

Initial DateTime = 10 September 2019, 05:15:25
New DateTime (After adding minutes) = 10 September 2019, 05:40:25

この例では、初期値「2019年9月10日 5時15分25秒」に対して25分を加算しているため、「5時40分25秒」という新しいDateTimeが取得できています。

使用例2：負の値で分を減算する

次に、負の値を渡して分を減算する例を確認しましょう。

using System;
public class Demo {
    public static void Main(){
        DateTime d1 = new DateTime(2019, 09, 10, 5, 15, 25);
        DateTime d2 = d1.AddMinutes(-15);
        System.Console.WriteLine("Initial DateTime = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ", d1);
        System.Console.WriteLine("\nNew DateTime (After subtracting minutes) = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ", d2);
    }
}

出力

実行結果は以下のとおりです。

Initial DateTime = 10 September 2019, 05:15:25
New DateTime (After subtracting minutes) = 10 September 2019, 05:00:25

このように、-15という負の値を指定することで、15分前の時刻「5時00分25秒」が得られます。

まとめ

DateTime.AddMinutes()メソッドを使えば、日時に簡単に分単位の加算・減算を行うことができます。正の値で加算、負の値で減算というシンプルな仕様であり、時間計算が必要なアプリケーション開発において非常に便利なメソッドです。同様の用途にはAddHours()やAddDays()などの関連メソッドも用意されているため、目的に応じて使い分けるとよいでしょう。