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 dateTimeOffset, TimeSpan timeSpan);
public:
 static DateTimeOffset operator +(DateTimeOffset dateTimeTz, TimeSpan timeSpan);
public static DateTimeOffset operator + (DateTimeOffset dateTimeOffset, TimeSpan timeSpan);
public static DateTimeOffset operator + (DateTimeOffset dateTimeTz, TimeSpan timeSpan);
static member ( + ) : DateTimeOffset * TimeSpan -> DateTimeOffset
static member ( + ) : DateTimeOffset * TimeSpan -> DateTimeOffset
Public Shared Operator + (dateTimeOffset As DateTimeOffset, timeSpan As TimeSpan) As DateTimeOffset
Public Shared Operator + (dateTimeTz As DateTimeOffset, timeSpan As TimeSpan) As DateTimeOffset

Parameters

dateTimeOffsetdateTimeTz
DateTimeOffset

The object to add the time interval to.

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 DateTimeOffset.MinValue.

-or-

The resulting DateTimeOffset value is greater than DateTimeOffset.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
let date1 =
    DateTimeOffset(2008, 1, 1, 13, 32, 45, TimeSpan(-5, 0, 0))

let interval1 = TimeSpan(202, 3, 30, 0)
let interval2 = TimeSpan(5, 0, 0, 0)

printfn $"{date1}" // Displays 1/1/2008 1:32:45 PM -05:00
let date2 = date1 + interval1
printfn $"{date2}" // Displays 7/21/2008 5:02:45 PM -05:00
let date2 = date2 + interval2
printfn $"{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