DateTime.AddDays(Double) Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

DateTime.cs

Vrátí novou DateTime hodnotu, která k hodnotě této instance přičte zadaný počet dní.

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

Počet celých a desetinných dnů. Parametr value může být záporný nebo kladný.

Návraty

DateTime

Objekt, jehož hodnota je součet data a času reprezentované touto instancí a počtem dnů reprezentovaných value.

Výjimky

ArgumentOutOfRangeException

Výsledek DateTime je menší než DateTime.MinValue nebo větší než DateTime.MaxValue.

Příklady

Následující příklad používá metodu AddDays k určení dne v týdnu 36 dní po aktuálním datu.

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

Poznámky

Tato metoda nemění hodnotu tohoto DateTime. Místo toho vrátí novou DateTime hodnotu, jejíž hodnota je výsledkem této operace.

Zlomková část value je zlomkovou částí dne. Například 4,5 odpovídá 4 dnům, 12 hodinám, 0 minutám, 0 sekundám, 0 milisekundám a 0 tisekundám.

V rozhraní .NET Framework value se parametr zaokrouhlí na nejbližší milisekundu. V .NET 7 a novějších verzích se používá úplná Double přesnost parametru value . Vzhledem k nepřesnosti matematiky s plovoucí desetinnou čárkou se ale výsledná přesnost bude lišit.

Metoda AddDays bere v úvahu přestupné roky a počet dní v měsíci při provádění aritmetiky kalendářního data.

Viz také

• Double