DateTime.AddHours(Double) 方法

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

DateTime.cs

傳回新的 DateTime，將這個執行個體的值加上指定的時數。

C#

public DateTime AddHours(double value);

參數

value

Double

整數和小數的時數。 value 參數可以是負數或正數。

傳回

DateTime

物件，其值為這個執行個體所表示日期和時間加上 value 所表示時數的總和。

例外狀況

ArgumentOutOfRangeException

產生的 DateTime 小於 DateTime.MinValue 或大於 DateTime.MaxValue。

範例

下列範例會 AddHours 使用 方法，將一些整數和小數值新增至日期和時間。 它也說明傳遞包含小數部分元件之值的方法所造成的精確度遺失。

C#

using System;

public class Example
{
   public static void Main()
   {
      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)
         Console.WriteLine("{0} + {1} hour(s) = {2}", 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

備註

這個方法不會變更這個 DateTime 的值。 相反地，它會傳回新的 DateTime ，其值為此作業的結果。 傳 KindDateTime 回物件的 屬性與 的 value 屬性相同。

的分數部分 value 是一小時的小數部分。 例如，4.5 相當於 4 小時、30 分鐘、0 秒、0 毫秒和 0 個刻度。

在 .NET 6 和舊版中 value ，參數會四捨五入至最接近的毫秒。 在 .NET 7 和更新版本中，會使用 參數的完整 Doublevalue 精確度。 不過，由於浮點數數學的固有不精確性，因此產生的精確度會有所不同。

如果結果為非終止重複的小數點，將小於一小時的時間間隔轉換為分數可能會造成精確度遺失。 (例如，一分鐘是一小時 0.016667。) 如果這有問題，您可以使用 Add 方法，這可讓您在單一方法呼叫中指定一種以上的時間間隔，並不需要將時間間隔轉換為小時的小數部分。

適用於

另請參閱

• Add(TimeSpan)
• 使用日期和時間執行算數運算