DateTime.Add(TimeSpan) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: System.Runtime.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Źródło:: DateTime.cs

Źródło:: DateTime.cs

Źródło:: DateTime.cs

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 DateTime element, który dodaje wartość określonego TimeSpan do wartości tego wystąpienia.

public:
 DateTime Add(TimeSpan value);

public DateTime Add (TimeSpan value);

member this.Add : TimeSpan -> DateTime

Public Function Add (value As TimeSpan) As DateTime

Parametry

value: TimeSpan

Dodatni lub ujemny interwał czasu.

Zwraca

DateTime

Obiekt, którego wartość jest sumą daty i godziny reprezentowanej przez to wystąpienie i interwał czasu reprezentowany przez .value

Wyjątki

ArgumentOutOfRangeException

DateTime Wynik jest mniejszy niż DateTime.MinValue lub większy niż DateTime.MaxValue.

Przykłady

W poniższym przykładzie pokazano metodę Add . Oblicza dzień tygodnia, który wynosi 36 dni (864 godziny) od tej chwili.

// Calculate what day of the week is 36 days from this instant.
System::DateTime today = System::DateTime::Now;
System::TimeSpan duration( 36, 0, 0, 0 );
System::DateTime answer = today.Add( duration );
System::Console::WriteLine( " {0:dddd}", answer );

// Calculate what day of the week is 36 days from this instant.
let today = DateTime.Now
let duration = TimeSpan(36, 0, 0, 0)
let answer = today.Add duration
printfn $"{answer:dddd}"

// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);

' Calculate what day of the week is 36 days from this instant.
Dim today As System.DateTime
Dim duration As System.TimeSpan
Dim answer As System.DateTime

today = System.DateTime.Now
duration = New System.TimeSpan(36, 0, 0, 0)
answer = today.Add(duration)

System.Console.WriteLine("{0:dddd}", answer)

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 zachowaniem operatora dodawania. Struktura DateTime obsługuje również wyspecjalizowane metody dodawania (takie jak AddDays, AddHoursi AddMinutes) dla każdego interwału czasu.

Metoda Add uwzględnia lata przestępne i liczbę dni w miesiącu podczas wykonywania arytmetyki daty.

Ta metoda nie zmienia wartości tego DateTimeelementu . Zamiast tego zwraca nowy DateTime , którego wartość jest wynikiem tej operacji. Właściwość Kind nowego DateTime wystąpienia jest taka sama jak właściwość bieżącego wystąpienia.

Dotyczy