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

Определение

Возвращает новый объект DateTime, добавляющий заданное число миллисекунд к значению данного экземпляра.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

Параметры

value
Double Double Double Double

Число полных и неполных миллисекунд.A number of whole and fractional milliseconds. Параметр value может быть положительным или отрицательным.The value parameter can be negative or positive. Заметьте, что это значение округляется до ближайшего целого числа.Note that this value is rounded to the nearest integer.

Возвраты

Объект, значение которого равно сумме даты и времени, представленных текущим экземпляром, и количества миллисекунд, представленного параметром 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.

Исключения

Итоговое значение DateTime меньше MinValue или больше MaxValue.The resulting DateTime is less than MinValue or greater than MaxValue.

Примеры

В следующем примере AddMilliseconds метод используется для добавления в DateTime значение одной миллисекунды и 1,5 миллисекунд.The following example uses the AddMilliseconds method to add one millisecond and 1.5 milliseconds to a DateTime value. Затем он отображает каждое новое значение и отображает разницу между ним и исходным значением.It then displays each new value and displays the difference between it and the original value. Разница отображается как в виде интервала времени, так и в виде числа тактов.The difference is displayed both as a time span and as a number of ticks. В примере становится ясно, что одна миллисекунда равна 10 000 тактов.The example makes it clear that one millisecond equals 10,000 ticks. Он также показывает, что доли миллисекунд округляются перед выполнением сложения. DateTime значение, полученное в результате добавления 1,5 миллисекунд к исходной дате, равно 2 миллисекундам, превышающим исходную дату.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)      

Комментарии

Этот метод не изменяет значение этого DateTimeпараметра.This method does not change the value of this DateTime. Вместо этого он возвращает новый DateTime , значение которого является результатом этой операции.Instead, it returns a new DateTime whose value is the result of this operation.

Дробная часть value представляет собой дробную часть миллисекунды.The fractional part of value is the fractional part of a millisecond. Например, 4,5 является эквивалентом 4 миллисекунд и 5000 тактов, где одна миллисекунда = 10000 тактов.For example, 4.5 is equivalent to 4 milliseconds and 5000 ticks, where one millisecond = 10000 ticks.

value Параметр округляется до ближайшего целого числа.The value parameter is rounded to the nearest integer.

Применяется к

Дополнительно