C#のTimeSpan.Add()メソッドの使い方を徹底解説！サンプルコード付き

C#におけるTimeSpan.Add()メソッドは、指定したTimeSpanオブジェクトと現在のインスタンスの値を合計した、新しいTimeSpanオブジェクトを返すメソッドです。時間間隔の加算処理を行いたい場合に便利な機能で、元のインスタンス自体は変更されず、計算結果が新しいオブジェクトとして返される点が特徴です。

構文

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

public TimeSpan Add (TimeSpan span);

パラメータ「span」には、加算する対象となる時間間隔（TimeSpan）を指定します。戻り値としては、両者の値を合計した新しいTimeSpanオブジェクトが返されます。

基本的な使用例

まずは、複数のTimeSpanオブジェクトをAdd()メソッドで加算する基本的な例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        TimeSpan span1 = new TimeSpan(2, 17, 20, 30);
        TimeSpan span2 = new TimeSpan(3, 18, 25, 25);
        TimeSpan span3 = new TimeSpan(-8, 30, 0);
        TimeSpan res1 = span1.Add(span2);
        TimeSpan res2 = span2.Add(span3);
        Console.WriteLine("Final Timespan (TimeSpan1 + TimeSpan2) = "+res1);
        Console.WriteLine("Final Timespan (TimeSpan2 + TimeSpan3) = "+res2);
    }
}

実行結果

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

Final Timespan (TimeSpan1 + TimeSpan2) = 6.11:45:55
Final Timespan (TimeSpan2 + TimeSpan3) = 3.10:55:25

この例では、span1（2日17時間20分30秒）にspan2（3日18時間25分25秒）を加算すると「6.11:45:55」となり、またspan2に負の値を持つspan3（-8時間30分）を加算すると「3.10:55:25」になります。このように、負のTimeSpanも問題なく扱えるのがAdd()メソッドの利点です。

MinValueを使用した応用例

次に、TimeSpan.MinValue（TimeSpanが表現できる最小値）を使った例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        TimeSpan span1 = new TimeSpan(-6, 25, 0);
        TimeSpan span2 = new TimeSpan(1, 11, 25, 20);
        TimeSpan span3 = TimeSpan.MinValue;
        TimeSpan res1 = span1.Add(span2);
        TimeSpan res2 = span2.Add(span3);
        Console.WriteLine("Final Timespan (TimeSpan1 + TimeSpan2) = "+res1);
        Console.WriteLine("Final Timespan (TimeSpan2 + TimeSpan3) = "+res2);
    }
}

実行結果

このプログラムを実行すると、以下の出力が得られます。

Final Timespan (TimeSpan1 + TimeSpan2) = 1.05:50:20
Final Timespan (TimeSpan2 + TimeSpan3) = -10675197.15:22:45.4775808

2つ目の計算では、span2にTimeSpan.MinValueを加算しているため、結果がTimeSpanが表現できる最小値「-10675197.15:22:45.4775808」になっています。これは、加算結果がTimeSpan型の範囲（約±10,675,199日）を超えた場合でも、例外がスローされずに飽和した値が返されることを示しています。

まとめ

• TimeSpan.Add()メソッドは、指定したTimeSpanと現在のインスタンスを合計した新しいTimeSpanを返す
• 元のインスタンスは変更されない（イミュータブルな操作）
• 負の時間間隔やTimeSpan.MinValueなども正しく処理できる

時間の加算処理が必要な場面では、演算子「+」を使う方法もありますが、Add()メソッドを使うことで意図が明確になり、可読性の高いコードを書くことができます。