DateTime.AddMilliseconds(Double) Metodo

Definizione

Spazio dei nomi:

System

Assembly:

netstandard.dll, System.Runtime.dll

Origine:

DateTime.cs

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

C#

public DateTime AddMilliseconds(double value);

Parametri

value

Double

Numero di millisecondi interi e frazionari. Il parametro value può essere negativo o positivo. Il valore viene arrotondato all'intero più vicino.

Restituisce

DateTime

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

Eccezioni

ArgumentOutOfRangeException

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

Esempio

Nell'esempio seguente viene usato il AddMilliseconds metodo per aggiungere un millisecondo e 1,5 millisecondi a un DateTime valore. Visualizza quindi ogni nuovo valore e visualizza la differenza tra di essa e il valore originale. La differenza viene visualizzata sia come intervallo di tempo che come numero di tick. L'esempio rende chiaro che un millisecondo equivale a 10.000 tick. Mostra anche che i millisecondi frazionari vengono arrotondati prima di eseguire l'aggiunta; il DateTime valore risultante dall'aggiunta di 1,5 millisecondi alla data originale è di 2 millisecondi maggiore della data originale.

C#

string dateFormat = "MM/dd/yyyy hh:mm:ss.fffffff";
DateTime date1 = new DateTime(2010, 9, 8, 16, 0, 0);
Console.WriteLine("Original date: {0} ({1:N0} ticks)\n",
                  date1.ToString(dateFormat), date1.Ticks);

DateTime date2 = date1.AddMilliseconds(1);
Console.WriteLine("Second date:   {0} ({1:N0} ticks)",
                  date2.ToString(dateFormat), date2.Ticks);
Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)\n",
                  date2 - date1, date2.Ticks - date1.Ticks);

DateTime date3 = date1.AddMilliseconds(1.5);
Console.WriteLine("Third date:    {0} ({1:N0} ticks)",
                  date3.ToString(dateFormat), date3.Ticks);
Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)",
                  date3 - date1, date3.Ticks - date1.Ticks);
// The example displays the following output:
//    Original date: 09/08/2010 04:00:00.0000000 (634,195,584,000,000,000 ticks)
//
//    Second date:   09/08/2010 04:00:00.0010000 (634,195,584,000,010,000 ticks)
//    Difference between dates: 00:00:00.0010000 (10,000 ticks)
//
//    Third date:    09/08/2010 04:00:00.0020000 (634,195,584,000,020,000 ticks)
//    Difference between dates: 00:00:00.0020000 (20,000 ticks)

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 è la parte frazionaria di value un millisecondo. Ad esempio, 4.5 equivale a 4 millisecondi e 5000 tick, dove un millisecondo = 10000 ticks.

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.

Si applica a

Vedi anche

• Double
• Esecuzione di operazioni aritmetiche con date e ore