C＃中的DateTime.AddHours()方法

此方法用于返回一个新的DateTime，它将指定的小时数添加到此实例的值中。

句法：

public DateTime AddHours (double value);

在这里，该值是整小时数和小数小时数。值参数可以为负或正。

返回值：该方法返回一个对象，该对象的值是此实例表示的日期和时间与value表示的小时数之和。

异常：如果生成的DateTime小于MinValue或大于MaxValue，则此方法将提供ArgumentOutOfRangeException 。

下面的程序说明了DateTime.AddDays(Double)方法的用法：

范例1：

// C# program to demonstrate the
// DateTime.AddHours(Double) Method
using System;
using System.Globalization;
  
class GFG {
  
    // Main Method
    public static void Main()
    {
        try {
  
            // creating object of DateTime
            DateTime date1 = new DateTime(2010, 1,
                                     1, 4, 0, 15);
  
            // adding the 5.50 hours
            // using AddHours() method;
            DateTime date2 = date1.AddHours(5.50);
  
            // Display the date1
            Console.WriteLine("DateTime before operation:"+
                            " {0:y} {0:dd}, {0:t}", date1);
  
            // Display the date2
            Console.WriteLine("\nDateTime after operation: "+
                               "{0:y} {0:dd}, {0:t}", date2);
        }
  
        catch (ArgumentOutOfRangeException e)
        {
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

输出：

DateTime before operation: 2010 January 01, 04:00

DateTime after operation: 2010 January 01, 09:30

示例2：对于ArgumentOutOfRangeException

// C# program to demonstrate the
// DateTime.AddHours(Double) Method
using System;
using System.Globalization;
  
class GFG {
  
    // Main Method
    public static void Main()
    {
        try {
  
            // creating object of DateTime 
            // and initialize with MinValue
            DateTime date1 = DateTime.MaxValue;
  
            // Display the date1
            Console.WriteLine("DateTime before operation: "+
                              "{0:y} {0:dd}, {0:t}", date1);
  
            // adding the TimeSpan of 5 days
            // using AddHours() method;
            DateTime date2 = date1.AddHours(5);
  
            // Display the date2
            System.Console.WriteLine("\nDateTime after operation:"+
                                    " {0:y} {0:dd}, {0:t}", date2);
        }
  
        catch (ArgumentOutOfRangeException e) 
        {
            Console.WriteLine("\nThe resulting DateTime is "+
                      "greater than the DateTime.MaxValue ");
  
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

输出：

DateTime before operation: 9999 December 31, 23:59

The resulting DateTime is greater than the DateTime.MaxValue 
Exception Thrown: System.ArgumentOutOfRangeException

笔记：

• 此方法不会更改此DateTime的值。而是返回一个新的DateTime，其值是此操作的结果。
• 值的小数部分是一分钟的小数部分。例如，7.5等于7分钟，30秒，0毫秒和0个滴答。
• value参数将四舍五入到最接近的毫秒数。

参考：

• https://docs.microsoft.com/zh-cn/dotnet/api/system.datetime.addhours?view=netframework-4.7.2