This documentation is archived and is not being maintained.

DateTimeOffset.Addition Operator

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.

ExceptionCondition
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.

.NET Framework

Supported in: 4, 3.5 SP1, 3.0 SP1, 2.0 SP1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: