C# TimeSpanのSecondsとTotalSecondsの違いとは？使い分けを解説

C#のTimeSpan構造体には、時間間隔を扱うためのさまざまなプロパティが用意されています。その中でもSecondsとTotalSecondsは名前が似ているため混同されやすいのですが、両者はまったく異なる値を返します。

SecondsとTotalSecondsの基本的な違い

• Seconds：TimeSpanが表す時間のうち、「秒の成分（0〜59）」だけを取り出すプロパティです。日・時・分などの要素は含まれません。
• TotalSeconds：日・時・分・秒などすべての要素を合計し、秒単位に換算した値（double型）を返します。

それでは、まずSecondsの動作を確認してみましょう。

例：Secondsプロパティを使う

using System;
using System.Linq;
public class Demo {
    public static void Main() {
        TimeSpan ts = new TimeSpan(0, 100, 0, 20, 0);
        // 秒の成分を表示
        Console.WriteLine(ts.Seconds);
    }
}

出力結果

20

この例では、new TimeSpan(0, 100, 0, 20, 0)という「100時間20分0秒」の時間間隔を作成しています。Secondsは秒の部分である「20」だけを返していることがわかります。

次に、同じTimeSpanの値に対してTotalSecondsを使った場合を見てみましょう。

例：TotalSecondsプロパティを使う

using System;
using System.Linq;
public class Demo {
    public static void Main() {
        TimeSpan ts = new TimeSpan(0, 100, 0, 20, 0);
        // 全体を秒に換算して表示
        Console.WriteLine(ts.TotalSeconds);
    }
}

出力結果

360020

今度は「360020」という大きな数値が返されました。これは100時間×3600秒＋20分×60秒＋0秒＝360000＋1200＋20＝360020秒という計算結果で、時間間隔全体を秒単位に換算した値です。

最後に、両方のプロパティを同じプログラムで実行して違いを比較してみます。

例：SecondsとTotalSecondsを同時に使う

using System;
using System.Linq;
public class Demo {
    public static void Main() {
        TimeSpan ts = new TimeSpan(0, 100, 0, 20, 0);
        // 秒の成分
        Console.WriteLine(ts.Seconds);
        // 全体を秒に換算した値
        Console.WriteLine(ts.TotalSeconds);
    }
}

出力結果

20
360020

まとめ

このように、Secondsは時間の「一部」を表すのに対し、TotalSecondsは時間全体を秒に変換した値を返します。処理時間の計測や時間の演算を行う場合はTotalSecondsが便利で、表示目的で秒の部分だけが必要な場合にはSecondsを使用する、といった使い分けができます。