DateTimeOffset.Add(TimeSpan) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> DateTimeOffsetPublic Function Add (timeSpan As TimeSpan) As DateTimeOffsetParametry
Zwraca
Obiekt, którego wartość jest sumą daty i godziny reprezentowanej przez bieżący DateTimeOffset obiekt i interwał czasu reprezentowany przez timeSpanelement .
Wyjątki
Wynikowa DateTimeOffset wartość jest mniejsza niż DateTimeOffset.MinValue.
— lub —
Wynikowa DateTimeOffset 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 startu lotu. Wynik odzwierciedla zaplanowany czas przylotu w każdym miejscu docelowym.
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
Można użyć Add metody , aby 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 / Notatka
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 ma nullwartość , ta metoda zwraca wartość oryginalnego DateTimeOffset obiektu bez zmian.
