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

C#のDateTimeOffset.AddMonths()メソッドは、現在のDateTimeOffsetインスタンスの日付に指定した月数を加算するためのメソッドです。負の値を指定すれば、月を減算することも可能です。

基本仕様

このメソッドは、元のDateTimeOffsetオブジェクトの値を変更せずに、新しいDateTimeOffsetオブジェクトを返します（イミutableな設計）。時刻部分やUTCオフセットはそのまま維持されます。

構文

以下がAddMonths()メソッドの構文です。

public DateTimeOffset AddMonths (int val);

パラメータvalには加算する月数を指定します。月を減算したい場合は、負の値を設定してください。

サンプルコード1：月を加算する

まずは、3か月を加算する基本的な例を見てみましょう。

using System;
public class Demo {
    public static void Main() {
        DateTimeOffset dateTimeOffset = new DateTimeOffset(2019, 08, 10, 4, 20, 10, new TimeSpan(-5, 0, 0));
        Console.WriteLine("DateTimeOffset (before adding months) = {0}", dateTimeOffset);
        DateTimeOffset res = dateTimeOffset.AddMonths(3);
        Console.WriteLine("DateTimeOffset (after adding months) = {0}", res);
    }
}

実行結果

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

DateTimeOffset (before adding months) = 8/10/2019 4:20:10 AM -05:00
DateTimeOffset (after adding months) = 11/10/2019 4:20:10 AM -05:00

2019年8月10日に3か月を加算した結果、2019年11月10日になっていることが確認できます。時刻とオフセット（-05:00）は変化していません。

サンプルコード2：月を減算する

次に、負の値を渡して月を減算する例を見てみましょう。

using System;
public class Demo {
    public static void Main() {
        DateTimeOffset dateTimeOffset = new DateTimeOffset(2019, 08, 10, 4, 20, 10, new TimeSpan(-5, 0, 0));
        Console.WriteLine("DateTimeOffset (before subtracting months) = {0}", dateTimeOffset);
        DateTimeOffset res = dateTimeOffset.AddMonths(-5);
        Console.WriteLine("DateTimeOffset (after subtracting months) = {0}", res);
    }
}

実行結果

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

DateTimeOffset (before subtracting months) = 8/10/2019 4:20:10 AM -05:00
DateTimeOffset (after subtracting months) = 3/10/2019 4:20:10 AM -05:00

2019年8月10日から5か月を減算した結果、2019年3月10日となっています。

注意点

• AddMonths()は元のインスタンスを変更しないため、必ず戻り値を受け取って使用します。
• 月末の日付に対して加算・減算を行った場合、結果の日が存在しないときは自動的に調整されます（例：1月31日に1か月加算すると2月28日または29日になる）。
• 引数に範囲外の値を指定した場合、ArgumentOutOfRangeExceptionがスローされることがあります。