Difference between TimeSpan Seconds() and TotalSeconds()

The TimeSpan.Seconds property returns only the seconds component of a time span, whereas TimeSpan.TotalSeconds property converts the entire time duration into seconds. Understanding this difference is crucial when working with time calculations in C#.

Syntax

Following is the syntax for accessing the seconds component −

TimeSpan ts = new TimeSpan(days, hours, minutes, seconds, milliseconds);
int seconds = ts.Seconds;

Following is the syntax for getting total seconds −

TimeSpan ts = new TimeSpan(days, hours, minutes, seconds, milliseconds);
double totalSeconds = ts.TotalSeconds;

How It Works

Using TimeSpan.Seconds Property

The Seconds property returns only the seconds component (0-59) from the time span −

using System;

public class Demo {
    public static void Main() {
        TimeSpan ts = new TimeSpan(0, 1, 40, 20, 0);
        Console.WriteLine("Hours: " + ts.Hours);
        Console.WriteLine("Minutes: " + ts.Minutes);
        Console.WriteLine("Seconds: " + ts.Seconds);
    }
}

The output of the above code is −

Hours: 1
Minutes: 40
Seconds: 20

Using TimeSpan.TotalSeconds Property

The TotalSeconds property converts the entire time duration into seconds −

using System;

public class Demo {
    public static void Main() {
        TimeSpan ts = new TimeSpan(0, 1, 40, 20, 0);
        Console.WriteLine("Total seconds: " + ts.TotalSeconds);
        Console.WriteLine("Calculation: (1×3600) + (40×60) + 20 = " + ((1*3600) + (40*60) + 20));
    }
}

The output of the above code is −

Total seconds: 6020
Calculation: (1×3600) + (40×60) + 20 = 6020

Comparison Example

Here is a direct comparison showing both properties with the same TimeSpan value −

using System;

public class Demo {
    public static void Main() {
        TimeSpan ts1 = new TimeSpan(0, 2, 30, 45, 0);
        TimeSpan ts2 = new TimeSpan(0, 0, 0, 45, 0);
        
        Console.WriteLine("TimeSpan 1: 2 hours, 30 minutes, 45 seconds");
        Console.WriteLine("Seconds component: " + ts1.Seconds);
        Console.WriteLine("Total seconds: " + ts1.TotalSeconds);
        
        Console.WriteLine("\nTimeSpan 2: 0 hours, 0 minutes, 45 seconds");
        Console.WriteLine("Seconds component: " + ts2.Seconds);
        Console.WriteLine("Total seconds: " + ts2.TotalSeconds);
    }
}

The output of the above code is −

TimeSpan 1: 2 hours, 30 minutes, 45 seconds
Seconds component: 45
Total seconds: 9045

TimeSpan 2: 0 hours, 0 minutes, 45 seconds
Seconds component: 45
Total seconds: 45

Key Differences

Conclusion

The Seconds property extracts only the seconds component (0-59) from a TimeSpan, while TotalSeconds converts the entire time duration into seconds. Use Seconds when you need the time component, and TotalSeconds when you need the total duration in seconds.