TimeSpan.Subtract(TimeSpan) Metode

Definisi

Ruang nama:

System

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

TimeSpan.cs

Mengembalikan objek baru TimeSpan yang nilainya adalah perbedaan antara objek yang ditentukan TimeSpan dan instans ini.

public TimeSpan Subtract(TimeSpan ts);

Parameter

ts

TimeSpan

Interval waktu yang akan dikurangi.

Mengembalikan

TimeSpan

Interval waktu baru yang nilainya adalah hasil dari nilai instans ini dikurangi nilai ts.

Pengecualian

OverflowException

Nilai yang dikembalikan kurang dari TimeSpan.MinValue atau lebih besar dari TimeSpan.MaxValue.

Contoh

Contoh berikut menggunakan Subtract metode untuk menghitung perbedaan antara satu TimeSpan nilai dan setiap interval waktu dalam array. Perhatikan bahwa, karena TimeSpan string format tidak menyertakan tanda negatif dalam string hasil, contohnya menggunakan logika bersyarat untuk menyertakan tanda negatif dengan interval waktu negatif.

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

Keterangan

Nilai yang dikembalikan harus antara TimeSpan.MinValue dan TimeSpan.MaxValue; jika tidak, pengecualian dilemparkan.

Nilai yang dikembalikan adalah baru TimeSpan; aslinya TimeSpan tidak dimodifikasi.

Berlaku untuk

Lihat juga

• Subtract(DateTime)