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.

异常

示例

下面的示例使用 AddMilliseconds 方法将1毫秒和1.5 毫秒添加到 @no__t 1 值。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. 该示例可以清楚地表明1毫秒等于10000刻度。The example makes it clear that one millisecond equals 10,000 ticks. 还显示了在执行加法运算之前舍入的小数部分;向原始日期添加1.5 毫秒后得出的 @no__t 值为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)      

注解

此方法不会更改此 @no__t 的值。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.

@No__t 的小数部分是毫秒的小数部分。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.

@No__t 的参数舍入为最接近的整数。The value parameter is rounded to the nearest integer.

适用于

另请参阅