DateTimeOffset.Addition(DateTimeOffset, TimeSpan) DateTimeOffset.Addition(DateTimeOffset, TimeSpan) DateTimeOffset.Addition(DateTimeOffset, TimeSpan) Operator

Definition

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.

public:
 static DateTimeOffset operator +(DateTimeOffset dateTimeTz, TimeSpan timeSpan);
public static DateTimeOffset operator + (DateTimeOffset dateTimeTz, TimeSpan timeSpan);
static member ( + ) : DateTimeOffset * TimeSpan -> DateTimeOffset

Parameters

dateTimeOffset
DateTimeOffset DateTimeOffset DateTimeOffset

The object to add the time interval to.

timeSpan
TimeSpan TimeSpan TimeSpan

The time interval to add.

Returns

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

Exceptions

The resulting DateTimeOffset value is less than MinValue.

-or-

The resulting DateTimeOffset value is greater than MaxValue.

Remarks

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     
Dim date1 As New DateTimeOffset(#1/1/2008 1:32:45PM#, _
             New TimeSpan(-5, 0, 0)) 
Dim interval1 As New TimeSpan(202, 3, 30, 0)
Dim interval2 As New TimeSpan(5, 0, 0, 0)      
Dim date2 As DateTimeOffset 

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.

The equivalent method for this operator is DateTimeOffset.Add(TimeSpan).

Applies to

See also