DateTimeOffset.Subtraction Operator (DateTimeOffset, DateTimeOffset)

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

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

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:

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.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5 SP1, 3.0 SP1, 2.0 SP1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft