DateTime.AddDays(Double) Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Origine:

DateTime.cs

Restituisce un nuovo oggetto DateTime che aggiunge il numero specificato di giorni al valore di questa istanza.

public:
 DateTime AddDays(double value);

public DateTime AddDays (double value);

member this.AddDays : double -> DateTime

Public Function AddDays (value As Double) As DateTime

Parametri

value

Double

Numero di giorni interi e frazionari. Il parametro value può essere negativo o positivo.

Restituisce

DateTime

Oggetto il cui valore è la somma della data e dell'ora rappresentate dall'istanza e del numero di giorni rappresentato da value.

Eccezioni

ArgumentOutOfRangeException

Il risultato DateTime è minore di DateTime.MinValue o maggiore di DateTime.MaxValue.

Esempio

Nell'esempio seguente viene usato il AddDays metodo per determinare il giorno della settimana 36 giorni dopo la data corrente.

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

Commenti

Questo metodo non modifica il valore di questo DateTimeoggetto . Restituisce invece un nuovo DateTime valore il cui valore è il risultato di questa operazione.

La parte frazionaria di value è la parte frazionaria di un giorno. Ad esempio, 4,5 è equivalente a 4 giorni, 12 ore, 0 minuti, 0 secondi, 0 millisecondi e 0 tick.

Nelle versioni precedenti e .NET 6 il value parametro viene arrotondato al millisecondo più vicino. In .NET 7 e versioni successive viene usata la precisione completa Double del value parametro. Tuttavia, a causa dell'accuratezza intrinseca della matematica a virgola mobile, la precisione risultante varia.

Il AddDays metodo tiene conto degli anni salti e del numero di giorni in un mese quando si esegue l'aritmetica della data.

Vedi anche

• Double