DateTime.AddDays(Double) Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Źródło:

DateTime.cs

Zwraca nową, DateTime która dodaje określoną liczbę dni do wartości tego wystąpienia.

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 dni całkowitych i ułamkowych. Parametr value może być ujemny lub dodatni.

Zwraca

DateTime

Obiekt, którego wartość jest sumą daty i godziny reprezentowanej przez to wystąpienie i liczbę dni reprezentowanych 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 użyto AddDays metody , aby określić dzień tygodnia 36 dni po bieżącej dacie.

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

open System

let today = DateTime.Now
let answer = today.AddDays 36
printfn $"Today: {today:dddd}"
printfn $"36 days from today: {answer:dddd}"


// 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 DateTimeelementu . Zamiast tego zwraca nowy DateTime , którego wartość jest wynikiem tej operacji.

Część value ułamkowa to część ułamkowa dnia. Na przykład 4,5 jest odpowiednikiem 4 dni, 12 godzin, 0 minut, 0 sekund, 0 milisekund i 0 kleszczy.

W programie .NET 6 i starszych wersjach value parametr jest zaokrąglany do najbliższej milisekundy. W programach .NET 7 i nowszych używana jest pełna Double precyzja parametru value . Jednak ze względu na nieprecyzjność matematycznej zmiennoprzecinkowa precyzja będzie się różnić.

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

Zobacz też

• Double