DateTime.AddDays(Double) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce un nuovo DateTime oggetto che aggiunge il numero di giorni specificato 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 value parametro può essere negativo o positivo.
Valori restituiti
Oggetto il cui valore è la somma della data e dell'ora rappresentate da questa istanza e il numero di giorni rappresentati da value.
Eccezioni
Il risultato DateTime è minore di DateTime.MinValue o maggiore di DateTime.MaxValue.
Esempio
Nell'esempio seguente viene utilizzato il AddDays metodo per determinare il giorno della settimana 36 giorni dopo la data corrente.
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 .DateTime Restituisce invece un nuovo DateTime il cui valore è il risultato di questa operazione.
La parte frazionaria di value è la parte frazionaria di un giorno. Ad esempio, 4,5 equivale a 4 giorni, 12 ore, 0 minuti, 0 secondi, 0 millisecondi e 0 tick.
In .NET Framework 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'imprecisione intrinseca della matematica a virgola mobile, la precisione risultante varia.
Il AddDays metodo tiene conto degli anni intercalari e del numero di giorni in un mese durante l'esecuzione dell'aritmetica della data.