TimeSpan.Subtract(TimeSpan) 方法

定義

命名空間:

System

組件:

System.Runtime.dll

來源:

TimeSpan.cs

傳回新的 TimeSpan 物件，它的值為指定之 TimeSpan 物件與這個執行個體的差。

public:
 TimeSpan Subtract(TimeSpan ts);

public TimeSpan Subtract (TimeSpan ts);

member this.Subtract : TimeSpan -> TimeSpan

Public Function Subtract (ts As TimeSpan) As TimeSpan

參數

ts

TimeSpan

要減去的時間間隔。

傳回

TimeSpan

新的時間間隔，其值是這個執行個體的值減去 ts 的值之結果。

例外狀況

OverflowException

傳回值小於 TimeSpan.MinValue 或大於 TimeSpan.MaxValue。

範例

下列範例會 Subtract 使用 方法來計算單 TimeSpan 一值與陣列中每個時間間隔之間的差異。 請注意，因為 TimeSpan 格式字串不包含結果字串中的負號，所以此範例會使用條件式邏輯來包含負號與負時間間隔。

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

備註

傳回值必須在 和 TimeSpan.MaxValue 之間 TimeSpan.MinValue ，否則會擲回例外狀況。

傳回值是新的 TimeSpan ，原始 TimeSpan 值則不會修改。

另請參閱

• Subtract(DateTime)