TimeSpan.Subtract(TimeSpan) Metode

Definisi

Ruang nama:

System

Rakitan:

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);

public TimeSpan Subtract (TimeSpan ts);

member this.Subtract : TimeSpan -> TimeSpan

Public Function Subtract (ts As TimeSpan) As TimeSpan

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

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

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.

Lihat juga

• Subtract(DateTime)