导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

DateTime.AddHours 方法

2013/12/13

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

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

public DateTime AddHours(
	double value
)

参数

value
类型: System.Double
要添加的由整数和小数部分组成的小时数。此值可以是正数也可以是负数。

返回值

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

此方法不更改此 DateTime 的值。而是返回一个新的 DateTime,其值是此运算的结果。返回的 DateTime 对象的 Kind 属性与原始 DateTime 对象的该属性相同。

value 的小数部分是以小时为单位时的小数部分。例如,4.5 等效于 4 小时 30 分钟 0 秒 0 毫秒 0 计时周期。

value 参数被舍入到最近的毫秒。

如果结果是无尽循环小数,将不足一小时的时间间隔转换为小数部分可能会发生精度损失。(例如,1 分钟等于 0.016667 小时。)如果这会产生问题,则可以使用 Add 方法,通过这种方法,可以在一个方法调用中指定多种时间间隔,不需要将时间间隔转换为小时的小数部分。

下面的示例使用 AddHours 方法将许多整数值和小数值与日期和时间相加。它还说明了向此方法传递包括小数部分的值所导致的精度损失。


using System;

public class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      double[] hours = {.08333, .16667, .25, .33333, .5, .66667, 1, 2, 
                        29, 30, 31, 90, 365};
      DateTime dateValue = new DateTime(2009, 3, 1, 12, 0, 0);

      foreach (double hour in hours)
         outputBlock.Text += String.Format("{0} + {1} hour(s) = {2}\n", dateValue, 
                                           hour, dateValue.AddHours(hour));
   }
}
// The example displays the following output on a system whose current
// culture is en-US:
//    3/1/2009 12:00:00 PM + 0.08333 hour(s) = 3/1/2009 12:04:59 PM
//    3/1/2009 12:00:00 PM + 0.16667 hour(s) = 3/1/2009 12:10:00 PM
//    3/1/2009 12:00:00 PM + 0.25 hour(s) = 3/1/2009 12:15:00 PM
//    3/1/2009 12:00:00 PM + 0.33333 hour(s) = 3/1/2009 12:19:59 PM
//    3/1/2009 12:00:00 PM + 0.5 hour(s) = 3/1/2009 12:30:00 PM
//    3/1/2009 12:00:00 PM + 0.66667 hour(s) = 3/1/2009 12:40:00 PM
//    3/1/2009 12:00:00 PM + 1 hour(s) = 3/1/2009 1:00:00 PM
//    3/1/2009 12:00:00 PM + 2 hour(s) = 3/1/2009 2:00:00 PM
//    3/1/2009 12:00:00 PM + 29 hour(s) = 3/2/2009 5:00:00 PM
//    3/1/2009 12:00:00 PM + 30 hour(s) = 3/2/2009 6:00:00 PM
//    3/1/2009 12:00:00 PM + 31 hour(s) = 3/2/2009 7:00:00 PM
//    3/1/2009 12:00:00 PM + 90 hour(s) = 3/5/2009 6:00:00 AM
//    3/1/2009 12:00:00 PM + 365 hour(s) = 3/16/2009 5:00:00 PM


Windows Phone OS

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

Windows Phone

显示:
© 2014 Microsoft