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

Définition

Retourne un nouveau DateTime qui ajoute le nombre de millisecondes spécifié à la valeur de cette instance.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

Paramètres

value
Double Double Double Double

Nombre de millisecondes entières et partielles.A number of whole and fractional milliseconds. Le paramètre value peut être négatif ou positif.The value parameter can be negative or positive. Notez que cette valeur est arrondie à l'entier le plus proche.Note that this value is rounded to the nearest integer.

Retours

Objet dont la valeur est égale à la somme de la date et de l'heure représentées par cette instance et du nombre de millisecondes représenté par 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.

Exceptions

L’objet DateTime obtenu est inférieur à MinValue ou supérieur à MaxValue.The resulting DateTime is less than MinValue or greater than MaxValue.

Exemples

L’exemple suivant utilise la méthode AddMilliseconds pour ajouter une milliseconde et 1,5 millisecondes à une valeur de DateTime.The following example uses the AddMilliseconds method to add one millisecond and 1.5 milliseconds to a DateTime value. Il affiche ensuite chaque nouvelle valeur et affiche la différence entre elle et la valeur d’origine.It then displays each new value and displays the difference between it and the original value. La différence s’affiche à la fois comme un intervalle de temps et comme un nombre de graduations.The difference is displayed both as a time span and as a number of ticks. L’exemple montre clairement qu’une milliseconde est égale à 10 000 graduations.The example makes it clear that one millisecond equals 10,000 ticks. Il montre également que les millisecondes fractionnaires sont arrondies avant de procéder à l’ajout. la valeur DateTime qui résulte de l’ajout de 1,5 millisecondes à la date d’origine est de 2 millisecondes supérieure à la date d’origine.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)      

Remarques

Cette méthode ne modifie pas la valeur de ce DateTime.This method does not change the value of this DateTime. Au lieu de cela, elle retourne un nouvel DateTime dont la valeur est le résultat de cette opération.Instead, it returns a new DateTime whose value is the result of this operation.

La partie fractionnaire de value est la partie fractionnaire d’une milliseconde.The fractional part of value is the fractional part of a millisecond. Par exemple, 4,5 équivaut à 4 millisecondes et 5000 graduations, où 1 milliseconde = 10000 cycles.For example, 4.5 is equivalent to 4 milliseconds and 5000 ticks, where one millisecond = 10000 ticks.

Le paramètre value est arrondi à l’entier le plus proche.The value parameter is rounded to the nearest integer.

S’applique à

Voir aussi