Artigo
11/18/2011

DateTimeOffset.Addition Operator

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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)

Syntax

'Declaration
Public Shared Operator + ( _
    dateTimeOffset As DateTimeOffset, _
    timeSpan As TimeSpan _
) As DateTimeOffset

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

Parameters

dateTimeOffset
Type: System.DateTimeOffset
The object to add a 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 dateTimeOffset and timeSpan.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	The resulting DateTimeOffset value is less than MinValue. -or- The resulting DateTimeOffset value is greater than MaxValue.

ArgumentOutOfRangeException

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:

Dim date1 As New DateTimeOffset(#1/1/2008 1:32:45 PM#, _
             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

outputBlock.Text &= date1.ToString() & vbCrLf         ' Displays 1/1/2008 1:32:45 PM -05:00
date2 = date1 + interval1
outputBlock.Text &= date2.ToString() & vbCrLf         ' Displays 7/21/2008 5:02:45 PM -05:00
date2 += interval2
outputBlock.Text &= date2.ToString() & vbCrLf         ' Displays 7/26/2008 5:02:45 PM -05:00

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;

outputBlock.Text += date1 + "\n";         // Displays 1/1/2008 1:32:45 PM -05:00
date2 = date1 + interval1;
outputBlock.Text += date2 + "\n";         // Displays 7/21/2008 5:02:45 PM -05:00
date2 += interval2;
outputBlock.Text += date2 + "\n";         // 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.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Compartilhar via