TimeSpan.Subtract(TimeSpan) Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Сборка:

netstandard.dll

Сборка:

mscorlib.dll

Возвращает новый объект 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

Возвращаемое значение меньше MinValue или больше 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

Комментарии

Возвращаемое значение должно находиться в диапазоне от TimeSpan.MinValue до TimeSpan.MaxValue ; в противном случае создается исключение.

Возвращаемое значение является новым TimeSpan ; оригинал TimeSpan не изменяется.

См. также раздел

• Subtract(DateTime)