DateTime.AddDays(Double) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestawy:: mscorlib.dll, System.Runtime.dll

Zestawy:: netstandard.dll, System.Runtime.dll

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 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.

Dotyczy

Produkt	Wersje
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Zobacz też

Double

Udostępnij za pośrednictwem