DateTimeOffset.Addition Operator (DateTimeOffset, TimeSpan)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

equivalentCodeEntityM:System.DateTimeOffset.Add(System.DateTimeOffset,System.TimeSpan)

Adds a specified time interval to a DateTimeOffset object that has a specified date and time, and yields a DateTimeOffset object that has new a date and time.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public static DateTimeOffset operator +(
	DateTimeOffset dateTimeOffset,
	TimeSpan timeSpan
)

Parameters

dateTimeOffset
Type: System.DateTimeOffset

The object to add the time interval to.

timeSpan
Type: System.TimeSpan

The time interval to add.

Return Value

Type: System.DateTimeOffset

An object whose value is the sum of the values of dateTimeTz and timeSpan.

Exception Condition
ArgumentOutOfRangeException

The resulting DateTimeOffset value is less than MinValue.

-or-

The resulting DateTimeOffset value is greater than MaxValue.

The Addition method defines the addition operation for DateTimeOffset values. It enables code such as the following:

DateTimeOffset date1 = new DateTimeOffset(2008, 1, 1, 13, 32, 45, 
                       new TimeSpan(-5, 0, 0)); 
TimeSpan interval1 = new TimeSpan(202, 3, 30, 0);
TimeSpan interval2 = new TimeSpan(5, 0, 0, 0);      
DateTimeOffset date2; 

Console.WriteLine(date1);         // Displays 1/1/2008 1:32:45 PM -05:00
date2 = date1 + interval1;
Console.WriteLine(date2);         // Displays 7/21/2008 5:02:45 PM -05:00
date2 += interval2;
Console.WriteLine(date2);         // Displays 7/26/2008 5:02:45 PM -05:00     

Languages that do not support custom operators and operator overloading can call the Add method instead.

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
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
Return to top
Show: