{"id":1846,"date":"2023-05-15T14:12:35","date_gmt":"2023-05-15T07:12:35","guid":{"rendered":"https:\/\/csharptutorial.net\/?page_id=1846"},"modified":"2023-05-22T06:55:42","modified_gmt":"2023-05-21T23:55:42","slug":"csharp-timespan","status":"publish","type":"page","link":"https:\/\/www.csharptutorial.net\/csharp-tutorial\/csharp-timespan\/","title":{"rendered":"C# TimeSpan"},"content":{"rendered":"\n

Summary<\/strong>: in this tutorial, you’ll learn how to use the C# TimeSpan<\/code> to represent a time interval.<\/p>\n\n\n\n

Introduction to the C# TimeSpan type<\/h2>\n\n\n\n

The TimeSpan<\/code> represents a time interval or time duration. In practice, you use a TimeSpan<\/code> to represent the difference between two dates (DateTime<\/a><\/code>). For example:<\/p>\n\n\n

using<\/span> static<\/span> System.Console;\n\nvar<\/span> start = new<\/span> DateTime(2023<\/span>, 5<\/span>, 15<\/span>, 10<\/span>, 0<\/span>, 0<\/span>);\nvar<\/span> end = new<\/span> DateTime(2023<\/span>, 5<\/span>, 15<\/span>, 10<\/span>, 30<\/span>, 0<\/span>);\n\nvar<\/span> duration = end - start;\n\nWriteLine(duration); \/\/ 00:30:00<\/span><\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
In this example, we initialize the start<\/code> and end<\/code> variables and calculate the difference between end<\/code> and start<\/code>. The result is a TimeSpan<\/code> that represents a duration of 30 minutes.<\/p>\n\n\n\n
Creating a TimeSpan objects<\/h2>\n\n\n\n
To create a TimeSpan<\/code> object, you use its constructor. The TimeSpan<\/code> constructor has some overloads: <\/p>\n\n\n
TimeSpan()\nTimeSpan(int<\/span> hours, int<\/span> minutes, int<\/span> seconds)\nTimeSpan(int<\/span> days, int<\/span> hours, int<\/span> minutes, int<\/span> seconds)\nTimeSpan(int<\/span> days, int<\/span> hours, int<\/span> minutes, int<\/span> seconds, int<\/span> milliseconds)\nTimeSpan(long<\/span> ticks)<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
For example:<\/p>\n\n\n
using<\/span> static<\/span> System.Console;\n\n\/\/ Creates a TimeSpan object with default value (0 ticks).<\/span>\nvar<\/span> ts1 = new<\/span> TimeSpan();\nWriteLine(ts1); \/\/ 00:00:00<\/span>\n\n\n\/\/ Creates a TimeSpan object with a value of 1 hour.<\/span>\nvar<\/span> ts2 = new<\/span> TimeSpan(1<\/span>, 0<\/span>, 0<\/span>);\nWriteLine(ts2); \/\/ 01:00:00<\/span>\n\n\/\/ Creates a TimeSpan object with a value of 30 minutes.<\/span>\nvar<\/span> ts3 = new<\/span> TimeSpan(0<\/span>, 30<\/span>, 0<\/span>);\nWriteLine(ts3); \/\/ 00:30:00<\/span>\n\n\/\/ Creates a TimeSpan object with a value<\/span>\n\/\/ of 2 hours, 30 minutes and 10 seconds.<\/span>\nvar<\/span> ts4 = new<\/span> TimeSpan(2<\/span>, 30<\/span>, 10<\/span>);\nWriteLine(ts4); \/\/ 02:30:10<\/span><\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n
00<\/span>:00<\/span>:00<\/span>\n01<\/span>:00<\/span>:00<\/span>\n00<\/span>:30<\/span>:00<\/span>\n02<\/span>:30<\/span>:10<\/span><\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Accessing the C# TimeSpan properties<\/h2>\n\n\n\n
The TimeSpan<\/code> class provides several read-only properties to retrieve the components of a TimeSpan<\/code> object:<\/p>\n\n\n
using<\/span> static<\/span> System.Console;\n\nvar<\/span> timeSpan = new<\/span> TimeSpan(7<\/span>, 2<\/span>, 30<\/span>, 45<\/span>, 750<\/span>);\n\n\/\/ Retrieving the days <\/span>\nvar<\/span> days = timeSpan.Days;\nWriteLine(days);\n\n\/\/ Retrieving the hours <\/span>\nvar<\/span> hours = timeSpan.Hours;\nWriteLine(hours);\n\n\/\/ Retrieving the minutes <\/span>\nvar<\/span> minutes = timeSpan.Minutes;\nWriteLine(minutes);\n\n\/\/ Retrieving the seconds <\/span>\nvar<\/span> seconds = timeSpan.Seconds;\nWriteLine(seconds);\n\n\/\/ Retrieving the milliseconds <\/span>\nvar<\/span> milliseconds = timeSpan.Milliseconds;\nWriteLine(milliseconds);\n\n\/\/ Retrieving the total number of days<\/span>\nvar<\/span> totalDays = timeSpan.TotalDays;\nWriteLine(totalDays);\n\n\/\/ Retrieving the total number of hours<\/span>\nvar<\/span> totalHours = timeSpan.TotalHours;\nWriteLine(totalHours);\n\n\/\/ Retrieving the total number of minutes<\/span>\nvar<\/span> totalMinutes = timeSpan.TotalMinutes;\nWriteLine(totalMinutes);\n\n\/\/ Retrieving the total number of seconds<\/span>\nvar<\/span> totalSeconds = timeSpan.TotalSeconds;\nWriteLine(totalSeconds);\n\n\/\/ Retrieving the total number of milliseconds<\/span>\nvar<\/span> totalMilliseconds = timeSpan.TotalMilliseconds;\nWriteLine(totalMilliseconds);<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n
7<\/span>\n2<\/span>\n30<\/span>\n45<\/span>\n750<\/span>\n7.104696180555556<\/span>\n170.51270833333334<\/span>\n10230.7625<\/span>\n613845.75<\/span>\n613845750<\/span><\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Getting the total time span<\/h2>\n\n\n\n
The TimeSpan<\/code> class provides various methods to get the total time span in different units like ticks, milliseconds, seconds, minutes, hours, and days. For example:<\/p>\n\n\n
using<\/span> static<\/span> System.Console;\n\n\/\/ Creates a TimeSpan object with a value of 1 day, 30 hours,<\/span>\n\/\/ 30 minutes, 30 seconds, and 500 milliseconds.<\/span>\nvar<\/span> ts = new<\/span> TimeSpan(1<\/span>, 30<\/span>, 30<\/span>, 30<\/span>, 500<\/span>);\n\n\/\/ Gets the total number of ticks.<\/span>\nvar<\/span> ticks = ts.Ticks;\nWriteLine(ticks);\n\n\/\/ Gets the total number of days.<\/span>\nvar<\/span> days = ts.Days;\nWriteLine(days);\n\n\/\/ Gets the total number of hours.<\/span>\nvar<\/span> hours = ts.Hours;\nWriteLine(hours);\n\n\/\/ Gets the total number of minutes.<\/span>\nvar<\/span> minutes = ts.Minutes;\nWriteLine(minutes);\n\n\/\/ Gets the total number of seconds.<\/span>\nvar<\/span> seconds = ts.Seconds;\nWriteLine(seconds);\n\n\/\/ Gets the total number of milliseconds.<\/span>\nvar<\/span> milliseconds = ts.Milliseconds;\nWriteLine(milliseconds);<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n
1962305000000<\/span>\n2<\/span>\n6<\/span>\n30<\/span>\n30<\/span>\n500<\/span><\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Performing arithmetic operations on C# TimeSpan<\/h2>\n\n\n\n
To perform arithmetic operations on time such as addition, subtraction, multiplication, and division, you use the respective methods of the TimeSpan<\/code> object. For example:<\/p>\n\n\n
using<\/span> static<\/span> System.Console;\n\n\/\/ Creates a TimeSpan object with a value of 1 hour.<\/span>\nvar<\/span> ts1 = new<\/span> TimeSpan(1<\/span>, 0<\/span>, 0<\/span>);\n\n\/\/ Creates a TimeSpan object with a value of 30 minutes.<\/span>\nvar<\/span> ts2 = new<\/span> TimeSpan(0<\/span>, 30<\/span>, 0<\/span>);\n\n\n\/\/ Adds ts2 to ts1.<\/span>\nvar<\/span> ts3 = ts1.Add(ts2);\nWriteLine(ts3); \/\/ 01:30:00<\/span>\n\n\/\/ Subtracts ts2 from ts1.<\/span>\nvar<\/span> ts4 = ts1.Subtract(ts2);\nWriteLine(ts4); \/\/ 00:30:00<\/span>\n\n\n\/\/ Multiplies ts1 by 2.<\/span>\nvar<\/span> ts5 = ts1.Multiply(2<\/span>);\nWriteLine(ts5); \/\/ 02:00:00<\/span>\n\nvar<\/span> ts6 = ts5.Divide(2<\/span>);\nWriteLine(ts6); \/\/ 01:00:00<\/span><\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n
01<\/span>:30<\/span>:00<\/span>\n00<\/span>:30<\/span>:00<\/span>\n02<\/span>:00<\/span>:00<\/span>\n01<\/span>:00<\/span>:00<\/span><\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Comparing C# TimeSpan object<\/h2>\n\n\n\n
The TimeSpan<\/code> class provides operator overloads like greater than >, equal =, less than <, and not equal != to compare time spans:<\/p>\n\n\n
using<\/span> static<\/span> System.Console;\n\n\/\/ Creates a TimeSpan object with a value of 1 hour.<\/span>\nvar<\/span> ts1 = new<\/span> TimeSpan(1<\/span>, 0<\/span>, 0<\/span>);\n\n\/\/ Creates a TimeSpan object with a value of 30 minutes.<\/span>\nvar<\/span> ts2 = new<\/span> TimeSpan(0<\/span>, 30<\/span>, 0<\/span>);\n\n\/\/ ts1 is greater than ts2 -> true<\/span>\nvar<\/span> result1 = ts1 > ts2;\nWriteLine(result1);\n\n\/\/ ts1 is less than ts2 -> false<\/span>\nvar<\/span> result2 = ts1 < ts2;\nWriteLine(result2);\n\n\/\/ ts1 is equal to ts2 -> false<\/span>\nvar<\/span> result3 = ts1 == ts2;\nWriteLine(result3);\n\n\/\/ ts1 is not equal to ts2 -> true<\/span>\nvar<\/span> result4 = ts1 != ts2;\nWriteLine(result4);<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n
True<\/span>\nFalse<\/span>\nFalse<\/span>\nTrue<\/span><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Summary<\/h2>\n\n\n\n
    \n
  • Use C# TimeSpan<\/code> to represent a time interval.<\/li>\n<\/ul>\n
    \n\t
    \n\t\t
    Was this tutorial helpful ?<\/div>\n\t\t
    \n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t Yes <\/span>\n\t\t\t<\/button>\n\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t No <\/span>\n\t\t\t<\/button>\n\t\t<\/div>\n\t<\/header>\n\n\t
    \n\t\t
    \n\t\t\t
    <\/div>\n\t\t\t\n\t\t\t