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

Definition

Gibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl von Millisekunden zum Wert dieser Instanz addiert.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

Parameter

value
Double Double Double Double

Eine Zahl, die aus ganzen Millisekunden und dem Bruchteil einer Millisekunde besteht.A number of whole and fractional milliseconds. Der value-Parameter kann negativ oder positiv sein.The value parameter can be negative or positive. Beachten Sie, dass dieser Wert auf die nächste Ganzzahl gerundet wird.Note that this value is rounded to the nearest integer.

Gibt zurück

Ein Objekt, dessen Wert die Summe aus der von dieser Instanz dargestellten Datums- und Uhrzeitangabe und der durch value dargestellten Anzahl von Millisekunden ist.An object whose value is the sum of the date and time represented by this instance and the number of milliseconds represented by value.

Ausnahmen

Der resultierende DateTime-Wert ist kleiner als MinValue oder größer als MaxValue.The resulting DateTime is less than MinValue or greater than MaxValue.

Beispiele

Im folgenden Beispiel wird die AddMilliseconds -Methode verwendet, um einen Millisekundenwert und 1,5 DateTime Millisekunden einem Wert hinzuzufügen.The following example uses the AddMilliseconds method to add one millisecond and 1.5 milliseconds to a DateTime value. Anschließend werden alle neuen Werte angezeigt, und der Unterschied zwischen dem Wert und dem ursprünglichen Wert wird angezeigt.It then displays each new value and displays the difference between it and the original value. Der Unterschied wird sowohl als Zeitspanne als auch als Anzahl von Ticks angezeigt.The difference is displayed both as a time span and as a number of ticks. Im Beispiel wird klar, dass eine Millisekunde 10.000 Ticks beträgt.The example makes it clear that one millisecond equals 10,000 ticks. Außerdem wird gezeigt, dass Sekundenbruchteile gerundet werden, bevor die Addition durchgeführt wird. der DateTime Wert, der sich aus dem Hinzufügen von 1,5 Millisekunden zum ursprünglichen Datum ergibt, beträgt 2 Millisekunden, die größer sind als das ursprüngliche Datum.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)      

Hinweise

Diese Methode ändert nicht den Wert dieses DateTime.This method does not change the value of this DateTime. Stattdessen wird ein neuer DateTime zurückgegeben, dessen Wert das Ergebnis dieses Vorgangs ist.Instead, it returns a new DateTime whose value is the result of this operation.

Der Bruchteile von value ist der Bruchteil einer Millisekunde.The fractional part of value is the fractional part of a millisecond. 4,5 entspricht z. b. 4 Millisekunden und 5000 Ticks, wobei eine Millisekunde = 10000 Ticks.For example, 4.5 is equivalent to 4 milliseconds and 5000 ticks, where one millisecond = 10000 ticks.

Der value -Parameter wird auf die nächste ganze Zahl gerundet.The value parameter is rounded to the nearest integer.

Gilt für:

Siehe auch