DateTime.Subtract Yöntem

  • Başvuru

Tanım

Ad Alanı:
System
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Belirtilen süreyi veya süreyi bu örneğin değerinden çıkarmanın sonucunu veren değeri döndürür.

Aşırı Yüklemeler

Subtract(TimeSpan)

Belirtilen süreyi bu örneğin değerinden çıkaran yeni DateTime bir döndürür.
Subtract(DateTime)

Belirtilen tarih ve saati bu örneğin değerinden çıkaran yeni TimeSpan bir döndürür.

Subtract(TimeSpan)

Kaynak:
DateTime.cs
Kaynak:
DateTime.cs
Kaynak:
DateTime.cs

Belirtilen süreyi bu örneğin değerinden çıkaran yeni DateTime bir döndürür.

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

Parametreler

value
TimeSpan

Çıkarılacak zaman aralığı.

Döndürülenler

DateTime

Bu örnek tarafından temsil edilen tarih ve saate eşit bir nesne ile gösterilen zaman aralığı çıkarılır value.

Özel durumlar

ArgumentOutOfRangeException

Sonuç DateTime.MinValue değerinden küçük veya DateTime.MaxValue değerinden büyük.

Örnekler

Aşağıdaki örnekte yöntemi ve çıkarma işleci gösterilmektedir Subtract .

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)

Açıklamalar

yöntemi, Subtract(TimeSpan) geçerli örnekten belirtilen zaman aralığı farkı olan tarihi döndürür. İki tarih arasındaki zaman aralığını belirlemek için yöntemini çağırın Subtract(DateTime) . Geçerli örnekten belirli bir zaman aralığını çıkarmak için, bu zaman aralığını geçerli tarihe ekleyen yöntemini çağırın ve yöntem bağımsız değişkeni olarak negatif bir değer sağlayın. Örneğin, geçerli tarihten iki ay çıkarmak için -2 değeriyle yöntemini çağırın AddMonths(Int32) .

Bu yöntem bu DateTimedeğerini değiştirmez. Bunun yerine, değeri bu işlemin sonucu olan yeni DateTime bir döndürür.

Normalde yöntemi, DateTime.Subtract(TimeSpan) pozitif bir zaman aralığını temsil eden bir TimeSpan nesneyi çıkarır ve geçerli örneğin tarih ve saatinden daha eski bir DateTime değer döndürür. Ancak, nesne negatif bir zaman aralığını temsil ederse TimeSpan , DateTime.Subtract(TimeSpan) yöntem geçerli örneğin tarih ve saatinden daha sonra bir DateTime değer döndürür.

yöntemi, DateTime.Subtract(TimeSpan) birden fazla zaman biriminden (verilen saat sayısı ve verilen dakika sayısı gibi) oluşan bir zaman aralığını çıkarmanıza olanak tanır. Örnekten tek bir zaman birimini (yıl, ay veya gün gibi) çıkarmak için, aşağıdaki yöntemlerden DateTime herhangi birine parametre olarak negatif bir sayısal değer geçirebilirsiniz:

  • AddYears, geçerli tarih ve saat örneğinden belirli bir yıl sayısını çıkarmak için.

  • AddMonths, geçerli tarih ve saat örneğinden belirli sayıda ay çıkarmak için.

  • AddDays, geçerli tarih ve saat örneğinden belirli sayıda günü çıkarmak için.

  • AddHours, geçerli tarih ve saat örneğinden belirli bir saat sayısını çıkarmak için.

  • AddMinutes, geçerli tarih ve saat örneğinden belirli bir dakika sayısını çıkarmak için.

  • AddSeconds, geçerli tarih ve saat örneğinden belirli bir saniye sayısını çıkarmak için.

  • AddMilliseconds, geçerli tarih ve saat örneğinden belirli sayıda milisaniye çıkarmak için.

  • AddTicks, geçerli tarih ve saat örneğinden belirli sayıda değer çizgisi çıkarmak için.

Ayrıca bkz.

Şunlara uygulanır

Subtract(DateTime)

Kaynak:
DateTime.cs
Kaynak:
DateTime.cs
Kaynak:
DateTime.cs

Belirtilen tarih ve saati bu örneğin değerinden çıkaran yeni TimeSpan bir döndürür.

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

Parametreler

value
DateTime

Çıkaracak tarih ve saat değeri.

Döndürülenler

TimeSpan

Bu örnekle temsil edilen tarih ve saate eşit bir zaman aralığı eksi ile valuegösterilen tarih ve saat.

Özel durumlar

ArgumentOutOfRangeException

Sonuç DateTime.MinValue değerinden küçük veya DateTime.MaxValue değerinden büyük.

Örnekler

Aşağıdaki örnekte yöntemi ve çıkarma işleci gösterilmektedir Subtract .

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)

Açıklamalar

yöntemi iki Subtract(DateTime) tarih arasındaki farkı belirler. Geçerli örnekten bir zaman aralığını çıkarmak için yöntemini çağırın Subtract(TimeSpan) . Geçerli örnekten belirli bir zaman aralığını çıkarmak için, bu zaman aralığını geçerli tarihe ekleyen yöntemini çağırın ve yöntem bağımsız değişkeni olarak negatif bir değer sağlayın. Örneğin, geçerli tarihten iki ay çıkarmak için -2 değeriyle yöntemini çağırın AddMonths(Int32) .

Geçerli örneğin tarih ve saati değerinden valueönceyse, yöntem negatif bir zaman aralığını temsil eden bir TimeSpan nesne döndürür. Başka bir ifadeyle, sıfır olmayan tüm özelliklerinin (veya TicksgibiDays) değeri negatiftir.

Subtract(DateTime) yöntemi, çıkarma işlemi gerçekleştirirken iki DateTime değerin özelliğinin değerini Kind dikkate almaz. Nesneleri çıkarmadan DateTime önce, nesnelerin aynı saat dilimindeki saatleri temsil etmelerini sağlayın. Aksi takdirde, sonuç saat dilimleri arasındaki farkı içerir.

Not

DateTimeOffset.Subtract(DateTimeOffset) yöntemi, çıkarma işlemi yapılırken saat dilimleri arasındaki farkı dikkate alır.

Ayrıca bkz.

Şunlara uygulanır