DateTimeOffset.Subtract Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Belirtilen süreyi veya süreyi geçerli DateTimeOffset nesneden çıkarır.

Aşırı Yüklemeler

Subtract(DateTimeOffset)	Geçerli DateTimeOffset nesneden belirli bir DateTimeOffset tarih ve saati temsil eden bir değeri çıkarır.
Subtract(TimeSpan)	Belirtilen zaman aralığını geçerli DateTimeOffset nesneden çıkarır.

Subtract(DateTimeOffset)

Kaynak:

DateTimeOffset.cs

Geçerli DateTimeOffset nesneden belirli bir DateTimeOffset tarih ve saati temsil eden bir değeri çıkarır.

public:
 TimeSpan Subtract(DateTimeOffset value);

public TimeSpan Subtract (DateTimeOffset value);

member this.Subtract : DateTimeOffset -> TimeSpan

Public Function Subtract (value As DateTimeOffset) As TimeSpan

Parametreler

value

DateTimeOffset

Çıkaracak değeri temsil eden bir nesne.

Döndürülenler

TimeSpan

İki DateTimeOffset nesne arasındaki aralığı belirten bir nesne.

Örnekler

Aşağıdaki örnekte yöntemini kullanan çıkarma işlemi gösterilmektedir Subtract(DateTimeOffset) .

DateTimeOffset firstDate = new DateTimeOffset(2018, 10, 25, 18, 0, 0,
                                              new TimeSpan(-7, 0, 0));
DateTimeOffset secondDate = new DateTimeOffset(2018, 10, 25, 18, 0, 0,
                                               new TimeSpan(-5, 0, 0));
DateTimeOffset thirdDate = new DateTimeOffset(2018, 9, 28, 9, 0, 0,
                                              new TimeSpan(-7, 0, 0));
TimeSpan difference;

difference = firstDate.Subtract(secondDate);
Console.WriteLine($"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}");

difference = firstDate.Subtract(thirdDate);
Console.WriteLine($"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}");

// The example produces the following output:
//    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
//    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

let firstDate = DateTimeOffset(2018, 10, 25, 18, 0, 0, TimeSpan(-7, 0, 0))
let secondDate = DateTimeOffset(2018, 10, 25, 18, 0, 0, TimeSpan(-5, 0, 0))
let thirdDate = DateTimeOffset(2018, 9, 28, 9, 0, 0, TimeSpan(-7, 0, 0))

let difference = firstDate.Subtract secondDate
printfn $"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}"

let difference = firstDate.Subtract thirdDate
printfn $"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}"

// The example produces the following output:
//    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
//    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

Dim firstDate As New DateTimeOffset(#10/25/2018 6:00PM#, _
                                    New TimeSpan(-7, 0, 0))
Dim secondDate As New DateTimeOffset(#10/25/2018 6:00PM#, _
                                     New TimeSpan(-5, 0, 0))
Dim thirdDate As New DateTimeOffset(#9/28/2018 9:00AM#, _
                                    New TimeSpan(-7, 0, 0))
Dim difference As TimeSpan

difference = firstDate.Subtract(secondDate)
Console.WriteLine($"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}")

difference = firstDate.Subtract(thirdDate)
Console.WriteLine($"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}")

' The example produces the following output:
'    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
'    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

Açıklamalar

Bu yöntem, her iki nesneyi de DateTimeOffset ayıran zaman aralığını hesaplamadan önce Eşgüdümlü Evrensel Saat'e (UTC) dönüştürür. Bu, UTC'den farklı uzaklıkların karşılaştırma üzerinde sahip olabileceği tüm etkileri kaldırır.

Not

Özel işleçleri destekleyen diller için çıkarma işlecini kullanarak tarih ve saat çıkarma işlemi de gerçekleştirebilirsiniz. Ayrıntılar için yöntemine Subtraction bakın.

Geçerli DateTimeOffset nesne veya value parametre belirli bir saat dilimindeki tarih ve saati temsil etmediğinden, Subtract(DateTimeOffset) yöntem tarihleri ve saatleri çıkarırken belirli bir saat diliminin ayarlama kurallarını dikkate almaz.

Ayrıca bkz.

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

Subtract(TimeSpan)

Kaynak:

DateTimeOffset.cs

Belirtilen zaman aralığını geçerli DateTimeOffset nesneden çıkarır.

public:
 DateTimeOffset Subtract(TimeSpan value);

public DateTimeOffset Subtract (TimeSpan value);

member this.Subtract : TimeSpan -> DateTimeOffset

Public Function Subtract (value As TimeSpan) As DateTimeOffset

Parametreler

value

TimeSpan

Çıkarılacak zaman aralığı.

Döndürülenler

DateTimeOffset

Geçerli DateTimeOffset nesne tarafından temsil edilen tarih ve saate eşit bir nesne, ile gösterilen zaman aralığı çıkarılarak value.

Özel durumlar

ArgumentOutOfRangeException

Sonuçta elde edilen DateTimeOffset değer DateTimeOffset.MinValue değerinden küçüktür.

-veya-

Sonuçta elde edilen DateTimeOffset değer DateTimeOffset.MaxValue değerinden büyüktür.

Örnekler

Aşağıdaki örnekte yöntemini kullanan çıkarma işlemi gösterilmektedir Subtract .

DateTimeOffset offsetDate = new DateTimeOffset(2007, 12, 3, 11, 30, 0,
                               new TimeSpan(-8, 0, 0));
TimeSpan duration = new TimeSpan(7, 18, 0, 0);
Console.WriteLine(offsetDate.Subtract(duration).ToString());  // Displays 11/25/2007 5:30:00 PM -08:00

let offsetDate = DateTimeOffset(2007, 12, 3, 11, 30, 0, TimeSpan(-8, 0, 0))
let duration = TimeSpan(7, 18, 0, 0)
printfn $"{offsetDate.Subtract duration}"  // Displays 11/25/2007 5:30:00 PM -08:00

Dim offsetDate As New DateTimeOffset(#12/3/2007 11:30AM#, _
                               New TimeSpan(-8, 0, 0)) 
Dim duration As New TimeSpan(7, 18, 0, 0)
Console.WriteLine(offsetDate.Subtract(duration))    ' Displays 11/25/2007 5:30:00 PM -08:00

Açıklamalar

Tek bir işlemde Subtract birden fazla zaman aralığı türünü (gün, saat, dakika, saniye veya milisaniye) çıkarmak için yöntemini kullanabilirsiniz. Davranışı, çıkarma işlecini Subtraction(DateTimeOffset, TimeSpan) tanımlayan yöntemiyle aynıdır. Yapı ayrıca DateTimeOffset yöntem AddHoursparametresine negatif bir değer atayarak çıkarma gerçekleştirmenize olanak sağlayan özel ekleme yöntemlerini (, ve AddMinutesgibiAddDays) destekler.

Not

Bu yöntem yeni DateTimeOffset bir nesne döndürür. Geçerli nesnenin değerini tarih ve saatinden çıkararak value değiştirmez.

Subtract yöntemi nesnenin Offset özelliğinin DateTimeOffset değerini etkilemez. Döndürülen DateTimeOffset nesne, özgün nesneyle aynı uzaklıktadır.

Geçerli DateTimeOffset nesne belirli bir saat dilimindeki tarih ve saati temsil etmediğinden, Subtract(TimeSpan) yöntem çıkarma işlemini gerçekleştirirken belirli bir saat diliminin ayarlama kurallarını dikkate almaz.

Ayrıca bkz.

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