DateTimeOffset.Subtraction Operator (DateTimeOffset, DateTimeOffset)

.NET Framework (current version)
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

equivalentCodeEntityM:System.DateTimeOffset.Subtract(System.DateTimeOffset,System.DateTimeOffset)

Subtracts one DateTimeOffset object from another and yields a time interval.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

C#
C++
F#
VB
Copy 
public static TimeSpan operator -(
	DateTimeOffset left,
	DateTimeOffset right
)

Parameters

left
Type: System.DateTimeOffset

The minuend.

right
Type: System.DateTimeOffset

The subtrahend.

Return Value

Type: System.TimeSpan

An object that represents the difference between left and right.

The Subtraction method defines the subtraction operation for DateTimeOffset objects. It enables code such as the following:

C#
VB
Copy 
DateTimeOffset firstDate = new DateTimeOffset(2008, 3, 25, 18, 0, 0, 
                                              new TimeSpan(-7, 0, 0));
DateTimeOffset secondDate = new DateTimeOffset(2008, 3, 25, 18, 0, 0, 
                                               new TimeSpan(-5, 0, 0));
DateTimeOffset thirdDate = new DateTimeOffset(2008, 2, 28, 9, 0, 0, 
                                              new TimeSpan(-7, 0, 0));
TimeSpan difference;

difference = firstDate - secondDate;
Console.WriteLine("({0}) - ({1}): {2} days, {3}:{4:d2}", 
                  firstDate.ToString(), 
                  secondDate.ToString(), 
                  difference.Days, 
                  difference.Hours, 
                  difference.Minutes);      

difference = firstDate - thirdDate;
Console.WriteLine("({0}) - ({1}): {2} days, {3}:{4:d2}", 
                  firstDate.ToString(), 
                  secondDate.ToString(), 
                  difference.Days, 
                  difference.Hours, 
                  difference.Minutes); 
// The example produces the following output:
//    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 0 days, 2:00
//    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 26 days, 9:00

Languages that do not support custom operators and operator overloading can call the DateTimeOffset.Subtract(DateTimeOffset) method instead.

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: