DateTime.AddMilliseconds(Double) Metoda

Definicja

Zwraca nowy DateTime, który dodaje określoną liczbę milisekund do wartości tego wystąpienia.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

Parametry

value
Double

Liczba całych i częściowych milisekund.A number of whole and fractional milliseconds. Parametr value może być ujemny lub dodatni.The value parameter can be negative or positive. Należy zauważyć, że ta wartość jest zaokrąglana do najbliższej liczby całkowitej.Note that this value is rounded to the nearest integer.

Zwraca

Obiekt, którego wartość jest sumą daty i godziny reprezentowanej przez to wystąpienie oraz liczbę milisekund reprezentowanych przez 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.

Wyjątki

DateTime wyników jest mniejsza niż MinValue lub większa niż MaxValue.The resulting DateTime is less than MinValue or greater than MaxValue.

Przykłady

W poniższym przykładzie zastosowano metodę AddMilliseconds, aby dodać jeden milisekund i 1,5 milisekund do wartości DateTime.The following example uses the AddMilliseconds method to add one millisecond and 1.5 milliseconds to a DateTime value. Następnie zostanie wyświetlona każda nowa wartość i zostanie wyświetlona różnica między nim a wartością oryginalną.It then displays each new value and displays the difference between it and the original value. Różnica jest wyświetlana zarówno jako przedział czasu, jak i liczba taktów.The difference is displayed both as a time span and as a number of ticks. W przykładzie jest jasne, że jedna milisekunda jest równa 10 000 taktów.The example makes it clear that one millisecond equals 10,000 ticks. Pokazuje również, że ułamki milisekundy są zaokrąglane przed wykonaniem dodawania; wartość DateTime, która wynika z dodania 1,5 milisekund do oryginalnej daty, jest równa 2 milisekundy niż oryginalna data.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)      

Uwagi

Ta metoda nie zmienia wartości tego DateTime.This method does not change the value of this DateTime. Zamiast tego zwraca nowy DateTime którego wartość jest wynikiem tej operacji.Instead, it returns a new DateTime whose value is the result of this operation.

Część ułamkowa value jest częścią ułamkową milisekund.The fractional part of value is the fractional part of a millisecond. Na przykład 4,5 jest równoważne 4 milisekund i 5000 taktów, gdzie jedna milisekunda = 10000 Takty.For example, 4.5 is equivalent to 4 milliseconds and 5000 ticks, where one millisecond = 10000 ticks.

Parametr value jest zaokrąglany do najbliższej liczby całkowitej.The value parameter is rounded to the nearest integer.

Dotyczy

Zobacz też