This documentation is archived and is not being maintained.
TimeSpan::Negate Method
Visual Studio 2010
Returns a new TimeSpan object whose value is the negated value of this instance.
Assembly: mscorlib (in mscorlib.dll)
Return Value
Type: System::TimeSpanA new object with the same numeric value as this instance, but with the opposite sign.
| Exception | Condition |
|---|---|
| OverflowException | The negated value of this instance cannot be represented by a TimeSpan; that is, the value of this instance is MinValue. |
The following example applies the Negate method to several TimeSpan objects.
// Example of the TimeSpan::Duration( ) and TimeSpan::Negate( ) methods, // and the TimeSpan Unary Negation and Unary Plus operators. using namespace System; const __wchar_t * protoFmt = L"{0,22}{1,22}{2,22}"; void ShowDurationNegate( TimeSpan interval ) { // Display the TimeSpan value and the results of the // Duration and Negate methods. Console::WriteLine( gcnew String( protoFmt ), interval, interval.Duration(), interval.Negate() ); } int main() { Console::WriteLine( "This example of TimeSpan::Duration( ), " "TimeSpan::Negate( ), \nand the TimeSpan Unary " "Negation and Unary Plus operators \n" "generates the following output.\n" ); Console::WriteLine( gcnew String( protoFmt ), "TimeSpan", "Duration( )", "Negate( )" ); Console::WriteLine( gcnew String( protoFmt ), "--------", "-----------", "---------" ); // Create TimeSpan objects and apply the Unary Negation // and Unary Plus operators to them. ShowDurationNegate( TimeSpan(1) ); ShowDurationNegate( TimeSpan( -1234567) ); ShowDurationNegate( +TimeSpan(0,0,10,-20,-30) ); ShowDurationNegate( +TimeSpan(0,-10,20,-30,40) ); ShowDurationNegate( -TimeSpan(1,10,20,40,160) ); ShowDurationNegate( -TimeSpan( -10,-20,-30,-40,-50) ); } /* This example of TimeSpan::Duration( ), TimeSpan::Negate( ), and the TimeSpan Unary Negation and Unary Plus operators generates the following output. TimeSpan Duration( ) Negate( ) -------- ----------- --------- 00:00:00.0000001 00:00:00.0000001 -00:00:00.0000001 -00:00:00.1234567 00:00:00.1234567 00:00:00.1234567 00:09:39.9700000 00:09:39.9700000 -00:09:39.9700000 -09:40:29.9600000 09:40:29.9600000 09:40:29.9600000 -1.10:20:40.1600000 1.10:20:40.1600000 1.10:20:40.1600000 10.20:30:40.0500000 10.20:30:40.0500000 -10.20:30:40.0500000 */
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: