DateTimeOffset.Add(TimeSpan) Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

DateTimeOffset.cs

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

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ý aktuálním DateTimeOffset objektem a časovým intervalem reprezentovaným 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í časy letu mezi cíli. Metoda Add pak tyto časy přidá do DateTimeOffset objektu, který představuje počáteční čas vzletu letu. Výsledek odráží naplánovaný čas příletu v každém cíli.

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

Metodu Add můžete použít k přidání více než jednoho druhu časového intervalu (dny, hodiny, minuty, sekundy nebo milisekundy) v jedné operaci. 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. Neupravuje hodnotu aktuálního objektu přidáním timeSpan k datu a času.

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

Vzhledem k tomu, že DateTimeOffset objekt nepředstavuje datum a čas v určitém časovém pásmu, Add metoda nebere v úvahu pravidla úpravy konkrétního časového pásma, když provádí aritmetické datum a čas.

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

Viz také

• Addition(DateTimeOffset, TimeSpan)
• Provádění aritmetických operací s daty a časy