Sdílet prostřednictvím

DateTimeOffset.Add(TimeSpan) Metoda

  • Reference

Definice

Obor názvů:
System
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
DateTimeOffset.cs
Zdroj:
DateTimeOffset.cs
Zdroj:
DateTimeOffset.cs

Vrátí nový DateTimeOffset objekt, který přidá zadaný časový interval k hodnotě této instance.

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

Parametry

timeSpan
TimeSpan

Objekt TimeSpan , který představuje kladný nebo záporný časový interval.

Návraty

DateTimeOffset

Objekt, jehož hodnota je součet data a času reprezentovaných aktuálním DateTimeOffset objektem a časový interval reprezentovaný hodnotou timeSpan.

Výjimky

ArgumentOutOfRangeException

Výsledná DateTimeOffset hodnota je menší než DateTimeOffset.MinValue.

-nebo-

Výsledná DateTimeOffset hodnota je větší než DateTimeOffset.MaxValue.

Příklady

Následující příklad vytvoří pole TimeSpan objektů, které představují dobu letu mezi cíli. Metoda Add pak tyto časy přidá do objektu DateTimeOffset , který představuje počáteční čas vzletu. Výsledek odráží naplánovaný čas příletu v každé destinaci.

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

Poznámky

Pomocí metody můžete Add v rámci jedné operace přidat více než jeden druh časového intervalu (dny, hodiny, minuty, sekundy nebo milisekundy). Chování této metody je stejné jako operátor sčítání. Struktura DateTimeOffset také podporuje specializované metody sčítání (například AddDays, AddHoursa AddMinutes) pro každý časový interval.

Poznámka

Tato metoda vrátí nový DateTimeOffset objekt. Nezmění hodnotu aktuálního objektu přidáním timeSpan k jeho datu a času.

Metoda Add nemá vliv na hodnotu vlastnosti aktuálního DateTimeOffset objektu Offset .

DateTimeOffset Vzhledem k tomu, že objekt nepředstavuje datum a čas v určitém časovém pásmu, Add metoda při provádění aritmetických aritmetických operací data a času nebere v úvahu pravidla úprav určitého časového pásma.

timeSpan Pokud je nullparametr , vrátí tato metoda hodnotu původního DateTimeOffset objektu beze změny.

Platí pro

Viz také