信息
您所需的主题如下所示。但此主题未包含在此库中。

DateTime.AddMilliseconds 方法

2013/12/13

返回一个新的 DateTime,它将指定的毫秒数加到此实例的值上。

Namespace:  System
程序集:  mscorlib(位于 mscorlib.dll 中)

public DateTime AddMilliseconds(
	double value
)

参数

value
类型: System.Double
要添加的由整数和小数部分组成的毫秒数。此值可正可负,并舍入到最接近的整数。

返回值

类型: System.DateTime
一个对象,其值是此实例所表示的日期和时间与 value 所表示的毫秒数之和。

此方法不更改此 DateTime 的值。而是返回一个新的 DateTime,其值是此运算的结果。

value 的小数部分是以毫秒为单位时的小数部分。例如,4.5 等效于 4 毫秒 5000 计时周期(其中 1 毫秒 = 10000 计时周期)。

value 参数被舍入到最近的整数。

下面的示例使用 AddMilliseconds 方法将 1 毫秒和 1.5 毫秒与 DateTime 值相加。然后该示例显示每个新值并显示新值与原始值之间的差异。差异以时间跨度和计时周期数这两种形式显示。该示例清晰地表明 1 毫秒等于 10,000 个计时周期。它还显示小数部分的毫秒在执行加法之前被舍入;通过将 1.5 毫秒与原始日期相加得到的 DateTime 值晚于原始日期 2 毫秒。


string dateFormat = "MM/dd/yyyy hh:mm:ss.fffffff"; 
DateTime date1 = new DateTime(2010, 9, 8, 16, 0, 0);
outputBlock.Text += String.Format("Original date: {0} ({1:N0} ticks)\n",
                  date1.ToString(dateFormat), date1.Ticks) + Environment.NewLine;

DateTime date2 = date1.AddMilliseconds(1);
outputBlock.Text += String.Format("Second date:   {0} ({1:N0} ticks)",
                  date2.ToString(dateFormat), date2.Ticks) + Environment.NewLine;
outputBlock.Text += String.Format("Difference between dates: {0} ({1:N0} ticks)\n",
                  date2 - date1, date2.Ticks - date1.Ticks) + Environment.NewLine;                        

DateTime date3 = date1.AddMilliseconds(1.5);
outputBlock.Text += String.Format("Third date:    {0} ({1:N0} ticks)",
                  date3.ToString(dateFormat), date3.Ticks) + Environment.NewLine;
outputBlock.Text += String.Format("Difference between dates: {0} ({1:N0} ticks)",
                  date3 - date1, date3.Ticks - date1.Ticks) + Environment.NewLine;                        
// 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)      


Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

显示: