DateTimeOffset.Subtract Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

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

Aşırı Yüklemeler

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

Örnekler

Aşağıdaki örnekte yöntemini kullanan çıkarma 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 birbirinden 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 etkiyi kaldırır.

Uyarı

Ö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 tarih ve saatleri çıkardığında belirli bir saat dilimi 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ılası zaman aralığı.

Döndürülenler

DateTimeOffset

Geçerli DateTimeOffset nesne tarafından temsil edilen tarih ve saate eşit bir nesne, ile temsil edilen 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 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

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

Uyarı

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