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

Definición

Devuelve un nuevo objeto DateTime que suma el número especificado de milisegundos al valor de esta instancia.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

Parámetros

value
Double Double Double Double

Número de milisegundos enteros y fraccionarios.A number of whole and fractional milliseconds. El parámetro value puede ser positivo o negativo.The value parameter can be negative or positive. Observe que este valor se redondea al entero más próximo.Note that this value is rounded to the nearest integer.

Devoluciones

Un objeto cuyo valor es la suma de la fecha y hora representadas por esta instancia y el número de milisegundos representados por 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.

Excepciones

Ejemplos

En el ejemplo siguiente se usa el AddMilliseconds método para agregar un milisegundo y 1,5 milisegundos para un DateTime valor.The following example uses the AddMilliseconds method to add one millisecond and 1.5 milliseconds to a DateTime value. A continuación, se muestra cada nuevo valor y se muestra la diferencia entre este y el valor original.It then displays each new value and displays the difference between it and the original value. La diferencia se muestra como un intervalo de tiempo y como un número de pasos.The difference is displayed both as a time span and as a number of ticks. El ejemplo deja claro que un milisegundo es igual a 10 000 tics.The example makes it clear that one millisecond equals 10,000 ticks. También muestra que se redondean fracciones de milisegundos antes de realizar la adición; el DateTime valor que es el resultado de sumar 1,5 milisegundos a la fecha original es mayores que la fecha original de 2 milisegundos.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)      

Comentarios

Este método no cambia el valor de este DateTime.This method does not change the value of this DateTime. En su lugar, devuelve un nuevo DateTime cuyo valor es el resultado de esta operación.Instead, it returns a new DateTime whose value is the result of this operation.

La parte fraccionaria de value es la parte fraccionaria de un milisegundo.The fractional part of value is the fractional part of a millisecond. Por ejemplo, 4,5 equivale a 4 milisegundos y 5000 tics, donde un milisegundo = 10000 pasos.For example, 4.5 is equivalent to 4 milliseconds and 5000 ticks, where one millisecond = 10000 ticks.

El value parámetro se redondea al entero más próximo.The value parameter is rounded to the nearest integer.

Se aplica a

Consulte también: