DateTime.Subtract Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.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

Name	Description
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

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ılası zaman aralığı.

Döndürülenler

DateTime

Bu örnekle temsil edilen tarih ve saate eşit bir nesne ile temsil edilen valuezaman aralığı eksi.

Ö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 .

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 belirli bir 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ğerine sahip 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 sonraki bir DateTime değer döndürür.

yöntemi, DateTime.Subtract(TimeSpan) birden fazla zaman biriminden (belirli bir saat sayısı ve belirli bir 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 sayıda yılı çı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 işaretini çıkarmak için.

Ayrıca bkz.

• TimeSpan
• Tarih ve Saatlerle Aritmetik İşlemler Gerçekleştirme

Subtract(DateTime)

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ığı, ile temsil edilen tarih ve saat çıkarılarak 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 .

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ğerine sahip yöntemini çağırın AddMonths(Int32) .

Geçerli örneğin tarih ve saati değerinden valueönceyse, yöntemi negatif bir zaman aralığını temsil eden bir TimeSpan nesne döndürür. Yani, 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 gösterdiğinden emin olun. Aksi takdirde, sonuç saat dilimleri arasındaki farkı içerir.

Uyarı

DateTimeOffset.Subtract(DateTimeOffset) yöntemi, çıkarma işlemini gerçekleştirirken saat dilimleri arasındaki farkı dikkate alır.

Ayrıca bkz.

• Tarih ve Saatlerle Aritmetik İşlemler Gerçekleştirme