DateTime::Subtract Method (TimeSpan)
Subtracts the specified duration from this instance.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
- Type: System::TimeSpan
The time interval to subtract.
Return Value
Type: System::DateTimeAn object that is equal to the date and time represented by this instance minus the time interval represented by value.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The result is less than DateTime::MinValue or greater than DateTime::MaxValue. |
This method does not change the value of this DateTime. Instead, a new DateTime is returned whose value is the result of this operation.
Ordinarily, the DateTime::Subtract(TimeSpan) method subtracts a TimeSpan object that represents a positive time span and returns a DateTime value that is earlier than the date and time of the current instance. However, if the TimeSpan object represents a negative time span, the DateTime::Subtract(TimeSpan) method returns a DateTime value that is later than the date and time of the current instance.
The DateTime::Subtract(TimeSpan) method allows you to subtract a time interval that consists of more than one unit of time (such as a given number of hours and a given number of minutes). To subtract a single unit of time (such as years, months, or days) from the DateTime instance, you can pass a negative numeric value as a parameter to any of the following methods:
AddYears, to subtract a specific number of years from the current date and time instance.
AddMonths, to subtract a specific number of months from the current date and time instance.
AddDays, to subtract a specific number of days from the current date and time instance.
AddHours, to subtract a specific number of hours from the current date and time instance.
AddMinutes, to subtract a specific number of minutes from the current date and time instance.
AddSeconds, to subtract a specific number of seconds from the current date and time instance.
AddMilliseconds, to subtract a specific number of milliseconds from the current date and time instance.
AddTicks, to subtract a specific number of ticks from the current date and time instance.
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.