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

C#のTimeSpan.FromDays()メソッドは、指定した日数を表すTimeSpanオブジェクトを返す静的メソッドです。引数にはdouble型の日数を渡し、最も近いミリ秒単位まで正確に処理されます。小数点以下の値や負の値も指定できるため、柔軟な時間間隔の生成が可能です。

構文

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

public static TimeSpan FromDays (double val);

パラメータ「val」には日数をdouble型で指定します。たとえば0.5を渡せば半日（12時間）を表すTimeSpanが得られます。

使用例1

まずは基本的な使用例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        TimeSpan span1 = new TimeSpan(5, 25, 0);
        TimeSpan span2 = new TimeSpan(1, 10, 0);
        TimeSpan span3 = TimeSpan.FromDays(43.999999);
        Console.WriteLine("TimeSpan1 = "+span1);
        Console.WriteLine("TimeSpan2 = "+span2);
        Console.WriteLine("TimeSpan3 = "+span3);
        Console.WriteLine("Result (Comparison of span1 and span2) = "+TimeSpan.Compare(span1, span2));
    }
}

実行結果

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

TimeSpan1 = 05:25:00
TimeSpan2 = 01:10:00
TimeSpan3 = 43.23:59:59.9140000
Result (Comparison of span1 and span2) = 1

この例では、TimeSpan.FromDays(43.999999)によって約44日分の時間間隔が生成されています。ミリ秒単位の精度で処理されるため、結果は「43.23:59:59.9140000」と表示されます。また、TimeSpan.Compare()メソッドは2つのTimeSpanを比較し、最初の引数の方が大きければ「1」を返します。

使用例2

続いて、負の値や非常に小さい値を扱う別の例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        TimeSpan span1 = new TimeSpan(-3, 15, 0);
        TimeSpan span2 = new TimeSpan(-2, 05, 10);
        TimeSpan span3 = TimeSpan.FromDays(0.000323456);
        Console.WriteLine("TimeSpan1 = "+span1);
        Console.WriteLine("TimeSpan2 = "+span2);
        Console.WriteLine("TimeSpan3 = "+span3);
        Console.WriteLine("Result (Comparison of span1 and span2) = "+TimeSpan.Compare(span1, span2));
        Console.WriteLine("Result (Comparison of span2 and span3) = "+TimeSpan.Compare(span2, span3));
    }
}

実行結果

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

TimeSpan1 = -02:45:00
TimeSpan2 = -01:54:50
TimeSpan3 = 00:00:27.9470000
Result (Comparison of span1 and span2) = -1
Result (Comparison of span2 and span3) = -1

このように、TimeSpan.FromDays()メソッドを使えば、0.000323456日（約27.947秒）といった細かい時間間隔も簡単に生成できます。負の値を指定すれば過去方向の時間間隔も表現でき、TimeSpan.Compare()との組み合わせにより、大小関係の判定も直感的に行えます。