TimeSpan.Add Method (TimeSpan)
.NET Framework (current version)
Returns a new TimeSpan object whose value is the sum of the specified TimeSpan object and this instance.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- ts
-
Type:
System.TimeSpan
The time interval to add.
Return Value
Type: System.TimeSpanA new object that represents the value of this instance plus the value of ts.
| Exception | Condition |
|---|---|
| OverflowException | The resulting TimeSpan is less than TimeSpan.MinValue or greater than TimeSpan.MaxValue. |
The return value must be between TimeSpan.MinValue and TimeSpan.MaxValue; otherwise, an exception is thrown.
The return value is a new TimeSpan; the original TimeSpan is not modified.
The following example calls the Add method to add each element in an array of time intervals to a base TimeSpan value.
using System; public class Example { public static void Main() { TimeSpan baseTimeSpan = new TimeSpan(1, 12, 15, 16); // Create an array of timespan intervals. TimeSpan[] intervals = { TimeSpan.FromDays(1.5), TimeSpan.FromHours(1.5), TimeSpan.FromMinutes(45), TimeSpan.FromMilliseconds(505), new TimeSpan(1, 17, 32, 20), new TimeSpan(-8, 30, 0) }; // Calculate a new time interval by adding each element to the base interval. foreach (var interval in intervals) Console.WriteLine(@"{0,-10:g} {3} {1,15:%d\:hh\:mm\:ss\.ffff} = {2:%d\:hh\:mm\:ss\.ffff}", baseTimeSpan, interval, baseTimeSpan.Add(interval), interval < TimeSpan.Zero ? "-" : "+"); } } // The example displays the following output: // 1:12:15:16 + 1:12:00:00.0000 = 3:00:15:16.0000 // 1:12:15:16 + 0:01:30:00.0000 = 1:13:45:16.0000 // 1:12:15:16 + 0:00:45:00.0000 = 1:13:00:16.0000 // 1:12:15:16 + 0:00:00:00.5050 = 1:12:15:16.5050 // 1:12:15:16 + 1:17:32:20.0000 = 3:05:47:36.0000 // 1:12:15:16 - 0:07:30:00.0000 = 1:04:45:16.0000
Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Show: