Aracılığıyla paylaş

DateTimeOffset.Add(TimeSpan) 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
Kaynak:
DateTimeOffset.cs
Kaynak:
DateTimeOffset.cs
Kaynak:
DateTimeOffset.cs

Bu örneğin değerine belirtilen zaman aralığını ekleyen yeni DateTimeOffset bir nesne döndürür.

public:
 DateTimeOffset Add(TimeSpan timeSpan);
public DateTimeOffset Add (TimeSpan timeSpan);
member this.Add : TimeSpan -> DateTimeOffset
Public Function Add (timeSpan As TimeSpan) As DateTimeOffset

Parametreler

timeSpan
TimeSpan

Pozitif TimeSpan veya negatif bir zaman aralığını temsil eden nesne.

Döndürülenler

DateTimeOffset

Değeri geçerli DateTimeOffset nesneyle temsil edilen tarih ve saatin toplamı ile temsil edilen timeSpanzaman aralığının toplamı olan bir nesne.

Ö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 örnek, hedefler arasındaki uçuş sürelerini temsil eden bir nesne dizisi TimeSpan oluşturur. Yöntemi Add daha sonra bu saatleri bir DateTimeOffset uçuşun ilk kalkış saatini temsil eden bir nesneye ekler. Sonuç, her bir hedefe zamanlanmış varış saatini yansıtır.

DateTimeOffset takeOff = new DateTimeOffset(2007, 6, 1, 7, 55, 0,
                             new TimeSpan(-5, 0, 0));
DateTimeOffset currentTime = takeOff;
TimeSpan[] flightTimes = new TimeSpan[]
                  {new TimeSpan(2, 25, 0), new TimeSpan(1, 48, 0)};
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.",
                  takeOff);
for (int ctr = flightTimes.GetLowerBound(0);
     ctr <= flightTimes.GetUpperBound(0); ctr++)
{
   currentTime = currentTime.Add(flightTimes[ctr]);
   Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime);
}

let takeOff = DateTimeOffset(2007, 6, 1, 7, 55, 0, TimeSpan(-5, 0, 0))
let mutable currentTime = takeOff
let flightTimes = [| TimeSpan(2, 25, 0); TimeSpan(1, 48, 0) |]
printfn $"Takeoff is scheduled for {takeOff:d} at {takeOff:T}."
                
for i = 0 to flightTimes.Length - 1 do
    currentTime <- currentTime.Add flightTimes[i]
    printfn $"Destination #{i + 1} at {currentTime}."

Dim takeOff As New DateTimeOffset(#6/1/2007 7:55AM#, _
                                  New TimeSpan(-5, 0, 0))
Dim currentTime As DateTimeOffset = takeOff
Dim flightTimes() As TimeSpan = New TimeSpan() _
                  {New TimeSpan(2, 25, 0), New TimeSpan(1, 48, 0)}
Console.WriteLine("Takeoff is scheduled for {0:d} at {0:T}.", _
                  takeOff)
For ctr As Integer = flightTimes.GetLowerBound(0) To _
                     flightTimes.GetUpperBound(0)
   currentTime = currentTime.Add(flightTimes(ctr))
   Console.WriteLine("Destination #{0} at {1}.", ctr + 1, currentTime)
Next

Açıklamalar

Yöntemini kullanarak Add tek bir işlemde birden fazla zaman aralığı (gün, saat, dakika, saniye veya milisaniye) ekleyebilirsiniz. Bu yöntemin davranışı toplama işleciyle aynıdır. Yapı ayrıca DateTimeOffset her zaman aralığı için özelleştirilmiş toplama yöntemlerini (, ve AddMinutesgibiAddDaysAddHours) destekler.

Not

Bu yöntem yeni DateTimeOffset bir nesne döndürür. Geçerli nesnenin değerini tarih ve saatine ekleyerek timeSpan değiştirmez.

Add yöntemi geçerli DateTimeOffset nesnenin Offset özelliğinin değerini etkilemez.

Bir nesne belirli bir DateTimeOffset saat dilimindeki tarih ve saati temsil etmediğinden, Add yöntem tarih ve saat aritmetiği gerçekleştirirken belirli bir saat diliminin ayarlama kurallarını dikkate almaz.

timeSpan parametresi isenull, bu yöntem özgün DateTimeOffset nesnenin değerini değişmeden döndürür.

Şunlara uygulanır

Ayrıca bkz.