DateTimeOffset.Add(TimeSpan) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System
Zestaw:
System.Runtime.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll
Źródło:
DateTimeOffset.cs
Źródło:
DateTimeOffset.cs
Źródło:
DateTimeOffset.cs

Zwraca nowy DateTimeOffset obiekt, który dodaje określony interwał czasu do wartości tego wystąpienia.

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

TimeSpan Obiekt reprezentujący dodatni lub ujemny interwał czasu.

Zwraca

DateTimeOffset

Obiekt, którego wartość jest sumą daty i godziny reprezentowanej przez bieżący DateTimeOffset obiekt i interwał czasu reprezentowany przez obiekt timeSpan.

Wyjątki

ArgumentOutOfRangeException

DateTimeOffset Wynikowa wartość jest mniejsza niż DateTimeOffset.MinValue.

-lub-

DateTimeOffset Wynikowa wartość jest większa niż DateTimeOffset.MaxValue.

Przykłady

Poniższy przykład tworzy tablicę TimeSpan obiektów reprezentujących czas lotu między miejscami docelowymi. Następnie Add metoda dodaje te czasy do DateTimeOffset obiektu, który reprezentuje początkowy czas startowy lotu. Wynik odzwierciedla zaplanowany czas przybycia do każdego miejsca docelowego.

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

Uwagi

Za pomocą Add metody można dodać więcej niż jeden rodzaj interwału czasu (dni, godziny, minuty, sekundy lub milisekundy) w jednej operacji. Zachowanie tej metody jest identyczne z operatorem dodawania. Struktura DateTimeOffset obsługuje również wyspecjalizowane metody dodawania (takie jak AddDays, AddHoursi AddMinutes) dla każdego interwału czasu.

Uwaga

Ta metoda zwraca nowy DateTimeOffset obiekt. Nie modyfikuje wartości bieżącego obiektu przez dodanie timeSpan jej do daty i godziny.

Metoda Add nie ma wpływu na wartość właściwości bieżącego DateTimeOffset obiektu Offset .

DateTimeOffset Ponieważ obiekt nie reprezentuje daty i godziny w określonej strefie czasowej, Add metoda nie uwzględnia reguł korekty określonej strefy czasowej podczas wykonywania arytmetyki daty i godziny.

timeSpan Jeśli parametr to null, ta metoda zwraca wartość oryginalnego DateTimeOffset obiektu bez zmian.

Dotyczy

Zobacz też