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);

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

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

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

See also