DateTime.Subtract Metode

  • Referensi

Definisi

Ruang nama:
System
Rakitan:
System.Runtime.dll
Rakitan:
mscorlib.dll
Rakitan:
netstandard.dll

Mengembalikan nilai yang dihasilkan dari mengurangi waktu atau durasi yang ditentukan dari nilai instans ini.

Overload

Subtract(TimeSpan)

Mengembalikan baru DateTime yang mengurangi durasi yang ditentukan dari nilai instans ini.
Subtract(DateTime)

Mengembalikan baru TimeSpan yang mengurangi tanggal dan waktu yang ditentukan dari nilai instans ini.

Subtract(TimeSpan)

Sumber:
DateTime.cs
Sumber:
DateTime.cs
Sumber:
DateTime.cs

Mengembalikan baru DateTime yang mengurangi durasi yang ditentukan dari nilai instans ini.

public:
 DateTime Subtract(TimeSpan value);
public DateTime Subtract (TimeSpan value);
member this.Subtract : TimeSpan -> DateTime
Public Function Subtract (value As TimeSpan) As DateTime

Parameter

value
TimeSpan

Interval waktu untuk mengurangi.

Mengembalikan

DateTime

Objek yang sama dengan tanggal dan waktu yang diwakili oleh instans ini dikurangi interval waktu yang diwakili oleh value.

Pengecualian

ArgumentOutOfRangeException

Hasilnya kurang dari DateTime.MinValue atau lebih besar dari DateTime.MaxValue.

Contoh

Contoh berikut menunjukkan Subtract metode dan operator pengurangan.

System::DateTime date1 = System::DateTime( 1996, 6, 3, 22, 15, 0 );
System::DateTime date2 = System::DateTime( 1996, 12, 6, 13, 2, 0 );
System::DateTime date3 = System::DateTime( 1996, 10, 12, 8, 42, 0 );

// diff1 gets 185 days, 14 hours, and 47 minutes.
System::TimeSpan diff1 = date2.Subtract( date1 );

// date4 gets 4/9/1996 5:55:00 PM.
System::DateTime date4 = date3.Subtract( diff1 );

// diff2 gets 55 days 4 hours and 20 minutes.
System::TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System::DateTime date5 = date1 - diff2;

open System

let date1 = DateTime(1996, 6, 3, 22, 15, 0)
let date2 = DateTime(1996, 12, 6, 13, 2, 0)
let date3 = DateTime(1996, 10, 12, 8, 42, 0)

// diff1 gets 185 days, 14 hours, and 47 minutes.
let diff1 = date2.Subtract date1

// date4 gets 4/9/1996 5:55:00 PM.
let date4 = date3.Subtract diff1

// diff2 gets 55 days 4 hours and 20 minutes.
let diff2 = date2 - date3

// date5 gets 4/9/1996 5:55:00 PM.
let date5 = date1 - diff2

System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15, 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2, 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42, 0);

// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);

// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);

// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1 - diff2;

Dim date1 As New System.DateTime(1996, 6, 3, 22, 15, 0)
Dim date2 As New System.DateTime(1996, 12, 6, 13, 2, 0)
Dim date3 As New System.DateTime(1996, 10, 12, 8, 42, 0)

Dim diff1 As System.TimeSpan
' diff1 gets 185 days, 14 hours, and 47 minutes.
diff1 = date2.Subtract(date1)

Dim date4 As System.DateTime
' date4 gets 4/9/1996 5:55:00 PM.
date4 = date3.Subtract(diff1)

Dim diff2 As System.TimeSpan
' diff2 gets 55 days 4 hours and 20 minutes.
diff2 = System.DateTime.op_Subtraction(date2, date3)

Dim date5 As System.DateTime
' date5 gets 4/9/1996 5:55:00 PM.
date5 = System.DateTime.op_Subtraction(date1, diff2)

Keterangan

Metode mengembalikan Subtract(TimeSpan) tanggal yang merupakan perbedaan interval waktu tertentu dari instans saat ini. Untuk menentukan interval waktu antara dua tanggal, panggil Subtract(DateTime) metode . Untuk mengurangi interval waktu tertentu dari instans saat ini, panggil metode yang menambahkan interval waktu tersebut ke tanggal saat ini, dan berikan nilai negatif sebagai argumen metode. Misalnya, untuk mengurangi dua bulan dari tanggal saat ini, panggil AddMonths(Int32) metode dengan nilai -2.

Metode ini tidak mengubah nilai ini DateTime. Sebaliknya, ia mengembalikan yang baru DateTime yang nilainya adalah hasil dari operasi ini.

Biasanya, metode mengurangi DateTime.Subtract(TimeSpan)TimeSpan objek yang mewakili rentang waktu positif dan mengembalikan DateTime nilai yang lebih awal dari tanggal dan waktu instans saat ini. Namun, jika TimeSpan objek mewakili rentang waktu negatif, DateTime.Subtract(TimeSpan) metode mengembalikan nilai yang lebih lambat dari tanggal dan waktu instans DateTime saat ini.

Metode ini DateTime.Subtract(TimeSpan) memungkinkan Anda mengurangi interval waktu yang terdiri dari lebih dari satu unit waktu (seperti jumlah jam tertentu dan jumlah menit tertentu). Untuk mengurangi satu unit waktu (seperti tahun, bulan, atau hari) dari DateTime instans, Anda dapat meneruskan nilai numerik negatif sebagai parameter ke salah satu metode berikut:

  • AddYears, untuk mengurangi jumlah tahun tertentu dari instans tanggal dan waktu saat ini.

  • AddMonths, untuk mengurangi jumlah bulan tertentu dari instans tanggal dan waktu saat ini.

  • AddDays, untuk mengurangi jumlah hari tertentu dari instans tanggal dan waktu saat ini.

  • AddHours, untuk mengurangi jumlah jam tertentu dari instans tanggal dan waktu saat ini.

  • AddMinutes, untuk mengurangi jumlah menit tertentu dari instans tanggal dan waktu saat ini.

  • AddSeconds, untuk mengurangi jumlah detik tertentu dari instans tanggal dan waktu saat ini.

  • AddMilliseconds, untuk mengurangi jumlah milidetik tertentu dari instans tanggal dan waktu saat ini.

  • AddTicks, untuk mengurangi jumlah tick tertentu dari instans tanggal dan waktu saat ini.

Lihat juga

Berlaku untuk

Subtract(DateTime)

Sumber:
DateTime.cs
Sumber:
DateTime.cs
Sumber:
DateTime.cs

Mengembalikan baru TimeSpan yang mengurangi tanggal dan waktu yang ditentukan dari nilai instans ini.

public:
 TimeSpan Subtract(DateTime value);
public TimeSpan Subtract (DateTime value);
member this.Subtract : DateTime -> TimeSpan
Public Function Subtract (value As DateTime) As TimeSpan

Parameter

value
DateTime

Nilai tanggal dan waktu yang akan dikurangi.

Mengembalikan

TimeSpan

Interval waktu yang sama dengan tanggal dan waktu yang diwakili oleh instans ini dikurangi tanggal dan waktu yang diwakili oleh value.

Pengecualian

ArgumentOutOfRangeException

Hasilnya kurang dari DateTime.MinValue atau lebih besar dari DateTime.MaxValue.

Contoh

Contoh berikut menunjukkan Subtract metode dan operator pengurangan.

System::DateTime date1 = System::DateTime( 1996, 6, 3, 22, 15, 0 );
System::DateTime date2 = System::DateTime( 1996, 12, 6, 13, 2, 0 );
System::DateTime date3 = System::DateTime( 1996, 10, 12, 8, 42, 0 );

// diff1 gets 185 days, 14 hours, and 47 minutes.
System::TimeSpan diff1 = date2.Subtract( date1 );

// date4 gets 4/9/1996 5:55:00 PM.
System::DateTime date4 = date3.Subtract( diff1 );

// diff2 gets 55 days 4 hours and 20 minutes.
System::TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System::DateTime date5 = date1 - diff2;

open System

let date1 = DateTime(1996, 6, 3, 22, 15, 0)
let date2 = DateTime(1996, 12, 6, 13, 2, 0)
let date3 = DateTime(1996, 10, 12, 8, 42, 0)

// diff1 gets 185 days, 14 hours, and 47 minutes.
let diff1 = date2.Subtract date1

// date4 gets 4/9/1996 5:55:00 PM.
let date4 = date3.Subtract diff1

// diff2 gets 55 days 4 hours and 20 minutes.
let diff2 = date2 - date3

// date5 gets 4/9/1996 5:55:00 PM.
let date5 = date1 - diff2

System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15, 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2, 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42, 0);

// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);

// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);

// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1 - diff2;

Dim date1 As New System.DateTime(1996, 6, 3, 22, 15, 0)
Dim date2 As New System.DateTime(1996, 12, 6, 13, 2, 0)
Dim date3 As New System.DateTime(1996, 10, 12, 8, 42, 0)

Dim diff1 As System.TimeSpan
' diff1 gets 185 days, 14 hours, and 47 minutes.
diff1 = date2.Subtract(date1)

Dim date4 As System.DateTime
' date4 gets 4/9/1996 5:55:00 PM.
date4 = date3.Subtract(diff1)

Dim diff2 As System.TimeSpan
' diff2 gets 55 days 4 hours and 20 minutes.
diff2 = System.DateTime.op_Subtraction(date2, date3)

Dim date5 As System.DateTime
' date5 gets 4/9/1996 5:55:00 PM.
date5 = System.DateTime.op_Subtraction(date1, diff2)

Keterangan

Metode Subtract(DateTime) menentukan perbedaan antara dua tanggal. Untuk mengurangi interval waktu dari instans saat ini, panggil Subtract(TimeSpan) metode . Untuk mengurangi interval waktu tertentu dari instans saat ini, panggil metode yang menambahkan interval waktu tersebut ke tanggal saat ini, dan berikan nilai negatif sebagai argumen metode. Misalnya, untuk mengurangi dua bulan dari tanggal saat ini, panggil AddMonths(Int32) metode dengan nilai -2.

Jika tanggal dan waktu instans saat ini lebih awal dari value, metode mengembalikan TimeSpan objek yang mewakili rentang waktu negatif. Artinya, nilai semua properti bukan nolnya (seperti Days atau Ticks) negatif.

Metode Subtract(DateTime) ini tidak mempertimbangkan nilai Kind properti dari dua DateTime nilai saat melakukan pengurangan. Sebelum mengurangi DateTime objek, pastikan objek mewakili waktu dalam zona waktu yang sama. Jika tidak, hasilnya akan mencakup perbedaan antara zona waktu.

Catatan

Metode ini DateTimeOffset.Subtract(DateTimeOffset) memang mempertimbangkan perbedaan antara zona waktu saat melakukan pengurangan.

Lihat juga

Berlaku untuk