DateTime.AddMilliseconds(Double) DateTime.AddMilliseconds(Double) DateTime.AddMilliseconds(Double) DateTime.AddMilliseconds(Double) Method

Definizione

Restituisce un nuovo oggetto DateTime che aggiunge il numero specificato di millisecondi al valore di questa istanza.Returns a new DateTime that adds the specified number of milliseconds to the value of this instance.

public:
 DateTime AddMilliseconds(double value);
public DateTime AddMilliseconds (double value);
member this.AddMilliseconds : double -> DateTime
Public Function AddMilliseconds (value As Double) As DateTime

Parametri

value
Double Double Double Double

Numero di millisecondi interi e frazionari.A number of whole and fractional milliseconds. Il parametro value può essere negativo o positivo.The value parameter can be negative or positive. Il valore viene arrotondato all'intero più vicino.Note that this value is rounded to the nearest integer.

Restituisce

Oggetto il cui valore è la somma della data e dell'ora rappresentate dall'istanza e del numero di millisecondi rappresentato da value.An object whose value is the sum of the date and time represented by this instance and the number of milliseconds represented by value.

Eccezioni

Il valore risultante di DateTime è minore di MinValue o maggiore di MaxValue.The resulting DateTime is less than MinValue or greater than MaxValue.

Esempi

Nell'esempio seguente viene usato AddMilliseconds il metodo per aggiungere un millisecondo e 1,5 millisecondi DateTime a un valore.The following example uses the AddMilliseconds method to add one millisecond and 1.5 milliseconds to a DateTime value. Viene quindi visualizzato ogni nuovo valore e viene visualizzata la differenza tra l'oggetto e il valore originale.It then displays each new value and displays the difference between it and the original value. La differenza viene visualizzata sia come intervallo di tempo che come numero di cicli.The difference is displayed both as a time span and as a number of ticks. L'esempio rende chiaro che un millisecondo equivale a 10.000 di cicli.The example makes it clear that one millisecond equals 10,000 ticks. Indica inoltre 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.It also shows that fractional milliseconds are rounded before performing the addition; the DateTime value that results from adding 1.5 milliseconds to the original date is 2 milliseconds greater than the original date.

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)      
Dim dateFormat As String = "MM/dd/yyyy hh:mm:ss.fffffff" 
Dim date1 As Date = #09/08/2010 16:00#
Console.WriteLine("Original date: {0} ({1:N0} ticks)", _
                  date1.ToString(dateFormat), date1.Ticks)
Console.WriteLine()

Dim date2 As Date = 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)", _
                  date2 - date1, date2.Ticks - date1.Ticks)                        
Console.WriteLine()

Dim date3 As Date = 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.This method does not change the value of this DateTime. Viene invece restituito un nuovo DateTime oggetto il cui valore è il risultato di questa operazione.Instead, it returns a new DateTime whose value is the result of this operation.

La parte frazionaria di value è la parte frazionaria di un millisecondo.The fractional part of value is the fractional part of a millisecond. 4,5, ad esempio, equivale a 4 millisecondi e 5000 di cicli, dove un millisecondo = 10000 cicli.For example, 4.5 is equivalent to 4 milliseconds and 5000 ticks, where one millisecond = 10000 ticks.

Il value parametro viene arrotondato all'intero più vicino.The value parameter is rounded to the nearest integer.

Si applica a

Vedi anche