DateTime.AddDays(Double) Metoda

Definicja

Zwraca nowy DateTime, który dodaje określoną liczbę dni do wartości tego wystąpienia.Returns a new DateTime that adds the specified number of days to the value of this instance.

public:
 DateTime AddDays(double value);
public DateTime AddDays (double value);
member this.AddDays : double -> DateTime
Public Function AddDays (value As Double) As DateTime

Parametry

value
Double

Liczba całych i częściowych dni.A number of whole and fractional days. Parametr value może być ujemny lub dodatni.The value parameter can be negative or positive.

Zwraca

Obiekt, którego wartość jest sumą daty i godziny reprezentowanej przez to wystąpienie oraz liczbę dni reprezentowanych przez value.An object whose value is the sum of the date and time represented by this instance and the number of days represented by value.

Wyjątki

DateTime wyników jest mniejsza niż MinValue lub większa niż MaxValue.The resulting DateTime is less than MinValue or greater than MaxValue.

Przykłady

W poniższym przykładzie zastosowano metodę AddDays, aby określić dzień tygodnia 36 dni po dacie bieżącej.The following example uses the AddDays method to determine the day of the week 36 days after the current date.

using namespace System;

int main()
{
   // Calculate what day of the week is 36 days from this instant.
   DateTime today = System::DateTime::Now;
   DateTime answer = today.AddDays( 36 );
   Console::WriteLine("Today: {0:dddd}", today);
   Console::WriteLine("36 days from today: {0:dddd}", answer);
}
// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday
using System;

class Class1
{
    static void Main()
    {
        DateTime today = DateTime.Now;
        DateTime answer = today.AddDays(36);
        Console.WriteLine("Today: {0:dddd}", today);
        Console.WriteLine("36 days from today: {0:dddd}", answer);
    }
}
// The example displays output like the following:
//       Today: Wednesday
//       36 days from today: Thursday
Class Class1
   Public Shared Sub Main()
      Dim today As System.DateTime
      Dim answer As System.DateTime

      today = System.DateTime.Now
      answer = today.AddDays(36)

      Console.WriteLine("Today: {0:dddd}", today)
      Console.WriteLine("36 days from today: {0:dddd}", answer)
   End Sub
End Class
' The example displays output like the following:
'       Today: Wednesday
'       36 days from today: Thursday

Uwagi

Ta metoda nie zmienia wartości tego DateTime.This method does not change the value of this DateTime. Zamiast tego zwraca nowy DateTime którego wartość jest wynikiem tej operacji.Instead, it returns a new DateTime whose value is the result of this operation.

Część ułamkowa value jest częścią ułamkową dnia.The fractional part of value is the fractional part of a day. Na przykład 4,5 jest odpowiednikiem 4 dni, 12 godzin, 0 minut, 0 sekund, 0 MS i 0 taktów.For example, 4.5 is equivalent to 4 days, 12 hours, 0 minutes, 0 seconds, 0 milliseconds, and 0 ticks.

Parametr value jest zaokrąglany do najbliższej milisekundy.The value parameter is rounded to the nearest millisecond.

Metoda AddDays uwzględnia lata przestępne oraz liczbę dni w miesiącu podczas wykonywania operacji arytmetycznych.The AddDays method takes into account leap years and the number of days in a month when performing date arithmetic.

Dotyczy

Zobacz też