DateTime.AddDays(Double) Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

DateTime.cs

Gibt einen neuen DateTime Wert zurück, der die angegebene Anzahl von Tagen zum Wert dieser Instanz hinzufügt.

public:
 DateTime AddDays(double value);

public DateTime AddDays(double value);

member this.AddDays : double -> DateTime

Public Function AddDays (value As Double) As DateTime

Parameter

value

Double

Eine Anzahl von ganzen und Bruchtagen. Der value Parameter kann negativ oder positiv sein.

Gibt zurück

DateTime

Ein Objekt, dessen Wert die Summe des Datums und der Uhrzeit darstellt, die durch diese Instanz dargestellt wird, und die Anzahl der Tage, die durch valuedargestellt werden.

Ausnahmen

ArgumentOutOfRangeException

Das Ergebnis DateTime ist kleiner als DateTime.MinValue oder größer als DateTime.MaxValue.

Beispiele

Im folgenden Beispiel wird die AddDays Methode verwendet, um den Tag der Woche 36 Tage nach dem aktuellen Datum zu bestimmen.

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

Hinweise

Diese Methode ändert den Wert dieser DateTimeMethode nicht. Stattdessen wird ein neuer DateTime Wert zurückgegeben, dessen Wert das Ergebnis dieses Vorgangs ist.

Der Bruchteil ist value der Bruchteil eines Tages. Beispielsweise entspricht 4,5 4 Tagen, 12 Stunden, 0 Minuten, 0 Sekunden, 0 Millisekunden und 0 Ticks.

In .NET Framework wird der value Parameter auf die nächste Millisekunden gerundet. In .NET 7 und höheren Versionen wird die volle Double Genauigkeit des value Parameters verwendet. Aufgrund der inhärenten Ungenauigkeit von Gleitkommagleichungen variiert die resultierende Genauigkeit jedoch.

Die AddDays Methode berücksichtigt Schaltjahre und die Anzahl der Tage in einem Monat beim Ausführen von Datumsarithmetik.

Weitere Informationen

• Double