TimeSpan.Subtract(TimeSpan) Metoda

Definicja

Przestrzeń nazw:

System

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

TimeSpan.cs

Zwraca nowy TimeSpan obiekt, którego wartość jest różnicą między określonym TimeSpan obiektem a tym wystąpieniem.

C#

public TimeSpan Subtract(TimeSpan ts);

Parametry

ts

TimeSpan

Interwał czasu do odjęciu.

Zwraca

TimeSpan

Nowy przedział czasu, którego wartość jest wynikiem wartości tego wystąpienia pomniejszonej o tswartość .

Wyjątki

OverflowException

Wartość zwracana jest mniejsza niż TimeSpan.MinValue lub większa niż TimeSpan.MaxValue.

Przykłady

W poniższym przykładzie użyto Subtract metody do obliczenia różnicy między pojedynczą TimeSpan wartością a każdym z interwałów czasu w tablicy. Należy pamiętać, że ponieważ TimeSpan ciągi formatu nie zawierają ujemnych znaków w ciągu wynikowym, w przykładzie użyto logiki warunkowej do uwzględnienia znaku ujemnego z ujemnymi interwałami czasu.

C#

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

Uwagi

Wartość zwracana musi zawierać się między TimeSpan.MinValue i TimeSpan.MaxValue; w przeciwnym razie zgłaszany jest wyjątek.

Wartość zwracana jest nową TimeSpanwartością ; oryginalna TimeSpan wartość nie jest modyfikowana.

Dotyczy

Zobacz też

• Subtract(DateTime)