TimeSpan.Subtract(TimeSpan) Methode

Definitie

Naamruimte:
System
Assembly's:
mscorlib.dll, System.Runtime.dll
Assembly's:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Bron:
TimeSpan.cs
Bron:
TimeSpan.cs
Bron:
TimeSpan.cs
Bron:
TimeSpan.cs
Bron:
TimeSpan.cs

Retourneert een nieuw TimeSpan object waarvan de waarde het verschil is tussen het opgegeven TimeSpan object en dit exemplaar.

public:
 TimeSpan Subtract(TimeSpan ts);
public TimeSpan Subtract(TimeSpan ts);
member this.Subtract : TimeSpan -> TimeSpan
Public Function Subtract (ts As TimeSpan) As TimeSpan

Parameters

ts
TimeSpan

Het tijdsinterval dat moet worden afgetrokken.

Retouren

TimeSpan

Een nieuw tijdsinterval waarvan de waarde het resultaat is van de waarde van dit exemplaar minus de waarde van ts.

Uitzonderingen

OverflowException

De retourwaarde is kleiner dan TimeSpan.MinValue of groter dan TimeSpan.MaxValue.

Voorbeelden

In het volgende voorbeeld wordt de Subtract methode gebruikt om het verschil tussen één TimeSpan waarde en elk van de tijdsintervallen in een matrix te berekenen. Houd er rekening mee dat, omdat TimeSpan tekenreeksen geen negatieve tekens in de resultaattekenreeks bevatten, in het voorbeeld voorwaardelijke logica wordt gebruikt om een negatief teken met negatieve tijdsintervallen op te nemen.

TimeSpan baseTimeSpan = new TimeSpan(1, 12, 15, 16);

// Create an array of timespan intervals.
TimeSpan[] intervals = { 
   TimeSpan.FromDays(1.5), 
   TimeSpan.FromHours(1.5), 
   TimeSpan.FromMinutes(45), 
   TimeSpan.FromMilliseconds(505),
   new TimeSpan(1, 17, 32, 20), 
   new TimeSpan(-8, 30, 0) 
};

// Calculate a new time interval by adding each element to the base interval.
foreach (var interval in intervals)
   Console.WriteLine(@"{0,-10:g} - {3}{1,15:%d\:hh\:mm\:ss\.ffff} = {4}{2:%d\:hh\:mm\:ss\.ffff}",
                     baseTimeSpan, interval, baseTimeSpan.Subtract(interval),
                     interval < TimeSpan.Zero ? "-" : "",
                     baseTimeSpan < interval.Duration() ? "-" : "");

// The example displays the following output:
//       1:12:15:16 - 1:12:00:00.0000 = 0:00:15:16.0000
//       1:12:15:16 - 0:01:30:00.0000 = 1:10:45:16.0000
//       1:12:15:16 - 0:00:45:00.0000 = 1:11:30:16.0000
//       1:12:15:16 - 0:00:00:00.5050 = 1:12:15:15.4950
//       1:12:15:16 - 1:17:32:20.0000 = -0:05:17:04.0000
//       1:12:15:16 - -0:07:30:00.0000 = 1:19:45:16.0000

open System

let baseTimeSpan = TimeSpan(1, 12, 15, 16)

// Create an array of timespan intervals.
let intervals =
    [| TimeSpan.FromDays 1.5 
       TimeSpan.FromHours 1.5 
       TimeSpan.FromMinutes 45 
       TimeSpan.FromMilliseconds 505
       TimeSpan(1, 17, 32, 20)
       TimeSpan(-8, 30, 0) |]

// Calculate a new time interval by adding each element to the base interval.
for interval in intervals do
    printfn $"""{baseTimeSpan,-10:g} - {if interval < TimeSpan.Zero then "-" else ""}{interval.ToString "%d\:hh\:mm\:ss\.ffff",15} = {if baseTimeSpan < interval.Duration() then "-" else ""}{baseTimeSpan.Subtract(interval).ToString"%d\:hh\:mm\:ss\.ffff"}"""

// The example displays the following output:
//       1:12:15:16 - 1:12:00:00.0000 = 0:00:15:16.0000
//       1:12:15:16 - 0:01:30:00.0000 = 1:10:45:16.0000
//       1:12:15:16 - 0:00:45:00.0000 = 1:11:30:16.0000
//       1:12:15:16 - 0:00:00:00.5050 = 1:12:15:15.4950
//       1:12:15:16 - 1:17:32:20.0000 = -0:05:17:04.0000
//       1:12:15:16 - -0:07:30:00.0000 = 1:19:45:16.0000

Opmerkingen

De retourwaarde moet tussen TimeSpan.MinValue en TimeSpan.MaxValue; anders wordt er een uitzondering gegenereerd.

De retourwaarde is een nieuw TimeSpan; het origineel TimeSpan wordt niet gewijzigd.

Van toepassing op

Zie ook